kompactor 0.7.8__tar.gz → 0.7.9__tar.gz

{kompactor-0.7.8 → kompactor-0.7.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kompactor
-Version: 0.7.8
+Version: 0.7.9
 Summary: Cut the tokens Claude Code spends on noise: compacted command output (failing runs included), outline-first reads, a local code graph, and per-turn savings.
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/amarkum/kompactor
@@ -121,8 +121,9 @@ The last step adds the status line and the shell prefix that compacts failing co
 pipx install kompactor        # or: pip install kompactor · uv tool install kompactor
 kompactor setup
 ```
+If your shell says `kompactor: command not found` (pip put the command in a folder that isn't on your PATH), run `python3 -m kompactor setup` once. It links `kompactor` into a folder that is already on your PATH, such as `~/.local/bin`, so the command works in every terminal from then on.
 
-**VS Code.** Download `kompactor-0.7.8.vsix` from [Releases](https://github.com/amarkum/kompactor/releases), install it (Extensions › `⋯` › *Install from VSIX…*), and click **Enable** when Kompactor asks.
+**VS Code.** Download `kompactor-0.7.9.vsix` from [Releases](https://github.com/amarkum/kompactor/releases), install it (Extensions › `⋯` › *Install from VSIX…*), and click **Enable** when Kompactor asks.
 
 **From source:**
 ```bash
@@ -135,7 +136,7 @@ git clone https://github.com/amarkum/kompactor.git && ./kompactor/install.sh
 2. **Work as usual.** You don't call Kompactor; it acts on Claude's tool calls by itself. After each reply you'll see a line like `Kompactor: −8.2k tokens this turn`, and the status line shows the running total.
 3. **Check it's on:** run `kompactor` in a terminal (or `/kompactor` in Claude Code):
    ```
-   Kompactor 0.7.8: ON
+   Kompactor 0.7.9: ON
      Connected via the Claude Code plugin. New Claude Code sessions are compacted.
      Level: Balanced (level 3 of 5). Change it: `kompactor config preset 1-5`, the dashboard, or /kompactor balanced
      Saved so far: 41.3k tokens (−38%) over 52 tool calls. Details: `kompactor gain`
@@ -375,7 +376,7 @@ Everything below happens on your machine. Kompactor makes no network requests of
 
 **What it reads.** The tool output Claude Code passes to its hooks, the files Claude reads (to outline them), your project's source (for the code graph), and the context size Claude Code gives the status line. Hooks never read your session transcripts. `kompactor estimate` and the dashboard's **Replay your history** panel read your local Claude Code session logs in `~/.claude/projects` only when you run them; the result isn't stored or sent anywhere.
 
-**What it writes.** `~/.kompactor/`: settings, the savings ledger, raw copies of shortened output (for `kompactor show`), the code graph index and the `~/.kompactor/bin/` launchers. History is deleted after 30 days by default. Setup edits `~/.claude/settings.json` to add Kompactor's hooks (non-plugin installs), a status line (only if you have none) and `CLAUDE_CODE_SHELL_PREFIX` (only if it isn't set), keeping a backup in `settings.json.kompactor-backup`; non-plugin installs also get the `/kompactor` skill in `~/.claude/skills`. Nothing is written to your repositories.
+**What it writes.** `~/.kompactor/`: settings, the savings ledger, raw copies of shortened output (for `kompactor show`), the code graph index and the `~/.kompactor/bin/` launchers. When `kompactor` isn't on your PATH, it adds one link to that launcher in a writable folder that already is (`~/.local/bin`, `~/bin`, `/opt/homebrew/bin` or `/usr/local/bin`); it never edits shell files or replaces an existing command, and `kompactor uninstall` removes the link. History is deleted after 30 days by default. Setup edits `~/.claude/settings.json` to add Kompactor's hooks (non-plugin installs), a status line (only if you have none) and `CLAUDE_CODE_SHELL_PREFIX` (only if it isn't set), keeping a backup in `settings.json.kompactor-backup`; non-plugin installs also get the `/kompactor` skill in `~/.claude/skills`. Nothing is written to your repositories.
 
 **What it never does.** Change your permission rules or sandbox settings, change what a command does, or send your code or output anywhere. Details: [privacy policy](https://github.com/amarkum/kompactor/blob/main/PRIVACY.md).
 
@@ -383,6 +384,7 @@ Everything below happens on your machine. Kompactor makes no network requests of
 
 | Problem | What to do |
 |---|---|
+| `kompactor: command not found` | pip put the command in a folder that isn't on your PATH. Run `python3 -m kompactor setup` (or `start`) once: it links `kompactor` into a writable folder already on your PATH, such as `~/.local/bin`. Claude Code plugin installs do this at the first session. |
 | No savings line after replies | Restart Claude Code after setup, then run `kompactor doctor`: it checks the installation and shows recent hook errors. The dashboard's **Self-test** panel runs every hook once. |
 | An output looks too short | Claude can fetch the original with `kompactor show <id>`, or search earlier outputs with `kompactor search "text"`. |
 | A command should never be shortened | Add it to **Never compact these commands** on the dashboard, or to `never_compact` in `.kompactor.json`. For a single run, start the command with `KOMPACTOR_RAW=1`. |
@@ -455,5 +457,3 @@ Bug reports, ideas and pull requests are welcome. See [CONTRIBUTING.md](https://
 ## License
 
 [MIT](https://github.com/amarkum/kompactor/blob/main/LICENSE) © The Kompactor authors. The dashboard uses the IBM Plex fonts under the [SIL Open Font License](https://github.com/amarkum/kompactor/blob/main/kompactor/static/fonts/OFL.txt).
-
-Built by [stackcone](https://stackcone.com). Read the story behind it: [Kompactor: Cut the Tokens Claude Code Spends on Noise](https://stackcone.com/blog/posts/kompactor-claude-code-token-saver/).

{kompactor-0.7.8 → kompactor-0.7.9}/README.md

@@ -88,8 +88,9 @@ The last step adds the status line and the shell prefix that compacts failing co
 pipx install kompactor        # or: pip install kompactor · uv tool install kompactor
 kompactor setup
 ```
+If your shell says `kompactor: command not found` (pip put the command in a folder that isn't on your PATH), run `python3 -m kompactor setup` once. It links `kompactor` into a folder that is already on your PATH, such as `~/.local/bin`, so the command works in every terminal from then on.
 
-**VS Code.** Download `kompactor-0.7.8.vsix` from [Releases](https://github.com/amarkum/kompactor/releases), install it (Extensions › `⋯` › *Install from VSIX…*), and click **Enable** when Kompactor asks.
+**VS Code.** Download `kompactor-0.7.9.vsix` from [Releases](https://github.com/amarkum/kompactor/releases), install it (Extensions › `⋯` › *Install from VSIX…*), and click **Enable** when Kompactor asks.
 
 **From source:**
 ```bash
@@ -102,7 +103,7 @@ git clone https://github.com/amarkum/kompactor.git && ./kompactor/install.sh
 2. **Work as usual.** You don't call Kompactor; it acts on Claude's tool calls by itself. After each reply you'll see a line like `Kompactor: −8.2k tokens this turn`, and the status line shows the running total.
 3. **Check it's on:** run `kompactor` in a terminal (or `/kompactor` in Claude Code):
    ```
-   Kompactor 0.7.8: ON
+   Kompactor 0.7.9: ON
      Connected via the Claude Code plugin. New Claude Code sessions are compacted.
      Level: Balanced (level 3 of 5). Change it: `kompactor config preset 1-5`, the dashboard, or /kompactor balanced
      Saved so far: 41.3k tokens (−38%) over 52 tool calls. Details: `kompactor gain`
@@ -342,7 +343,7 @@ Everything below happens on your machine. Kompactor makes no network requests of
 
 **What it reads.** The tool output Claude Code passes to its hooks, the files Claude reads (to outline them), your project's source (for the code graph), and the context size Claude Code gives the status line. Hooks never read your session transcripts. `kompactor estimate` and the dashboard's **Replay your history** panel read your local Claude Code session logs in `~/.claude/projects` only when you run them; the result isn't stored or sent anywhere.
 
-**What it writes.** `~/.kompactor/`: settings, the savings ledger, raw copies of shortened output (for `kompactor show`), the code graph index and the `~/.kompactor/bin/` launchers. History is deleted after 30 days by default. Setup edits `~/.claude/settings.json` to add Kompactor's hooks (non-plugin installs), a status line (only if you have none) and `CLAUDE_CODE_SHELL_PREFIX` (only if it isn't set), keeping a backup in `settings.json.kompactor-backup`; non-plugin installs also get the `/kompactor` skill in `~/.claude/skills`. Nothing is written to your repositories.
+**What it writes.** `~/.kompactor/`: settings, the savings ledger, raw copies of shortened output (for `kompactor show`), the code graph index and the `~/.kompactor/bin/` launchers. When `kompactor` isn't on your PATH, it adds one link to that launcher in a writable folder that already is (`~/.local/bin`, `~/bin`, `/opt/homebrew/bin` or `/usr/local/bin`); it never edits shell files or replaces an existing command, and `kompactor uninstall` removes the link. History is deleted after 30 days by default. Setup edits `~/.claude/settings.json` to add Kompactor's hooks (non-plugin installs), a status line (only if you have none) and `CLAUDE_CODE_SHELL_PREFIX` (only if it isn't set), keeping a backup in `settings.json.kompactor-backup`; non-plugin installs also get the `/kompactor` skill in `~/.claude/skills`. Nothing is written to your repositories.
 
 **What it never does.** Change your permission rules or sandbox settings, change what a command does, or send your code or output anywhere. Details: [privacy policy](https://github.com/amarkum/kompactor/blob/main/PRIVACY.md).
 
@@ -350,6 +351,7 @@ Everything below happens on your machine. Kompactor makes no network requests of
 
 | Problem | What to do |
 |---|---|
+| `kompactor: command not found` | pip put the command in a folder that isn't on your PATH. Run `python3 -m kompactor setup` (or `start`) once: it links `kompactor` into a writable folder already on your PATH, such as `~/.local/bin`. Claude Code plugin installs do this at the first session. |
 | No savings line after replies | Restart Claude Code after setup, then run `kompactor doctor`: it checks the installation and shows recent hook errors. The dashboard's **Self-test** panel runs every hook once. |
 | An output looks too short | Claude can fetch the original with `kompactor show <id>`, or search earlier outputs with `kompactor search "text"`. |
 | A command should never be shortened | Add it to **Never compact these commands** on the dashboard, or to `never_compact` in `.kompactor.json`. For a single run, start the command with `KOMPACTOR_RAW=1`. |
@@ -422,5 +424,3 @@ Bug reports, ideas and pull requests are welcome. See [CONTRIBUTING.md](https://
 ## License
 
 [MIT](https://github.com/amarkum/kompactor/blob/main/LICENSE) © The Kompactor authors. The dashboard uses the IBM Plex fonts under the [SIL Open Font License](https://github.com/amarkum/kompactor/blob/main/kompactor/static/fonts/OFL.txt).
-
-Built by [stackcone](https://stackcone.com). Read the story behind it: [Kompactor: Cut the Tokens Claude Code Spends on Noise](https://stackcone.com/blog/posts/kompactor-claude-code-token-saver/).

{kompactor-0.7.8 → kompactor-0.7.9}/kompactor/__init__.py

@@ -1,3 +1,3 @@
 """Kompactor: cut the tokens Claude Code spends on noise."""
 
-__version__ = "0.7.8"
+__version__ = "0.7.9"

{kompactor-0.7.8 → kompactor-0.7.9}/kompactor/cli.py

@@ -287,6 +287,12 @@ def _prefix_note(st):
     print(f"  {note}")
 
 
+def _path_note(link):
+    if link:
+        where = os.path.dirname(link).replace(os.path.expanduser("~"), "~", 1)
+        print(f"  Added the `kompactor` command to {where}, so it works in any terminal.")
+
+
 def cmd_setup(a):
     """One-step setup: enable hooks for CLI + VS Code, then open the dashboard."""
     target = installer.install(statusline=config.read_file()["general"].get("statusline", True))
@@ -295,6 +301,7 @@ def cmd_setup(a):
     print(f"  Claude Code CLI:   {'found' if st['claude_cli'] else 'not found'}")
     print(f"  VS Code extension: {st['vscode_extension'] or 'not found'} (uses the same settings)")
     _prefix_note(st)
+    _path_note(installer.link_on_path())
     print("\nNext: restart Claude Code, then work as usual. The status line shows what each turn saved.")
     print("  `kompactor` shows status and how it works · `kompactor stop` turns it off · "
           "`kompactor uninstall` removes it")
@@ -342,6 +349,7 @@ def cmd_start(a):
     if not st["plugin_enabled"] and not st["hooks_installed"]:
         installer.install(statusline=config.read_file()["general"].get("statusline", True))
     print("✓ Kompactor is on: new Claude Code sessions are compacted.")
+    _path_note(installer.link_on_path())
     d = _dashboard()
     if not d:
         from . import server

{kompactor-0.7.8 → kompactor-0.7.9}/kompactor/hooks.py

@@ -266,6 +266,7 @@ def pre_compact(event: dict, cfg: dict) -> None:
 def session_start(event: dict, cfg: dict) -> None:
     try:  # so outputs can point at `~/.kompactor/bin/kompactor` even before `kompactor setup` (plugin installs)
         installer.write_shim(only_if_changed=True)
+        installer.link_on_path()  # and so `kompactor` works in the user's own terminal too
     except OSError:
         pass
     if event.get("source") in ("compact", "clear"):

{kompactor-0.7.8 → kompactor-0.7.9}/kompactor/installer.py

@@ -64,6 +64,43 @@ def write_shim(only_if_changed: bool = False) -> Path:
             f.chmod(0o755)
     return d / "kompactor"
 
+
+# Where a `kompactor` command can be linked when pip put it in a folder that isn't on PATH.
+PATH_DIRS = ("~/.local/bin", "~/bin", "/opt/homebrew/bin", "/usr/local/bin")
+
+
+def link_on_path(path=None, dirs=None) -> str:
+    """Make `kompactor` work in any terminal. A pip install into a Python whose scripts folder isn't on
+    PATH leaves the command unreachable, so link the stable launcher into the first writable folder of
+    `dirs` that is already on PATH. Never edits shell files or replaces an existing command.
+    Returns the link it made, or ""."""
+    path = os.environ.get("PATH", "") if path is None else path
+    dirs = PATH_DIRS if dirs is None else dirs
+    if os.name == "nt" or shutil.which("kompactor", path=path):
+        return ""
+    on_path = {os.path.realpath(p) for p in path.split(os.pathsep) if p}
+    target = write_shim(only_if_changed=True)
+    for d in dirs:
+        d = os.path.expanduser(d)
+        link = Path(d, "kompactor")
+        if os.path.realpath(d) not in on_path or not os.access(d, os.W_OK) or link.exists() or link.is_symlink():
+            continue
+        try:
+            link.symlink_to(target)
+        except OSError:
+            continue
+        return str(link)
+    return ""
+
+
+def unlink_from_path(dirs=None) -> None:
+    """Remove the links link_on_path made, and only those."""
+    target = str(shim_dir() / "kompactor")
+    for d in PATH_DIRS if dirs is None else dirs:
+        link = Path(os.path.expanduser(d), "kompactor")
+        if link.is_symlink() and os.readlink(link) == target:
+            link.unlink()
+
 PREFIX_ENV = "CLAUDE_CODE_SHELL_PREFIX"
 # Claude Code runs every Bash command as `kompactor-shell '<command>'`. Only commands that look like
 # tests, builds, linters or installs start Python; the rest (and everything, if Kompactor is gone)
@@ -270,6 +307,7 @@ def install(scope: str = "user", project: str = "", statusline: bool = True, uni
             pass
     skill = skill_path(scope, project)
     if uninstall:
+        unlink_from_path()
         if skill.exists() and "Kompactor token saver" in skill.read_text():
             skill.unlink()
             try:

{kompactor-0.7.8 → kompactor-0.7.9}/kompactor/static/usage.html

@@ -139,7 +139,7 @@ svg.chev { width: 11px; height: 11px; stroke: var(--ink-3); fill: none; stroke-w
           <pre><code>pipx install kompactor
 kompactor setup</code></pre></div>
         <div class="card"><b>VS Code</b><span class="muted">Download the extension file from the repo's Releases page, then click <b>Enable</b> when Kompactor asks.</span>
-          <pre><code>code --install-extension kompactor-0.7.8.vsix</code></pre></div>
+          <pre><code>code --install-extension kompactor-0.7.9.vsix</code></pre></div>
       </div>
       <p class="muted">Windows: run <code>.\kompactor\install.ps1</code> from a clone, or use the VS Code extension. The CLI and the VS Code extension read the same <code>~/.claude/settings.json</code>, so one install covers both. A backup of that file is kept as <code>settings.json.kompactor-backup</code>.</p>
       <p class="muted">Setup adds hooks, a status line (if you don't have one) and, on macOS and Linux, Claude Code's <code>CLAUDE_CODE_SHELL_PREFIX</code> setting pointing at <code>~/.kompactor/bin/kompactor-shell</code>, which is what lets Kompactor compact failing commands. It never replaces a status line or shell prefix you already have. Restart open Claude Code sessions after setup.</p>

{kompactor-0.7.8 → kompactor-0.7.9}/kompactor.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kompactor
-Version: 0.7.8
+Version: 0.7.9
 Summary: Cut the tokens Claude Code spends on noise: compacted command output (failing runs included), outline-first reads, a local code graph, and per-turn savings.
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/amarkum/kompactor
@@ -121,8 +121,9 @@ The last step adds the status line and the shell prefix that compacts failing co
 pipx install kompactor        # or: pip install kompactor · uv tool install kompactor
 kompactor setup
 ```
+If your shell says `kompactor: command not found` (pip put the command in a folder that isn't on your PATH), run `python3 -m kompactor setup` once. It links `kompactor` into a folder that is already on your PATH, such as `~/.local/bin`, so the command works in every terminal from then on.
 
-**VS Code.** Download `kompactor-0.7.8.vsix` from [Releases](https://github.com/amarkum/kompactor/releases), install it (Extensions › `⋯` › *Install from VSIX…*), and click **Enable** when Kompactor asks.
+**VS Code.** Download `kompactor-0.7.9.vsix` from [Releases](https://github.com/amarkum/kompactor/releases), install it (Extensions › `⋯` › *Install from VSIX…*), and click **Enable** when Kompactor asks.
 
 **From source:**
 ```bash
@@ -135,7 +136,7 @@ git clone https://github.com/amarkum/kompactor.git && ./kompactor/install.sh
 2. **Work as usual.** You don't call Kompactor; it acts on Claude's tool calls by itself. After each reply you'll see a line like `Kompactor: −8.2k tokens this turn`, and the status line shows the running total.
 3. **Check it's on:** run `kompactor` in a terminal (or `/kompactor` in Claude Code):
    ```
-   Kompactor 0.7.8: ON
+   Kompactor 0.7.9: ON
      Connected via the Claude Code plugin. New Claude Code sessions are compacted.
      Level: Balanced (level 3 of 5). Change it: `kompactor config preset 1-5`, the dashboard, or /kompactor balanced
      Saved so far: 41.3k tokens (−38%) over 52 tool calls. Details: `kompactor gain`
@@ -375,7 +376,7 @@ Everything below happens on your machine. Kompactor makes no network requests of
 
 **What it reads.** The tool output Claude Code passes to its hooks, the files Claude reads (to outline them), your project's source (for the code graph), and the context size Claude Code gives the status line. Hooks never read your session transcripts. `kompactor estimate` and the dashboard's **Replay your history** panel read your local Claude Code session logs in `~/.claude/projects` only when you run them; the result isn't stored or sent anywhere.
 
-**What it writes.** `~/.kompactor/`: settings, the savings ledger, raw copies of shortened output (for `kompactor show`), the code graph index and the `~/.kompactor/bin/` launchers. History is deleted after 30 days by default. Setup edits `~/.claude/settings.json` to add Kompactor's hooks (non-plugin installs), a status line (only if you have none) and `CLAUDE_CODE_SHELL_PREFIX` (only if it isn't set), keeping a backup in `settings.json.kompactor-backup`; non-plugin installs also get the `/kompactor` skill in `~/.claude/skills`. Nothing is written to your repositories.
+**What it writes.** `~/.kompactor/`: settings, the savings ledger, raw copies of shortened output (for `kompactor show`), the code graph index and the `~/.kompactor/bin/` launchers. When `kompactor` isn't on your PATH, it adds one link to that launcher in a writable folder that already is (`~/.local/bin`, `~/bin`, `/opt/homebrew/bin` or `/usr/local/bin`); it never edits shell files or replaces an existing command, and `kompactor uninstall` removes the link. History is deleted after 30 days by default. Setup edits `~/.claude/settings.json` to add Kompactor's hooks (non-plugin installs), a status line (only if you have none) and `CLAUDE_CODE_SHELL_PREFIX` (only if it isn't set), keeping a backup in `settings.json.kompactor-backup`; non-plugin installs also get the `/kompactor` skill in `~/.claude/skills`. Nothing is written to your repositories.
 
 **What it never does.** Change your permission rules or sandbox settings, change what a command does, or send your code or output anywhere. Details: [privacy policy](https://github.com/amarkum/kompactor/blob/main/PRIVACY.md).
 
@@ -383,6 +384,7 @@ Everything below happens on your machine. Kompactor makes no network requests of
 
 | Problem | What to do |
 |---|---|
+| `kompactor: command not found` | pip put the command in a folder that isn't on your PATH. Run `python3 -m kompactor setup` (or `start`) once: it links `kompactor` into a writable folder already on your PATH, such as `~/.local/bin`. Claude Code plugin installs do this at the first session. |
 | No savings line after replies | Restart Claude Code after setup, then run `kompactor doctor`: it checks the installation and shows recent hook errors. The dashboard's **Self-test** panel runs every hook once. |
 | An output looks too short | Claude can fetch the original with `kompactor show <id>`, or search earlier outputs with `kompactor search "text"`. |
 | A command should never be shortened | Add it to **Never compact these commands** on the dashboard, or to `never_compact` in `.kompactor.json`. For a single run, start the command with `KOMPACTOR_RAW=1`. |
@@ -455,5 +457,3 @@ Bug reports, ideas and pull requests are welcome. See [CONTRIBUTING.md](https://
 ## License
 
 [MIT](https://github.com/amarkum/kompactor/blob/main/LICENSE) © The Kompactor authors. The dashboard uses the IBM Plex fonts under the [SIL Open Font License](https://github.com/amarkum/kompactor/blob/main/kompactor/static/fonts/OFL.txt).
-
-Built by [stackcone](https://stackcone.com). Read the story behind it: [Kompactor: Cut the Tokens Claude Code Spends on Noise](https://stackcone.com/blog/posts/kompactor-claude-code-token-saver/).

{kompactor-0.7.8 → kompactor-0.7.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kompactor"
-version = "0.7.8"
+version = "0.7.9"
 description = "Cut the tokens Claude Code spends on noise: compacted command output (failing runs included), outline-first reads, a local code graph, and per-turn savings."
 readme = "README.md"
 requires-python = ">=3.9"

{kompactor-0.7.8 → kompactor-0.7.9}/tests/test_graph.py

@@ -11,7 +11,8 @@ from pathlib import Path
 
 os.environ.setdefault("KOMPACTOR_HOME", tempfile.mkdtemp())
 
-from kompactor import config, graph, hooks  # noqa: E402
+from kompactor import config, graph, hooks, installer  # noqa: E402
+installer.PATH_DIRS = ()  # never link `kompactor` into real PATH folders from tests
 
 
 def make_repo(files: dict) -> str:

{kompactor-0.7.8 → kompactor-0.7.9}/tests/test_kompactor.py

@@ -12,6 +12,7 @@ TMP = tempfile.mkdtemp()
 os.environ["KOMPACTOR_HOME"] = os.path.join(TMP, "home")
 
 from kompactor import config, estimate, filters, hooks, installer, langs, outline, server, store, tokens  # noqa: E402
+installer.PATH_DIRS = ()  # never link `kompactor` into real PATH folders from tests
 
 
 def run_hook(name, event):
@@ -565,6 +566,24 @@ class SourceTests(unittest.TestCase):
         self.assertEqual(installer.parse_source(ssh)["clone"], ssh)
         self.assertEqual(installer.parse_source(""), {})
 
+    def test_command_linked_onto_path_when_missing(self):
+        from unittest import mock
+        tmp = Path(tempfile.mkdtemp())
+        on_path, off_path, shim = tmp / "bin", tmp / "elsewhere", tmp / "shim"
+        on_path.mkdir(); off_path.mkdir()
+        with mock.patch.object(installer, "shim_dir", return_value=shim):
+            # only a writable folder that is already on PATH gets the link
+            link = installer.link_on_path(path=str(on_path), dirs=(str(off_path), str(on_path)))
+            self.assertEqual(link, str(on_path / "kompactor"))
+            self.assertEqual(os.readlink(link), str(shim / "kompactor"))
+            self.assertEqual(installer.link_on_path(path=str(on_path), dirs=(str(on_path),)), "")  # already there
+            installer.unlink_from_path(dirs=(str(on_path),))
+            self.assertFalse(Path(link).is_symlink())
+            (on_path / "kompactor").write_text("someone else's")  # never replaced
+            self.assertEqual(installer.link_on_path(path=str(on_path), dirs=(str(on_path),)), "")
+            installer.unlink_from_path(dirs=(str(on_path),))
+            self.assertTrue((on_path / "kompactor").exists())
+
     def test_source_defaults_to_the_public_repo(self):
         self.assertEqual(installer.source("")["marketplace"], "amarkum/kompactor")
         self.assertEqual(installer.source("acme/kompactor")["clone"], "https://github.com/acme/kompactor.git")  # a fork

{kompactor-0.7.8 → kompactor-0.7.9}/tests/test_shell.py

@@ -20,6 +20,7 @@ ROOT = Path(__file__).resolve().parent.parent
 sys.path.insert(0, str(ROOT))
 
 from kompactor import filters, hooks, installer, shellwrap, tokens  # noqa: E402
+installer.PATH_DIRS = ()  # never link `kompactor` into real PATH folders from tests
 
 PASSING = "".join(f"tests/test_mod.py::test_case_{i} PASSED{' ' * 30}[{i // 5:3d}%]\n" for i in range(500))
 FAILURE = ("=================================== FAILURES ===================================\n"