gitpro 0.3.1__tar.gz

gitpro-0.3.1/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+.venv/
+build/
+dist/
+*.egg-info/
+.pytest_cache/
+
+# Personal configs never belong in this repo.
+gitpro.toml
+identities*.toml
+
+# Agent worktrees (local only).
+.worktrees/

gitpro-0.3.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yantrakar and Sandeep Shelke
+
+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.

gitpro-0.3.1/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.5
+Name: gitpro
+Version: 0.3.1
+Summary: Per-remote git identities (name, email, SSH key, commit signing) from one TOML file
+Project-URL: Homepage, https://github.com/Yantrakar/gitpro
+Project-URL: Documentation, https://github.com/Yantrakar/gitpro/blob/main/docs/guide.md
+Project-URL: Issues, https://github.com/Yantrakar/gitpro/issues
+Author: Yantrakar, Sandeep Shelke
+License-Expression: MIT
+License-File: LICENSE
+Keywords: git,gitconfig,identity,includeif,signing,ssh
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.9
+Requires-Dist: rich>=13
+Requires-Dist: tomli>=1.1; python_version < '3.11'
+Provides-Extra: tui
+Requires-Dist: textual>=0.80; extra == 'tui'
+Description-Content-Type: text/markdown
+
+# gitpro
+
+**The right Git identity, SSH key and signature for every repository.**
+
+Work on a company repository, commit with your work email. Switch to a personal
+project, use your personal identity. Gitpro chooses by **remote URL**, not by
+where you happened to clone the repository.
+
+Useful when you have more than one GitHub/GitLab account, separate work and
+personal keys, or keep finding the wrong email on your commits.
+
+## Try it
+
+Requires **Linux or macOS**, Git **2.36+**, Python **3.9+** and OpenSSH.
+Install from [PyPI](https://pypi.org/project/gitpro/) with pipx.
+
+```sh
+pipx install gitpro
+gitpro setup --write
+```
+
+The wizard helps you choose identities, Git hosts and owners, existing SSH keys,
+and optional signing. **No TOML editing is needed for basic setup.** Review the
+configuration before saving; nothing is applied to Git or SSH yet.
+
+```sh
+gitpro plan              # see exactly what would change
+gitpro apply -y          # explicitly apply the reviewed changes
+```
+
+Then, inside a repository:
+
+```sh
+gitpro why               # see the expected identity and anything overriding it
+```
+
+Already have a config? Run `gitpro setup --write` to add another identity without losing
+your existing settings or comments. Prefer editing files? The
+[user guide](docs/guide.md#configuration) covers the full TOML format.
+
+## What you get
+
+- **Work/personal separation:** names, emails, SSH keys and signing per host/owner.
+- **Answers, not guesswork:** `gitpro why` explains mismatches and suggests a fix.
+- **A safety net:** optional hooks can block wrong-identity commits and pushes.
+- **Editor and container support:** see your identity in VS Code and carry it into dev containers.
+
+Gitpro generates ordinary Git and SSH configuration; it needs no background
+service. Changes can be previewed, existing hand-written files are backed up,
+and key creation or uploads are never part of the setup wizard.
+
+## Using VS Code?
+
+Run **gitpro: Set Up Identities** from the Command Palette to open the same wizard
+in a terminal. The extension also shows the current identity and helps find
+repository-level overrides. [Install the extension](vscode/README.md).
+
+## Go further when you need to
+
+For agents, [the versioned workflow](docs/agent-workflows.md) provides structured
+preflight, identity-scoped execution and durable idempotency for commits, pushes
+and GitHub PRs. Persistent changes use exact proposals, human approval by default,
+optional operator-scoped preauthorization, and recoverable apply. MCP execution is opt-in.
+
+| I want to… | Start here |
+|---|---|
+| Understand matching, SSH keys or signing | [Configuration](docs/guide.md#configuration) |
+| Find wrong identities or forgotten work | [Daily use](docs/guide.md#daily-use) · [Finding things](docs/guide.md#finding-things) |
+| Use dev containers | [Container setup](docs/guide.md#dev-containers) |
+| Configure team policy, CI or AI assistants | [Teams and CI](docs/guide.md#teams) · [AI assistants](docs/guide.md#ai-assistants) |
+| Look up a command or undo changes | [Command reference](docs/guide.md#commands) · [Undo](docs/guide.md#undo-everything) |
+| Troubleshoot or contribute | [Troubleshooting](docs/guide.md#troubleshooting) · [Development](docs/guide.md#development) |
+
+The detailed TOML, YAML and command examples live in the guide, not on the
+getting-started path.
+
+## License
+
+[MIT](LICENSE)

gitpro-0.3.1/README.md

@@ -0,0 +1,79 @@
+# gitpro
+
+**The right Git identity, SSH key and signature for every repository.**
+
+Work on a company repository, commit with your work email. Switch to a personal
+project, use your personal identity. Gitpro chooses by **remote URL**, not by
+where you happened to clone the repository.
+
+Useful when you have more than one GitHub/GitLab account, separate work and
+personal keys, or keep finding the wrong email on your commits.
+
+## Try it
+
+Requires **Linux or macOS**, Git **2.36+**, Python **3.9+** and OpenSSH.
+Install from [PyPI](https://pypi.org/project/gitpro/) with pipx.
+
+```sh
+pipx install gitpro
+gitpro setup --write
+```
+
+The wizard helps you choose identities, Git hosts and owners, existing SSH keys,
+and optional signing. **No TOML editing is needed for basic setup.** Review the
+configuration before saving; nothing is applied to Git or SSH yet.
+
+```sh
+gitpro plan              # see exactly what would change
+gitpro apply -y          # explicitly apply the reviewed changes
+```
+
+Then, inside a repository:
+
+```sh
+gitpro why               # see the expected identity and anything overriding it
+```
+
+Already have a config? Run `gitpro setup --write` to add another identity without losing
+your existing settings or comments. Prefer editing files? The
+[user guide](docs/guide.md#configuration) covers the full TOML format.
+
+## What you get
+
+- **Work/personal separation:** names, emails, SSH keys and signing per host/owner.
+- **Answers, not guesswork:** `gitpro why` explains mismatches and suggests a fix.
+- **A safety net:** optional hooks can block wrong-identity commits and pushes.
+- **Editor and container support:** see your identity in VS Code and carry it into dev containers.
+
+Gitpro generates ordinary Git and SSH configuration; it needs no background
+service. Changes can be previewed, existing hand-written files are backed up,
+and key creation or uploads are never part of the setup wizard.
+
+## Using VS Code?
+
+Run **gitpro: Set Up Identities** from the Command Palette to open the same wizard
+in a terminal. The extension also shows the current identity and helps find
+repository-level overrides. [Install the extension](vscode/README.md).
+
+## Go further when you need to
+
+For agents, [the versioned workflow](docs/agent-workflows.md) provides structured
+preflight, identity-scoped execution and durable idempotency for commits, pushes
+and GitHub PRs. Persistent changes use exact proposals, human approval by default,
+optional operator-scoped preauthorization, and recoverable apply. MCP execution is opt-in.
+
+| I want to… | Start here |
+|---|---|
+| Understand matching, SSH keys or signing | [Configuration](docs/guide.md#configuration) |
+| Find wrong identities or forgotten work | [Daily use](docs/guide.md#daily-use) · [Finding things](docs/guide.md#finding-things) |
+| Use dev containers | [Container setup](docs/guide.md#dev-containers) |
+| Configure team policy, CI or AI assistants | [Teams and CI](docs/guide.md#teams) · [AI assistants](docs/guide.md#ai-assistants) |
+| Look up a command or undo changes | [Command reference](docs/guide.md#commands) · [Undo](docs/guide.md#undo-everything) |
+| Troubleshoot or contribute | [Troubleshooting](docs/guide.md#troubleshooting) · [Development](docs/guide.md#development) |
+
+The detailed TOML, YAML and command examples live in the guide, not on the
+getting-started path.
+
+## License
+
+[MIT](LICENSE)

gitpro-0.3.1/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[project]
+name = "gitpro"
+dynamic = ["version"]
+description = "Per-remote git identities (name, email, SSH key, commit signing) from one TOML file"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Yantrakar" }, { name = "Sandeep Shelke" }]
+requires-python = ">=3.9"
+dependencies = ['tomli>=1.1; python_version < "3.11"', "rich>=13"]
+keywords = ["git", "ssh", "identity", "gitconfig", "includeif", "signing"]
+classifiers = [
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+
+[project.optional-dependencies]
+tui = ["textual>=0.80"]  # interactive scan --fix
+
+[project.urls]
+Homepage = "https://github.com/Yantrakar/gitpro"
+Documentation = "https://github.com/Yantrakar/gitpro/blob/main/docs/guide.md"
+Issues = "https://github.com/Yantrakar/gitpro/issues"
+
+[project.scripts]
+gitpro = "gitpro.hot:main"
+
+[tool.hatch.version]
+path = "src/gitpro/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/gitpro"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src/gitpro", "/README.md", "/LICENSE"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

gitpro-0.3.1/src/gitpro/__init__.py

@@ -0,0 +1,4 @@
+"""Per-remote git identities generated from one TOML file (see cli.py)."""
+from __future__ import annotations
+
+__version__ = "0.3.1"

gitpro-0.3.1/src/gitpro/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from .hot import main
+
+sys.exit(main())