tony-cli 0.3.0__tar.gz → 0.3.2__tar.gz

{tony_cli-0.3.0/src/tony_cli.egg-info → tony_cli-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tony-cli
-Version: 0.3.0
+Version: 0.3.2
 Summary: Explains a git diff to whoever now owns it — annotated changes, blast radius, and steppable runtime walkthroughs.
 Author: Fawwaz Abayomi
 License: MIT License
@@ -104,9 +104,62 @@ first run tells you exactly where to get one and where to put it. tony reviews
 **committed** work: it shows code straight from disk, so the working tree must
 match the revision under review.
 
-Useful flags: `--replay` rebuilds the page from the last run without calling
-the API, `--json` prints the raw review, `-v` logs every file the model
-actually read, `--stale` overrides the clean-tree check.
+Every command and flag is listed under [Commands](#commands).
+
+## Commands
+
+`tony --help` prints this list. Everything below works from anywhere inside a
+git repo unless noted.
+
+### Reviewing
+
+```sh
+tony                          # default branch...HEAD, in the current repo
+tony main...my-branch         # an explicit range
+tony my-branch                # shorthand for my-branch...HEAD
+tony ../other-repo main...x   # any path inside another repo
+```
+
+The range is git's own `BASE...HEAD` syntax. With no range, tony diffs against
+`origin/HEAD` — what the remote calls its default branch — falling back to
+`main`, then `master`.
+
+| Flag | What it does |
+|---|---|
+| `--local` | Keep the review on this machine. No account needed, nothing uploaded; you get the self-contained page in `.tony/` instead of a link. |
+| `--json` | Print the raw review JSON to stdout and exit. Writes no page, uploads nothing, needs no account. |
+| `--no-open` | Write the page but don't open a browser. For CI, or over SSH. |
+| `--stale` | Review a revision that isn't checked out, or with a dirty tree. Code is read from disk, so line numbers may not match the diff — tony refuses by default for that reason. |
+| `--replay` | Rebuild the page from the last saved review for this range, without calling the API. Free; use it after a tony upgrade to re-render an old review. |
+| `-v`, `--verbose` | Log every tool call to stderr, so you can see which files the review actually read before it drew conclusions. |
+| `-m`, `--model` | Model to review with. Defaults to `claude-opus-5`. |
+| `--max-tokens` | Response ceiling, default `64000`. Raise it if a review comes back cut off. |
+
+### Sharing
+
+| Command | What it does |
+|---|---|
+| `tony login` | Sign in to tony-cli.com with GitHub's device flow. Once per machine. |
+| `tony logout` | Revoke this machine's token server-side, then delete it locally. |
+| `tony whoami` | Which GitHub account this machine is signed in as. |
+| `tony unpublish <id>` | Take one published review down. The id is the last part of its URL. |
+
+Publishing is the default when you're signed in. `--local` opts out per run.
+
+### Managing tony
+
+| Command | What it does |
+|---|---|
+| `tony update` | Upgrade to the latest release, using whichever of uv, pipx or pip installed tony. Checks PyPI first and tells you if you're already current. |
+| `tony uninstall` | Delete tony and everything it wrote — see [Uninstall](#uninstall). |
+| `tony --version` | The installed version. |
+| `tony --help` | Every command and flag. |
+
+`tony uninstall` takes `--yes` (`-y`) to skip the confirmation and `--no-scan` to
+limit it to the current repo instead of searching your home directory.
+
+Both `tony update` and the installer resolve from PyPI explicitly, so a machine
+pointed at an internal mirror can't decide what `tony-cli` is.
 
 ## Share a review
 
@@ -131,17 +184,6 @@ server to be able to open a review.
 
 Local review needs no account and never leaves the machine: `tony --local`.
 
-## Update
-
-```sh
-tony update
-```
-
-Uses whichever of uv, pipx, or pip installed tony, and resolves from PyPI
-explicitly so a machine pointed at an internal mirror cannot decide what
-`tony-cli` is. `tony --version` says what you have; `tony --help` lists every
-command.
-
 ## Uninstall
 
 ```sh
@@ -170,6 +212,13 @@ npm run build:viewer         # rebuild the renderer bundle the CLI embeds
 npm run dev                  # the site; /dev renders src/fixtures/review.json
 ```
 
+Two flags exist only for this loop, and only work from a source checkout:
+
+| Flag | What it does |
+|---|---|
+| `--viewer` | Write the payload straight into the local Astro viewer and reload it there, so you can iterate on the renderer against a real review. |
+| `--payload [PATH]` | Write the upload payload — windowed source, no absolute paths — next to the page, or to `PATH`. |
+
 There is exactly one renderer — `web/src/renderer/render.ts` — used by both
 the local page and the hosted site. The Python side decides all layout facts
 (line numbers, spans, added/changed tags) in `src/tony_cli/layout.py` and ships

{tony_cli-0.3.0 → tony_cli-0.3.2}/README.md

@@ -50,9 +50,62 @@ first run tells you exactly where to get one and where to put it. tony reviews
 **committed** work: it shows code straight from disk, so the working tree must
 match the revision under review.
 
-Useful flags: `--replay` rebuilds the page from the last run without calling
-the API, `--json` prints the raw review, `-v` logs every file the model
-actually read, `--stale` overrides the clean-tree check.
+Every command and flag is listed under [Commands](#commands).
+
+## Commands
+
+`tony --help` prints this list. Everything below works from anywhere inside a
+git repo unless noted.
+
+### Reviewing
+
+```sh
+tony                          # default branch...HEAD, in the current repo
+tony main...my-branch         # an explicit range
+tony my-branch                # shorthand for my-branch...HEAD
+tony ../other-repo main...x   # any path inside another repo
+```
+
+The range is git's own `BASE...HEAD` syntax. With no range, tony diffs against
+`origin/HEAD` — what the remote calls its default branch — falling back to
+`main`, then `master`.
+
+| Flag | What it does |
+|---|---|
+| `--local` | Keep the review on this machine. No account needed, nothing uploaded; you get the self-contained page in `.tony/` instead of a link. |
+| `--json` | Print the raw review JSON to stdout and exit. Writes no page, uploads nothing, needs no account. |
+| `--no-open` | Write the page but don't open a browser. For CI, or over SSH. |
+| `--stale` | Review a revision that isn't checked out, or with a dirty tree. Code is read from disk, so line numbers may not match the diff — tony refuses by default for that reason. |
+| `--replay` | Rebuild the page from the last saved review for this range, without calling the API. Free; use it after a tony upgrade to re-render an old review. |
+| `-v`, `--verbose` | Log every tool call to stderr, so you can see which files the review actually read before it drew conclusions. |
+| `-m`, `--model` | Model to review with. Defaults to `claude-opus-5`. |
+| `--max-tokens` | Response ceiling, default `64000`. Raise it if a review comes back cut off. |
+
+### Sharing
+
+| Command | What it does |
+|---|---|
+| `tony login` | Sign in to tony-cli.com with GitHub's device flow. Once per machine. |
+| `tony logout` | Revoke this machine's token server-side, then delete it locally. |
+| `tony whoami` | Which GitHub account this machine is signed in as. |
+| `tony unpublish <id>` | Take one published review down. The id is the last part of its URL. |
+
+Publishing is the default when you're signed in. `--local` opts out per run.
+
+### Managing tony
+
+| Command | What it does |
+|---|---|
+| `tony update` | Upgrade to the latest release, using whichever of uv, pipx or pip installed tony. Checks PyPI first and tells you if you're already current. |
+| `tony uninstall` | Delete tony and everything it wrote — see [Uninstall](#uninstall). |
+| `tony --version` | The installed version. |
+| `tony --help` | Every command and flag. |
+
+`tony uninstall` takes `--yes` (`-y`) to skip the confirmation and `--no-scan` to
+limit it to the current repo instead of searching your home directory.
+
+Both `tony update` and the installer resolve from PyPI explicitly, so a machine
+pointed at an internal mirror can't decide what `tony-cli` is.
 
 ## Share a review
 
@@ -77,17 +130,6 @@ server to be able to open a review.
 
 Local review needs no account and never leaves the machine: `tony --local`.
 
-## Update
-
-```sh
-tony update
-```
-
-Uses whichever of uv, pipx, or pip installed tony, and resolves from PyPI
-explicitly so a machine pointed at an internal mirror cannot decide what
-`tony-cli` is. `tony --version` says what you have; `tony --help` lists every
-command.
-
 ## Uninstall
 
 ```sh
@@ -116,6 +158,13 @@ npm run build:viewer         # rebuild the renderer bundle the CLI embeds
 npm run dev                  # the site; /dev renders src/fixtures/review.json
 ```
 
+Two flags exist only for this loop, and only work from a source checkout:
+
+| Flag | What it does |
+|---|---|
+| `--viewer` | Write the payload straight into the local Astro viewer and reload it there, so you can iterate on the renderer against a real review. |
+| `--payload [PATH]` | Write the upload payload — windowed source, no absolute paths — next to the page, or to `PATH`. |
+
 There is exactly one renderer — `web/src/renderer/render.ts` — used by both
 the local page and the hosted site. The Python side decides all layout facts
 (line numbers, spans, added/changed tags) in `src/tony_cli/layout.py` and ships

{tony_cli-0.3.0 → tony_cli-0.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tony-cli"
-version = "0.3.0"
+version = "0.3.2"
 description = "Explains a git diff to whoever now owns it — annotated changes, blast radius, and steppable runtime walkthroughs."
 readme = "README.md"
 license = { file = "LICENSE" }

{tony_cli-0.3.0 → tony_cli-0.3.2}/src/tony_cli/install.py

@@ -57,11 +57,18 @@ def uninstallCommand(kind):
 
 
 def updateCommand(kind):
+    """The upgrade, told to ignore its own cache.
+
+    Every one of these caches the index, and a cache that is minutes stale
+    resolves to the version before the one just released — then reports
+    "already at latest" and exits 0. An update that runs once a month should
+    pay for a fresh lookup rather than confidently do nothing.
+    """
     if kind == "uv":
-        return ["uv", "tool", "upgrade", PKG]
+        return ["uv", "tool", "upgrade", "--refresh", PKG]
     if kind == "pipx":
-        return ["pipx", "upgrade", PKG]
-    return [sys.executable, "-m", "pip", "install", "--upgrade", PKG]
+        return ["pipx", "upgrade", PKG, "--pip-args=--no-cache-dir"]
+    return [sys.executable, "-m", "pip", "install", "--upgrade", "--no-cache-dir", PKG]
 
 
 def installedVersion():
@@ -73,6 +80,27 @@ def installedVersion():
         return None
 
 
+def installedOnDisk():
+    """The version the environment's metadata records, re-read from disk.
+
+    `installedVersion` answers from what this interpreter imported at startup,
+    which is precisely the version an upgrade just replaced. The dist-info
+    directory on disk is the only thing in this process that knows what is
+    actually installed now.
+    """
+    import glob
+    import sysconfig
+
+    purelib = sysconfig.get_paths().get("purelib")
+    if not purelib:
+        return None
+    found = glob.glob(os.path.join(purelib, "tony_cli-*.dist-info"))
+    if not found:
+        return None
+    name = os.path.basename(sorted(found)[-1])
+    return name[len("tony_cli-"):-len(".dist-info")] or None
+
+
 def latestVersion(timeout=10):
     """The newest version PyPI serves, or None if it cannot be asked.
 
@@ -128,11 +156,26 @@ def update(argv=()):
         print(f"tony: {kind} could not update tony.", file=sys.stderr)
         return result.returncode
 
-    # This interpreter still has the old version loaded, so it cannot read the
-    # new one back. PyPI's answer is the honest thing to report; without it,
-    # say what happened rather than asserting an outcome.
-    if latest:
-        print(f"\ntony: updated {before or '?'} -> {latest}.")
+    # What PyPI calls newest is not what just landed on this machine. An
+    # installer resolving against a stale index cache prints "already at latest"
+    # for a version that is not the latest, and exits 0 — reporting the upgrade
+    # from PyPI's answer turns that into a confident lie.
+    after = installedOnDisk()
+
+    if after and before and after == before:
+        print(
+            f"\ntony: still {after} — {kind} did not install a newer version, "
+            f"though PyPI offers {latest or 'a newer one'}.\n"
+            f"      Try again in a minute; a release takes a moment to reach "
+            f"every mirror.\n",
+            file=sys.stderr,
+        )
+        return 1
+
+    if after and before:
+        print(f"\ntony: updated {before} -> {after}.")
+    elif after:
+        print(f"\ntony: now on {after}.")
     else:
         print("\ntony: the installer finished. Check it with `tony --version`.")
     return 0

{tony_cli-0.3.0 → tony_cli-0.3.2}/src/tony_cli/uninstall.py

@@ -115,6 +115,24 @@ def uninstall(argv):
         print("usage: tony uninstall [--yes] [--no-scan]", file=sys.stderr)
         return 2
 
+    # A source checkout cannot be uninstalled — deleting someone's working tree
+    # is not on the table — so this command cannot keep its promise here. Doing
+    # the half it can do anyway is the worst outcome available: the API key and
+    # every saved review are gone, the tool is still installed and still on
+    # PATH, and `tony --version` reports the same number as before. Refuse
+    # instead, and say exactly what to run.
+    if isSourceCheckout():
+        print(
+            f"tony: this is a source checkout at {sys.prefix} — an editable\n"
+            f"      install, not something to uninstall. Nothing was deleted.\n\n"
+            f"  To remove it, from the checkout:\n\n"
+            f"      pip uninstall tony-cli\n\n"
+            f"  To clear the key and saved reviews without touching the code:\n\n"
+            f"      rm -rf {configDir()}\n",
+            file=sys.stderr,
+        )
+        return 2
+
     config = configDir()
     hasConfig = os.path.isdir(config)
     if scan:
@@ -123,7 +141,6 @@ def uninstall(argv):
 
     kind = installer()
     command = uninstallCommand(kind)
-    source = isSourceCheckout()
 
     print("\nThis will delete:\n")
     if hasConfig:
@@ -134,10 +151,7 @@ def uninstall(argv):
     if not hasConfig and not reports:
         print("  (nothing — tony has written nothing to this machine)")
     print()
-    if source:
-        print(f"Then: nothing. This is a source checkout at {sys.prefix};")
-        print("      removing the package would delete your working tree, so it stays.")
-    elif os.name == "nt":
+    if os.name == "nt":
         print(f"Then: {' '.join(command)}")
         print("      Windows cannot delete a running program, so run that yourself after.")
     else:
@@ -177,10 +191,6 @@ def uninstall(argv):
               file=sys.stderr)
         return 1
 
-    if source:
-        print("tony: local data removed. The checkout itself is yours to delete.")
-        return 0
-
     if os.name == "nt":
         print("tony: local data removed. Finish with:")
         print(f"    {' '.join(command)}")

{tony_cli-0.3.0 → tony_cli-0.3.2/src/tony_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tony-cli
-Version: 0.3.0
+Version: 0.3.2
 Summary: Explains a git diff to whoever now owns it — annotated changes, blast radius, and steppable runtime walkthroughs.
 Author: Fawwaz Abayomi
 License: MIT License
@@ -104,9 +104,62 @@ first run tells you exactly where to get one and where to put it. tony reviews
 **committed** work: it shows code straight from disk, so the working tree must
 match the revision under review.
 
-Useful flags: `--replay` rebuilds the page from the last run without calling
-the API, `--json` prints the raw review, `-v` logs every file the model
-actually read, `--stale` overrides the clean-tree check.
+Every command and flag is listed under [Commands](#commands).
+
+## Commands
+
+`tony --help` prints this list. Everything below works from anywhere inside a
+git repo unless noted.
+
+### Reviewing
+
+```sh
+tony                          # default branch...HEAD, in the current repo
+tony main...my-branch         # an explicit range
+tony my-branch                # shorthand for my-branch...HEAD
+tony ../other-repo main...x   # any path inside another repo
+```
+
+The range is git's own `BASE...HEAD` syntax. With no range, tony diffs against
+`origin/HEAD` — what the remote calls its default branch — falling back to
+`main`, then `master`.
+
+| Flag | What it does |
+|---|---|
+| `--local` | Keep the review on this machine. No account needed, nothing uploaded; you get the self-contained page in `.tony/` instead of a link. |
+| `--json` | Print the raw review JSON to stdout and exit. Writes no page, uploads nothing, needs no account. |
+| `--no-open` | Write the page but don't open a browser. For CI, or over SSH. |
+| `--stale` | Review a revision that isn't checked out, or with a dirty tree. Code is read from disk, so line numbers may not match the diff — tony refuses by default for that reason. |
+| `--replay` | Rebuild the page from the last saved review for this range, without calling the API. Free; use it after a tony upgrade to re-render an old review. |
+| `-v`, `--verbose` | Log every tool call to stderr, so you can see which files the review actually read before it drew conclusions. |
+| `-m`, `--model` | Model to review with. Defaults to `claude-opus-5`. |
+| `--max-tokens` | Response ceiling, default `64000`. Raise it if a review comes back cut off. |
+
+### Sharing
+
+| Command | What it does |
+|---|---|
+| `tony login` | Sign in to tony-cli.com with GitHub's device flow. Once per machine. |
+| `tony logout` | Revoke this machine's token server-side, then delete it locally. |
+| `tony whoami` | Which GitHub account this machine is signed in as. |
+| `tony unpublish <id>` | Take one published review down. The id is the last part of its URL. |
+
+Publishing is the default when you're signed in. `--local` opts out per run.
+
+### Managing tony
+
+| Command | What it does |
+|---|---|
+| `tony update` | Upgrade to the latest release, using whichever of uv, pipx or pip installed tony. Checks PyPI first and tells you if you're already current. |
+| `tony uninstall` | Delete tony and everything it wrote — see [Uninstall](#uninstall). |
+| `tony --version` | The installed version. |
+| `tony --help` | Every command and flag. |
+
+`tony uninstall` takes `--yes` (`-y`) to skip the confirmation and `--no-scan` to
+limit it to the current repo instead of searching your home directory.
+
+Both `tony update` and the installer resolve from PyPI explicitly, so a machine
+pointed at an internal mirror can't decide what `tony-cli` is.
 
 ## Share a review
 
@@ -131,17 +184,6 @@ server to be able to open a review.
 
 Local review needs no account and never leaves the machine: `tony --local`.
 
-## Update
-
-```sh
-tony update
-```
-
-Uses whichever of uv, pipx, or pip installed tony, and resolves from PyPI
-explicitly so a machine pointed at an internal mirror cannot decide what
-`tony-cli` is. `tony --version` says what you have; `tony --help` lists every
-command.
-
 ## Uninstall
 
 ```sh
@@ -170,6 +212,13 @@ npm run build:viewer         # rebuild the renderer bundle the CLI embeds
 npm run dev                  # the site; /dev renders src/fixtures/review.json
 ```
 
+Two flags exist only for this loop, and only work from a source checkout:
+
+| Flag | What it does |
+|---|---|
+| `--viewer` | Write the payload straight into the local Astro viewer and reload it there, so you can iterate on the renderer against a real review. |
+| `--payload [PATH]` | Write the upload payload — windowed source, no absolute paths — next to the page, or to `PATH`. |
+
 There is exactly one renderer — `web/src/renderer/render.ts` — used by both
 the local page and the hosted site. The Python side decides all layout facts
 (line numbers, spans, added/changed tags) in `src/tony_cli/layout.py` and ships