gitpro 0.3.1__py3-none-any.whl

gitpro/undo.py

@@ -0,0 +1,63 @@
+"""Undo scripts: one shell script per writing run, so `sh <script>` puts back what the run changed."""
+from __future__ import annotations
+
+import os
+import re
+import time
+from pathlib import Path
+from typing import List, Optional
+
+PROG = "gitpro"
+
+
+def _stamp() -> str:
+    return time.strftime("%Y%m%d-%H%M%S")
+
+
+def state_dir() -> Path:
+    """$XDG_STATE_HOME/gitpro or ~/.local/state/gitpro, created 0700."""
+    base = os.environ.get("XDG_STATE_HOME") or str(Path.home() / ".local/state")
+    path = Path(base) / PROG
+    path.mkdir(mode=0o700, parents=True, exist_ok=True)
+    return path
+
+
+def slug(command: str) -> str:
+    """The file-name part of a command: its first word, [A-Za-z0-9-] only ("scan --fix" -> "scan")."""
+    word = (command.split() or ["gitpro"])[0]
+    return re.sub(r"[^A-Za-z0-9-]", "-", word) or "gitpro"
+
+
+def tilde(path: Path) -> str:
+    """path with the home directory shown as ~ (display only)."""
+    home = Path.home()
+    p = Path(path)
+    if p == home:
+        return "~"
+    try:
+        return "~/" + str(p.relative_to(home))
+    except ValueError:
+        return str(p)
+
+
+def write(command: str, lines: List[str], *, what: str, state: Optional[Path] = None) -> Path:
+    """Create <state>/<slug>-undo-<YYYYmmdd-HHMMSS>[-n].sh (O_EXCL, 0700) holding `lines`, which the
+    caller has shell-quoted. No `set -e`: every line runs even when one fails. Returns the path."""
+    state = state or state_dir()
+    state.mkdir(mode=0o700, parents=True, exist_ok=True)
+    stamp = _stamp()
+    text = (f"#!/bin/sh\n# puts back what '{PROG} {command}' changed on {time.strftime('%Y-%m-%d %H:%M')}"
+            f"   ({what})\n" + "".join(line + "\n" for line in lines))
+    for n in range(1000):
+        path = state / f"{slug(command)}-undo-{stamp}{f'-{n}' if n else ''}.sh"
+        try:
+            fd = os.open(path, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o700)
+        except FileExistsError:
+            continue
+        with os.fdopen(fd, "w") as f:
+            f.write(text)
+            f.flush()
+            os.fsync(f.fileno())
+        os.chmod(path, 0o700)  # the umask may have narrowed it
+        return path
+    raise OSError(f"no free undo script name in {state}")

gitpro/view.py

@@ -0,0 +1,155 @@
+"""Terminal output for scan, with rich: colors and wrapping on a terminal, plain text when piped."""
+from __future__ import annotations
+
+from typing import Callable
+
+from rich.console import Console
+from rich.prompt import Confirm
+from rich.syntax import Syntax
+from rich.table import Table
+from rich.text import Text
+from rich.tree import Tree
+
+from .scan import skipped
+
+
+def console() -> Console:
+    c = Console(highlight=False)
+    return c if c.is_terminal else Console(highlight=False, width=120)
+
+
+# One symbol per kind of message, everywhere: ✓ done, ⚠ warning, ✗ error or nothing done, → next step or change.
+def _say(symbol: str, style: str, msg: str, err: bool = False) -> None:
+    out = Console(stderr=True, highlight=False) if err else console()
+    out.print(Text(symbol + " ", style=style) + Text(msg), soft_wrap=True)
+
+
+def ok(msg: str) -> None:
+    _say("✓", "green", msg)
+
+
+def warn(msg: str) -> None:
+    _say("⚠", "yellow", msg, err=True)
+
+
+def error(msg: str) -> None:
+    _say("✗", "bold red", msg, err=True)
+
+
+def aborted() -> None:
+    _say("✗", "yellow", "aborted, nothing written")
+
+
+def step(msg: str) -> None:
+    _say("→", "cyan", msg)
+
+
+def confirm(question: str) -> bool:
+    return Confirm.ask(question, default=False)
+
+
+def plural(n: int, word: str) -> str:
+    return f"{n} {word}{'s' * (n != 1)}"
+
+
+def who(d: dict[str, str]) -> str:
+    return f"{d['name']} <{d['email']}>".strip() if d["email"] else "(no email)"
+
+
+def source(src: str) -> str:
+    return {"repo": "set in the repo", "pin": "pinned in the repo", "": "nowhere"}.get(src, src)
+
+
+def scan(rep: dict, show: Callable[[str], str], *, verbose: bool, suggest: bool, fix: bool, prog: str,
+         again: str, exact: bool) -> None:
+    """again: the command to run the fix for the same directories; exact: rep['roots'] are the repos themselves."""
+    out = console()
+    bad = rep["unreadable"]
+    head = Text(plural(rep["repos"], "repo") + ("" if exact else f" under {', '.join(map(show, rep['roots']))}"),
+                style="bold")
+    n = rep.get("skipped_excluded", 0)
+    skips = f"hidden directories, node_modules and {plural(n, 'excluded dir')}" if n else \
+        "hidden directories and node_modules"
+    head.append(("" if exact else f"  {skips} skipped")
+                + (f" · {skipped(bad)}" + ("" if verbose else " (-v lists them)") if bad else ""), style="dim")
+    out.print(head, soft_wrap=True)
+    if verbose:
+        for b in bad:
+            out.print(Text(f"  ⚠ skipped {show(b['path'])}: {b['error']}", style="dim"), soft_wrap=True)
+
+    if not fix:
+        table = Table(box=None, header_style="dim", pad_edge=False, padding=(0, 2, 0, 0))
+        table.add_column("repos", justify="right")
+        table.add_column("identity")
+        table.add_column("from", style="dim")
+        if verbose:
+            table.add_column("remote owners", style="dim", ratio=1)
+        own = [i for i in rep["identities"] if i["source"] == "repo"]
+        for i in rep["identities"]:
+            if i["source"] == "repo" and not verbose:
+                continue
+            owners = ", ".join(f"{o} {n}" for o, n in i["owners"].items())
+            table.add_row(str(i["repos"]), Text(who(i)), Text(source(i["source"])), *([Text(owners)] if verbose else []))
+        if own and not verbose:
+            table.add_row(str(sum(i["repos"] for i in own)), Text("see below", style="dim"), Text(source("repo")))
+        out.print()
+        out.print(table)
+
+    over = rep["overrides"]
+    if not over:
+        out.print(Text("\n✓ no repo sets user.name or user.email itself: gitpro decides everywhere", style="green"))
+        return
+    out.print(Text(f"\n{plural(len(over), 'repo')} set their own user.name/user.email, which beats {prog}.", style="bold")
+              + Text(" Without it they use:"), soft_wrap=True)
+    # identity after fix -> identity now -> repos
+    groups: dict[str, dict[str, list[dict]]] = {}
+    for r in over:
+        after = who(r["after"]) if r["fixable"] else ""
+        groups.setdefault(after, {}).setdefault(who(r["now"]), []).append(r)
+    for after, befores in sorted(groups.items(), key=lambda kv: (not kv[0], kv[0])):
+        n = sum(map(len, befores.values()))
+        title = Text(after, style="bold green") if after else Text("their own: nothing else sets one, so fix keeps it")
+        tree = Tree(title + Text(f"  ({n} repo{'s' * (n != 1)})", style="dim"), guide_style="dim")
+        for before, rs in sorted(befores.items(), key=lambda kv: (kv[0] == after, kv[0])):
+            names = ", ".join(show(r["path"]) if verbose else r["short"] for r in rs)
+            if before == after:
+                tree.add(Text("unchanged: ", style="dim") + Text(names))
+            else:
+                tree.add(Text("from ", style="dim") + Text(before, style="yellow") + Text(":  ", style="dim")
+                         + Text(names))
+        out.print()
+        out.print(tree)
+
+    if suggest:
+        out.print(f"\nTo keep an identity, paste its block into your config and run '{prog} apply' before the fix.")
+        out.print("An identity applies to every repo of its owners.")
+        for s in rep["suggestions"]:
+            out.print()
+            if out.is_terminal:
+                out.print(Syntax(s["toml"], "toml", theme="ansi_dark", background_color="default"))
+            else:
+                out.print(s["toml"], markup=False, soft_wrap=True)
+        for path in rep["unmatched"]:
+            r = next(o for o in over if o["path"] == path)
+            out.print(f"\n# {show(path)} ({r['owner']}): no identity can match it; after fixing it uses {who(r['after'])}",
+                      markup=False, soft_wrap=True)
+    elif rep["suggestions"] and not fix:
+        out.print(Text(f"\nto keep some of these identities instead: {prog} scan --suggest", style="dim"), soft_wrap=True)
+
+    if not fix:
+        settings = sum(len(r["fixable"]) for r in over)
+        if settings:
+            out.print(Text(f"\ndry run, nothing changed. Remove {plural(settings, 'setting')} from "
+                           f"{plural(sum(bool(r['fixable']) for r in over), 'repo')}: ") + Text(again, style="bold cyan"), soft_wrap=True)
+
+
+def fixed(removed: list[tuple[str, str, str, str]], undo: str) -> None:
+    """removed: (repo, key, value, what git uses now) for each setting."""
+    out = console()
+    out.print()
+    for repo, key, value, now in removed:
+        out.print(Text(f"  {repo}  ", style="dim") + Text(f"{key} {value}") + Text(f"  →  {now}", style="green"),
+                  soft_wrap=True)
+    settings, repos = len(removed), len({r for r, *_ in removed})
+    out.print(Text(f"✓ removed {plural(settings, 'setting')} from {plural(repos, 'repo')}", style="green"))
+    out.print(Text("↩ undo: ", style="dim") + Text(f"sh {undo}", style="bold"), soft_wrap=True)

gitpro-0.3.1.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,50 @@
+gitpro/__init__.py,sha256=C1o8ePwaiweYMQ7ZW0o6pEVr31US8cuu2OP6f84lcOU,133
+gitpro/__main__.py,sha256=89BHL7f25RJlr12miUjiApIn06Jovyy-VBSqHm3_RJ0,52
+gitpro/agents.py,sha256=YP9SMGIkZuyq90uljuk3NmBMbYgp7hoacEmHyy-2EzQ,83996
+gitpro/approval_policy.py,sha256=eGT1xqingfhHzBtdL7IjCeUPOxVOFHRhIruU9nMy2Qs,7930
+gitpro/args.py,sha256=iuLpqAe4u8SheMmFBZw2XM8WdpASgFjJfq4qmowRfq8,3252
+gitpro/audit.py,sha256=szlAFCEfDNDnG4-mcmhxW22rpU52pRu0P9Z4JQNE2l0,39018
+gitpro/change_contract.py,sha256=Ak8TLhVulXhKiGOmISVZ-hMbmID_N8OFwHA5UM47bMg,6332
+gitpro/changes.py,sha256=qrg9La5q1Ml2Z4O_FUgEBYzQV9kpBreD6Q1lUdgWmLo,48105
+gitpro/cli.py,sha256=l2IpaX8z6zsBR3gMjiuCeEnPaDBNnR99V1ZWPQb3f3o,21271
+gitpro/clone.py,sha256=YpNGX4rt-yAgkd_K1jsE8u1NivixyWs2-GSQeB4k-K0,22342
+gitpro/completion.py,sha256=c1swRsb4bcUhYJ1lKjhxJOvFHT5oQvL-dEpJXAP5IEQ,16560
+gitpro/config.py,sha256=9gYU6bgG0ckXi_M0YtNTIwHmdlkfHdz37414RPyh-zA,19822
+gitpro/devcontainer.py,sha256=6rxL9z7eT-0jJrBP_Nd144S8H1JjmNREROQN_zajCko,20025
+gitpro/discover.py,sha256=2M9ityzWOLE0lCPgkdJWX7XRiMsG291gmpR6Yj2FUw8,68780
+gitpro/doctor.py,sha256=wmTU_ourdW-yTTuqgE2VlogmVmaRlYgZsE7nGfRorlc,25240
+gitpro/envcmd.py,sha256=s2_FMpm6L-p1CWfDVAnt6yqMNa-wY6IYqevrVnvg3Hs,16643
+gitpro/example.toml,sha256=2L3KVC-QfSXEFet0CPv_YpcmMclwySgf-kG6YSa6xGM,4969
+gitpro/files.py,sha256=KZk3CVacj-pfJNb31jwVP-jiitcIJcSvyeJNMoKAm8E,4846
+gitpro/forge.py,sha256=33Fs_5GO6Dx0doK7PvmGs2y5BZRwQBUpJuw-cj7QGgQ,56072
+gitpro/guard.py,sha256=RyvzQNXceOPTbOh5_0JCfGlhoDuWE8io8vDtBGn7dtk,50938
+gitpro/health.py,sha256=xy2YVG7MEuG1v9Jl9xJGincT6VQKWKscc-H3Bp-SkI0,57012
+gitpro/hot.py,sha256=xVDY8td8h78J8iygQhNUW4L2-n_WUHd3dys7DedSnTI,1538
+gitpro/jsonfile.py,sha256=eScD5akXxh_2VzJ0832ETLvPf8YIVtyQJUN9ggQwhrk,7326
+gitpro/jsonout.py,sha256=dlcH-r3aGylk0YuR7kbjtZDo-p-cPNTVIiZ3j7CE4hc,831
+gitpro/keys.py,sha256=9C98EkTaDB3BIdiQUc_XknfOJm18N79vh7QcPiP7ICk,2079
+gitpro/lint.py,sha256=126rcOBZjr1YYHsT7ZQ7VAgVRA052Asbup4grqXi-b8,2472
+gitpro/lost.py,sha256=Z4GhEgeisLZEifsUByCJKdtw0tswFEnWT7FCLkWBOes,40642
+gitpro/mcp.py,sha256=YGnc7_dSAzHTo9ErW0F8j9mBiYtPkh3arGYmsanKKjk,51789
+gitpro/operation_contract.py,sha256=7SdaPhmOMX05XGCkKCZmEt8P4BvoaRnAb7Hk3IsLYpQ,9335
+gitpro/operation_io.py,sha256=A1EkLC7UlZOPXxL0zjlipF50PHrVuFXUKen2ub3ikLM,10514
+gitpro/operation_reconcile.py,sha256=KUPtVnox7O4Qa1n5fRpMSv52jN-TtCdorgd9IovQFtI,11463
+gitpro/operations.py,sha256=s5FQAiLIgEwVOuB0gDwWKteADjPCelvt9ardY8cBjgk,45859
+gitpro/pin.py,sha256=IEKlU0MFYZGj2RgdujNwxWx8DfVKvyApibTsJt9Mu4Q,4450
+gitpro/plan.py,sha256=gkw6E8ATY6S6roaqbIlYta7YG3MRQjvScz5YQpR1d4I,8689
+gitpro/policy.py,sha256=RMmlA8E2LIR-B_eNRO2KdrO5_Krz-LzTdIkGbCSzRt8,82768
+gitpro/prompt.py,sha256=OVdc2S6dypHe2p7InQxdlSrvdTjQkrlEUruc7_DW6kI,13397
+gitpro/render.py,sha256=Kc7pSifd8O319QgyuHZNrWhRtje2PNOaPm0hx6Lhziw,21350
+gitpro/resolve.py,sha256=_4et00yrqt9FmMX0_qfoxNQ78HSNQu7t_NCd3U66ztY,39794
+gitpro/scan.py,sha256=zwrIA_nOMD0votYGQwvt7aiki5DrbbYDHNhOvWE80_o,15932
+gitpro/scanroots.py,sha256=RNrz-A3SA1sJbuFPNCwOgj-Qf7V3fwNRqgJlAihytTM,6552
+gitpro/setup.py,sha256=TA0WZD8IB-KzPdCwy9euiTbHPRtUMgXYm4bYcYfiC9M,12523
+gitpro/trailers.py,sha256=NmhYkFoa0YuWQXFGe_3J36xY11D6n4j1QsDwT-twh7A,9357
+gitpro/tui.py,sha256=AHvj7s6XJ7TBm2ygNAIQiy_pxbKpwF0hRruEF7WQiGc,7473
+gitpro/undo.py,sha256=WZKBNFY8gCCqiVu6hA0AQxfH8UG4JDblOxBdBzb0L4U,2209
+gitpro/view.py,sha256=KHiWotFuoxqeUOEPE3FUFRtnngxOmKXh7pSjmceHd1A,6848
+gitpro-0.3.1.dist-info/METADATA,sha256=3wtQc_aS7B1QdN2o9iAXNuNz68bBoM5dCnwnauQRSuY,4357
+gitpro-0.3.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+gitpro-0.3.1.dist-info/entry_points.txt,sha256=2x3GGfk0MITh35CgYxXdFFf0uGVzpn6DUPQ-ElNXGqw,43
+gitpro-0.3.1.dist-info/licenses/LICENSE,sha256=6APC4nv_-AU6LBtOP-oceSBEqRFGVx6gccZrBGk1YIk,1085
+gitpro-0.3.1.dist-info/RECORD,,

gitpro-0.3.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

gitpro-0.3.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+gitpro = gitpro.hot:main

gitpro-0.3.1.dist-info/licenses/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.