ptgit 1.0.0__tar.gz

ptgit-1.0.0/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

ptgit-1.0.0/.gitignore

@@ -0,0 +1,181 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor  
+#  Cursor is an AI-powered code editor.`.cursorignore` specifies files/directories to 
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore

ptgit-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Char
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ptgit-1.0.0/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: ptgit
+Version: 1.0.0
+Summary: Pip Through Git is a way to install python packages through git.
+Project-URL: Homepage, https://github.com/CharGoldenYT/ptgit
+Project-URL: Issues, https://github.com/CharGoldenYT/ptgit/issues
+Author: CharGoldenYT
+License-Expression: GPL-3.0-or-later
+License-File: LICENSE
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.12
+Requires-Dist: gitpython
+Description-Content-Type: text/markdown
+
+# Python Packages through git repositories! | PTGit
+
+PTGit (Pip through Git) is an alternative pip install method that allows you to install python packages directly through a git repository
+
+
+## Adding better compatibility with this tool
+
+If you would like the tool to be able to run smoother with YOUR project, simply include a built package with the following structure in your project
+
+```
+Root
+|
+|   packaged
+|
+|___    pgit.tar.gz
+|
+|___    pgit_details.whl (optional)
+```
+
+## Useage
+
+`python -m ptgit packagename sourceURL`
+
+Installs `packagename` from `sourceURL`

ptgit-1.0.0/README.md

@@ -0,0 +1,24 @@
+# Python Packages through git repositories! | PTGit
+
+PTGit (Pip through Git) is an alternative pip install method that allows you to install python packages directly through a git repository
+
+
+## Adding better compatibility with this tool
+
+If you would like the tool to be able to run smoother with YOUR project, simply include a built package with the following structure in your project
+
+```
+Root
+|
+|   packaged
+|
+|___    pgit.tar.gz
+|
+|___    pgit_details.whl (optional)
+```
+
+## Useage
+
+`python -m ptgit packagename sourceURL`
+
+Installs `packagename` from `sourceURL`

ptgit-1.0.0/ptgit/__configReader__.py

@@ -0,0 +1,50 @@
+import os
+import json
+from typing import Any
+from pathlib import Path
+configuration = {"AllowPackagedFiles": False, "IgnoreWarning": False}
+
+def checkOS()->str:
+    if (os.getenv("HOME") is None):
+        return "WINDOWS"
+
+    return "UNIX"
+
+def readConfigFile()->configuration:
+    curOS = checkOS()
+    path = ""
+    if (curOS == "WINDOWS"):
+        path += os.getenv("APPDATA")
+    else:
+        path += os.getenv("HOME")
+    if (not Path(path + "/ptgit_config").exists()):
+        os.mkdir(path + "/ptgit_config")
+        writeConfigFile(configuration)
+    if (not Path(path + '/ptgit_config/config.json').exists()):
+        writeConfigFile(configuration)
+    file = open(path + "/ptgit_config/config.json", "r")
+    rawJson = file.read()
+    print(f"RawJson: {rawJson}")
+
+    return json.loads(rawJson)["config"]
+
+def writeConfigFile(config:configuration):
+    curOS = checkOS()
+    path = ""
+    if (curOS == "WINDOWS"):
+        path += os.getenv("APPDATA")
+    else:
+        path += os.getenv("HOME")
+    file = open(path + "/ptgit_config/config.json", "w")
+    file.write(json.dumps({"config": config}, indent="\t"))
+    file.close()
+
+
+def setConfig(name:str, newValue:Any):
+    config = readConfigFile()
+    value = config["name"]
+    if (value is None):
+        return
+
+    config[name] = newValue
+    writeConfigFile(config)

ptgit-1.0.0/ptgit/__init__.py

@@ -0,0 +1 @@
+# Nothin here!

ptgit-1.0.0/ptgit/__main__.py

@@ -0,0 +1,228 @@
+import sys
+import os
+from typing import Any
+from urllib.parse import urlparse as parse
+from .__configReader__ import readConfigFile, setConfig, checkOS
+from subprocess import run
+from pathlib import Path
+from git import Repo
+
+global packName
+global URL
+global branch
+global build
+global allowPrePackaged
+
+packName = ""
+URL = ""
+branch = ""
+build = False
+allowPrePackaged = False
+
+def processArg(arg:str, base:str = "") -> Any:
+    if (arg.lower() == "help"):
+        print("""PTGit (Pip Through Git)
+
+Useage:
+
+ptgit packagename packageURL <arguments> - Install a package from git.
+
+Arguments:
+--help:                             Displays this message
+--branch="branchName"               Determines which branch to install from
+--autoinstall="[<packagenames>]"    calls pip to install these packages if they are not included as a requirement in the package's repo
+--config                            starts the configuration script""")
+        exit(0)
+        
+
+    if (arg.lower().startswith("branch=")):
+        return arg.split("=")[1]
+        
+    
+    print(f"Not a valid argument {base}{arg}! Use --help for information!")
+
+def checkArgs():
+    arg_array = []
+    for item in args:
+        if (arg_array.__contains__(item) and ["--branch"].__contains__(item)):
+            print(f"You cannot call {item} twice!")
+            processArg("help")
+        arg_array.append(item)
+
+def runConfigScript():
+    configFile = readConfigFile()
+    validOptions = {"1": "AllowPackagedFiles"}
+    result = input("From the following options choose one to switch\n1: Allow Potentially Unsafe Pre-Packaged files from git repositories: " + str(configFile["AllowPackagedFiles"]))
+
+    if (result == "1"):
+        setConfig("AllowPackagedFiles", (not configFile["AllowPackagedFiles"]))
+
+    if (not validOptions.__contains__(result)):
+        print("Invalid Option!")
+        runConfigScript()
+
+    print("Configuration saved! " + validOptions[result] + " set to " + configFile[validOptions[result]])
+    exit(0)
+
+args = sys.argv
+if (args[0].endswith(".py") or args[0] == "ptgit"):
+    args.remove(args[0])
+
+if (args.__contains__("--config")):
+    runConfigScript()
+
+if (args.__len__() < 2):
+    print("Invalid number of arguments!")
+    processArg("help")
+
+config = readConfigFile()
+if (config["AllowPackagedFiles"]):
+    i = input("WARNING: unsafe switch \"AllowPackagedFiles\" is enabled!\nThis may make it easy for malicious actors to install fake packages that comprimise your system!\nAlways check official sources before installng from a git repo!\nPress ENTER to continue, type IGNORE to permanently remove this warning.")
+    if (i.upper() == "IGNORE"):
+        setConfig("IgnoreWarning", True)
+
+checkArgs()
+
+result = parse(args[0])
+
+if (all([result.scheme, result.netloc])):
+    print("Invalid arguments!")
+    processArg("help")
+else:
+    packName = args[0]
+
+result = parse(args[1])
+
+if (not all([result.scheme, result.netloc])):
+    print("Invalid arguments!")
+    processArg("help")
+else:
+    URL = args[1]
+
+for item in args:
+    if (item.startswith("--")):
+        result = processArg(item.removeprefix("--"), "--")
+        if (isinstance(result, str)):
+            branch = result
+        if (isinstance(result, bool)):
+            build = True
+        
+
+
+br = ""
+if (branch.__len__() > 0):
+    br = f" at branch {branch}"
+
+curOS = checkOS()
+
+path = ""
+
+if (curOS == "WINDOWS"):
+    path += os.getenv("LOCALAPPDATA")
+else:
+    path += os.getenv("HOME")
+
+def showProg(op_code, cur_count, max_count=None, message=''):
+    finalStr = ""
+
+    match op_code:
+        case 0:
+            finalStr += "[Beginning Clone]: "
+        case 1:
+            finalStr += "[Finished Cloning]: "
+        case 2:
+            finalStr += "[Counting Objects]: "
+        case 3:
+            finalStr += "[Compressing Objects]: "
+        case 4:
+            finalStr += "[Writing objects]: "
+        case 5:
+            finalStr += "[Recieving Objects]: "
+        case 6:
+            finalStr += "[Unimplemented Code]: "
+        case 7:
+            finalStr += "[Unimplemented Code]:"
+        case 8:
+            finalStr += "[Checking Out Branch]"
+    
+    finalStr += " | " + str(cur_count)
+    if (max_count is not None):
+        finalStr += " / " + str(max_count)
+    else:
+        finalStr += " / ?"
+
+    if (message is not None and message.__len__() > 0):
+        finalStr += "\n" + message
+
+    if (curOS == "WINDOWS"):
+        os.system("cls")
+    else:
+        os.system("clear")
+
+    print(f"Getting package {packName} from {URL}{br}.")
+    print(finalStr)
+
+
+
+fullPath = path + "/Temp_ptgit/" + packName
+
+if (Path(fullPath).exists()):
+    import shutil
+    shutil.rmtree(fullPath)
+
+repo = Repo.clone_from(URL, fullPath, showProg)
+
+zip_path = fullPath + "/" + packName + ".zip"
+
+print(f'zip {zip_path} {os.curdir}')
+os.chdir(fullPath)
+if curOS == "WINDOWS":
+    input("You MUST have 7zip installed for this command to work, press ENTER to continue")
+    zip_process = run(["7z", "a", "-tzip", zip_path, ".\\"])
+
+    while zip_process.returncode is None:
+        from time import sleep
+        if (curOS == "WINDOWS"):
+            os.system("cls")
+        else:
+            os.system("clear")
+
+        print(zip_path.stdout.read())
+
+        sleep(0.01)
+
+    print(zip_process.returncode)
+else:
+    zip_process = run(['zip', '-r', zip_path, "./"])
+
+    while zip_process.returncode is None:
+        from time import sleep
+        if (curOS == "WINDOWS"):
+            os.system("cls")
+        else:
+            os.system("clear")
+
+        print(zip_path.stdout.read())
+
+        sleep(0.01)
+
+    print(zip_process.returncode)
+
+process = run(['pip', 'install', Path(zip_path).resolve().__str__()])
+
+while process.returncode is None:
+    from time import sleep
+    if (curOS == "WINDOWS"):
+        os.system("cls")
+    else:
+        os.system("clear")
+
+    print(process.stdout.read())
+
+    sleep(0.01)
+
+
+print("Cleaning up!")
+
+import shutil
+shutil.rmtree(path + "/Temp_ptgit/") # Remove any git dirs leftover.

ptgit-1.0.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["hatchling >= 1.26"]
+build-backend = "hatchling.build"
+
+[project]
+dependencies= [
+    "gitpython"
+]
+name="ptgit"
+version="1.0.0"
+authors=[{name="CharGoldenYT", email=""}]
+description="Pip Through Git is a way to install python packages through git."
+readme="README.md"
+requires-python = ">=3.12"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+license = "GPL-3.0-or-later"
+license-files = ["LICEN[CS]E*"]
+
+[project.urls]
+Homepage = "https://github.com/CharGoldenYT/ptgit"
+Issues = "https://github.com/CharGoldenYT/ptgit/issues"

ptgit-1.0.0/readme.md

@@ -0,0 +1,24 @@
+# Python Packages through git repositories! | PTGit
+
+PTGit (Pip through Git) is an alternative pip install method that allows you to install python packages directly through a git repository
+
+
+## Adding better compatibility with this tool
+
+If you would like the tool to be able to run smoother with YOUR project, simply include a built package with the following structure in your project
+
+```
+Root
+|
+|   packaged
+|
+|___    pgit.tar.gz
+|
+|___    pgit_details.whl (optional)
+```
+
+## Useage
+
+`python -m ptgit packagename sourceURL`
+
+Installs `packagename` from `sourceURL`