bhtool 0.2.0__tar.gz → 0.2.2__tar.gz

{bhtool-0.2.0 → bhtool-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: bhtool
-Version: 0.2.0
+Version: 0.2.2
 Summary: Assorted CLI utilities for Bosco’s workflows (dev, media, macOS, LLM helpers).
 Author-email: Bosco Ho <apposite@gmail.com>
 Requires-Python: >=3.13
@@ -21,28 +21,29 @@ Assorted CLI utilities that are handy in Bosco’s day-to-day work—version bum
 ### Install options
 
 
-| Option                                    | Description                                                                                                         |
-| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| Option                                   | Description                                                                                                         |
+| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
 | **`uvx bhtool …`**                       | Run from PyPI on demand (no clone). Example:`uvx bhtool --help`, `uvx bhtool run cursor`.                           |
-| **`uv tool install bhtool`**              | Install**`b`** / **`bhtool`** globally from PyPI (released versions).                                               |
+| **`uv tool install bhtool`**             | Install**`b`** / **`bhtool`** globally from PyPI (released versions).                                               |
 | **`uv sync`** then **`uv run bhtool …`** | Use the project venv from a checkout (no global install).                                                           |
-| **`uv tool install .`**                   | Install**`b`** / **`bhtool`** globally from the current directory (pinned copy).                                    |
-| **`uv tool install --editable .`**        | Install**`b`** / **`bhtool`** globally in **editable** mode from a checkout (code changes apply without reinstall). |
+| **`uv tool install .`**                  | Install**`b`** / **`bhtool`** globally from the current directory (pinned copy).                                    |
+| **`uv tool install --editable .`**       | Install**`b`** / **`bhtool`** globally in **editable** mode from a checkout (code changes apply without reinstall). |
 
 ## Commands
 
 
-| Command         | Description                                                                                                                                                                                                    |   |
-| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- |
-| **bumpver**     | Bump version in`pyproject.toml`, commit, push; PyPI publish is on by default (`--no-publish` to skip)                                                                                                          |   |
-| **run**         | Open macOS applications by partial name (e.g.`uvx bhtool run cursor` or `b run cursor` after a local install)                                                                                                  |   |
-| **clr-chmod**   | Remove execute bit from non-shell files; tighten group/other write                                                                                                                                             |   |
-| **npread**      | Print the shape of NumPy`.npy` files                                                                                                                                                                           |   |
-| **psword**      | Find processes by name;`--kill` to terminate                                                                                                                                                                   |   |
-| **rm-npm**      | Recursively delete`node_modules` dirs and `package-lock.json` files                                                                                                                                            |   |
-| **text**        | Convert between Markdown, HTML, DOCX, and Pug (needs`pandoc` and related tools on `PATH`)                                                                                                                      |   |
-| **todict**      | JSON or YAML file, or stdin, → Python`dict(...)`-style repr on stdout                                                                                                                                         |   |
-| **movies**      | `uvx bhtool movies` (or `b movies`) — ask an LLM for normalized names; writes `movie_mapping.json` in the **current working directory**; `--execute` applies renames (default is dry-run table) |   |
+| Command       | Description                                                                                                                                                                                     |     |
+| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- |
+| **bumpver**   | Bump version in`pyproject.toml`, commit, push; PyPI publish is on by default (`--no-publish` to skip)                                                                                           |     |
+| **run**       | Open macOS applications by partial name (e.g.`uvx bhtool run cursor` or `b run cursor` after a local install)                                                                                   |     |
+| **clr-chmod** | Remove execute bit from non-shell files; tighten group/other write                                                                                                                              |     |
+| **npread**    | Print the shape of NumPy`.npy` files                                                                                                                                                            |     |
+| **psword**    | Find processes by name;`--kill` to terminate                                                                                                                                                    |     |
+| **portkill**  | Find processes listening on TCP ports;`--kill` to terminate                                                                                                                                     |     |
+| **rm-npm**    | Recursively delete`node_modules` dirs and `package-lock.json` files                                                                                                                             |     |
+| **text**      | Convert between Markdown, HTML, DOCX, and Pug (needs`pandoc` and related tools on `PATH`)                                                                                                       |     |
+| **todict**    | JSON or YAML file, or stdin, → Python`dict(...)`-style repr on stdout                                                                                                                           |     |
+| **movies**    | `uvx bhtool movies` (or `b movies`) — ask an LLM for normalized names; writes `movie_mapping.json` in the **current working directory**; `--execute` applies renames (default is dry-run table) |     |
 
 ### Movies + LLM
 
@@ -59,7 +60,7 @@ Node CLI: pug formatting, agent config copy. Usage: `jtools <subcommand>`
 **Run (after install):** `npx jtools <subcommand>` resolves the local `jtools` binary (same as `node_modules/.bin/jtools`). Examples: `npx jtools format-pug`, `npx jtools copy-agent`.
 
 
-| Subcommand     | Description                               |
-| ---------------- | ------------------------------------------- |
-| **format-pug** | Format pug in`./index.html`               |
+| Subcommand     | Description                              |
+| -------------- | ---------------------------------------- |
+| **format-pug** | Format pug in`./index.html`              |
 | **copy-agent** | Copy`~/.claude/CLAUDE.md` → `./AGENT.md` |

bhtool-0.2.2/README.md

@@ -0,0 +1,50 @@
+# bhtool
+
+Assorted CLI utilities that are handy in Bosco’s day-to-day work—version bumps, file conversions, process helpers, macOS shortcuts, LLM-assisted movie renaming, and other small odds and ends. **Python ≥3.13.**
+
+### Install options
+
+
+| Option                                   | Description                                                                                                         |
+| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
+| **`uvx bhtool …`**                       | Run from PyPI on demand (no clone). Example:`uvx bhtool --help`, `uvx bhtool run cursor`.                           |
+| **`uv tool install bhtool`**             | Install**`b`** / **`bhtool`** globally from PyPI (released versions).                                               |
+| **`uv sync`** then **`uv run bhtool …`** | Use the project venv from a checkout (no global install).                                                           |
+| **`uv tool install .`**                  | Install**`b`** / **`bhtool`** globally from the current directory (pinned copy).                                    |
+| **`uv tool install --editable .`**       | Install**`b`** / **`bhtool`** globally in **editable** mode from a checkout (code changes apply without reinstall). |
+
+## Commands
+
+
+| Command       | Description                                                                                                                                                                                     |     |
+| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- |
+| **bumpver**   | Bump version in`pyproject.toml`, commit, push; PyPI publish is on by default (`--no-publish` to skip)                                                                                           |     |
+| **run**       | Open macOS applications by partial name (e.g.`uvx bhtool run cursor` or `b run cursor` after a local install)                                                                                   |     |
+| **clr-chmod** | Remove execute bit from non-shell files; tighten group/other write                                                                                                                              |     |
+| **npread**    | Print the shape of NumPy`.npy` files                                                                                                                                                            |     |
+| **psword**    | Find processes by name;`--kill` to terminate                                                                                                                                                    |     |
+| **portkill**  | Find processes listening on TCP ports;`--kill` to terminate                                                                                                                                     |     |
+| **rm-npm**    | Recursively delete`node_modules` dirs and `package-lock.json` files                                                                                                                             |     |
+| **text**      | Convert between Markdown, HTML, DOCX, and Pug (needs`pandoc` and related tools on `PATH`)                                                                                                       |     |
+| **todict**    | JSON or YAML file, or stdin, → Python`dict(...)`-style repr on stdout                                                                                                                           |     |
+| **movies**    | `uvx bhtool movies` (or `b movies`) — ask an LLM for normalized names; writes `movie_mapping.json` in the **current working directory**; `--execute` applies renames (default is dry-run table) |     |
+
+### Movies + LLM
+
+`LLM_SERVICE` selects the backend (`openai`, `groq`, `ollama`, `bedrock`, …). Set it in the process environment or in **`bhtool/.env`** (loaded from the installed package directory). Model defaults come from [microeval](https://pypi.org/project/microeval/)’s config for that service.
+
+---
+
+## jtools
+
+Node CLI: pug formatting, agent config copy. Usage: `jtools <subcommand>`
+
+**Install:** `cd jtools && npm install` — dependencies only; this package is not published, so run it from that directory (or `npm link` after install).
+
+**Run (after install):** `npx jtools <subcommand>` resolves the local `jtools` binary (same as `node_modules/.bin/jtools`). Examples: `npx jtools format-pug`, `npx jtools copy-agent`.
+
+
+| Subcommand     | Description                              |
+| -------------- | ---------------------------------------- |
+| **format-pug** | Format pug in`./index.html`              |
+| **copy-agent** | Copy`~/.claude/CLAUDE.md` → `./AGENT.md` |

bhtool-0.2.2/bhtool/cli.py

@@ -0,0 +1,120 @@
+#!/usr/bin/env python3
+
+"""Unified bhtool CLI (`b` and `bhtool` on PATH)."""
+
+from typing import Literal
+
+from cyclopts import App
+
+app = App(name="bhtool", help="boscoh tools")
+
+
+@app.command(name="run")
+def run_cmd(*params: str):
+    """Open macOS applications by partial name match."""
+    if not params:
+        app["run"].help_print()
+        return
+    import bhtool.run as run_mod
+
+    run_mod.run(*params)
+
+
+@app.command(name="bumpver")
+def bumpver_cmd(
+    part: Literal["major", "minor", "patch"] | None = None, *, publish: bool = True
+):
+    """Bump version in pyproject.toml, commit, push, and optionally publish to PyPI."""
+    import bhtool.bumpver as bumpver_mod
+
+    bumpver_mod.bumpver(part, publish=publish)
+
+
+@app.command(name="clr_chmod")
+def clr_chmod_cmd():
+    """Remove execute permissions from non-script files and write permissions from group/other."""
+    import bhtool.clr_chmod as clr_chmod_mod
+
+    clr_chmod_mod.clr_chmod()
+
+
+@app.command(name="npread")
+def npread_cmd(*files: str):
+    """Print shape of numpy .npy files."""
+    if not files:
+        app["npread"].help_print()
+        return
+    import bhtool.npread as npread_mod
+
+    npread_mod.npread(files)
+
+
+@app.command(name="psword")
+def psword_cmd(*words: str, kill: bool = False):
+    """Find processes by name and optionally kill them."""
+    if not words:
+        app["psword"].help_print()
+        return
+    import bhtool.psword as psword_mod
+
+    psword_mod.psword(words, kill=kill)
+
+
+@app.command(name="portkill")
+def portkill_cmd(*ports: int, kill: bool = False):
+    """Find processes listening on TCP ports and optionally kill them.
+
+    :param ports: TCP ports to inspect (one or more).
+    :param kill: If true, SIGKILL each listener; otherwise list them.
+    """
+    if not ports:
+        app["portkill"].help_print()
+        return
+    import bhtool.portkill as portkill_mod
+
+    portkill_mod.portkill(ports, kill=kill)
+
+
+@app.command(name="rm_npm")
+def rm_npm_cmd():
+    """Recursively remove node_modules directories and package-lock.json files."""
+    import bhtool.rm_npm as rm_npm_mod
+
+    rm_npm_mod.rm_npm()
+
+
+@app.command(name="text")
+def text_cmd(in_fname: str | None = None, out_fname: str | None = None):
+    """Interconvert text-based formats: md, pug, docx, html."""
+    if in_fname is None or out_fname is None:
+        app["text"].help_print()
+        return
+    import bhtool.text as text_mod
+
+    text_mod.convert_text(in_fname, out_fname)
+
+
+@app.command(name="todict")
+def todict_cmd(json: str | None = None, yaml: str | None = None):
+    """Convert JSON or YAML to Python dict format."""
+    import bhtool.todict as todict_mod
+
+    todict_mod.todict(json=json, yaml=yaml)
+
+
+@app.command(name="movies")
+def movies_cmd(root_dir: str | None = None, execute: bool = False):
+    """Normalize movie directory and file names with an LLM (dry-run table by default).
+
+    :param root_dir: Root directory containing movies (positional); default is current working directory.
+    :param execute: If true, perform renames; otherwise dry run (table output).
+    """
+    import bhtool.list_movies as list_movies_mod
+
+    if root_dir == "rename":
+        root_dir = None
+    list_movies_mod.rename(root_dir=root_dir, execute=execute)
+
+
+def main() -> None:
+    app()

bhtool-0.2.2/bhtool/portkill.py

@@ -0,0 +1,49 @@
+#!/usr/bin/env python3
+
+"""Find and kill processes listening on TCP ports"""
+
+import os
+import re
+import signal
+
+from bhtool.utils import run_output
+
+
+def _lsof_pids(port: int) -> list[int]:
+    txt = run_output(f"lsof -nP -iTCP:{port} -sTCP:LISTEN -t")
+    return [int(line) for line in txt.splitlines() if line.strip().isdigit()]
+
+
+def _ss_pids(port: int) -> list[int]:
+    txt = run_output(f"ss -ltnp 'sport = :{port}'")
+    return [int(pid) for pid in re.findall(r"pid=(\d+)", txt)]
+
+
+def _command(pid: int) -> str:
+    cmd = run_output(f"ps -p {pid} -o command=").strip()
+    if len(cmd) > 80:
+        cmd = cmd[:80] + "..."
+    return cmd
+
+
+def find_listeners(port: int) -> list[tuple[int, str]]:
+    """Return ``(pid, command)`` pairs for processes LISTENing on ``port``."""
+    pids = _lsof_pids(port) or _ss_pids(port)
+    return [(pid, _command(pid)) for pid in sorted(set(pids))]
+
+
+def portkill(ports: tuple[int, ...], kill: bool = False):
+    for port in ports:
+        listeners = find_listeners(port)
+        if not listeners:
+            print(f"no process listening on port {port}")
+            continue
+        for pid, cmd in listeners:
+            if kill:
+                print(f"kill target ({cmd})")
+                try:
+                    os.kill(pid, signal.SIGKILL)
+                except ProcessLookupError:
+                    print(f"process {pid} already gone")
+            else:
+                print(f"process {pid}: {cmd}")

{bhtool-0.2.0 → bhtool-0.2.2}/bhtool/run.py

@@ -4,7 +4,7 @@
 
 from path import Path
 
-from bhtool.utils import run
+from bhtool.utils import run as run_shell
 
 search_dirs = [Path("/Applications"), Path.home() / "MyApps"]
 
@@ -20,4 +20,4 @@ def run(*params: str):
 
     params = [f'"{p}"' for p in params]
     cmd = "open -a " + " ".join(params)
-    run(cmd)
+    run_shell(cmd)

{bhtool-0.2.0 → bhtool-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "bhtool"
-version = "0.2.0"
+version = "0.2.2"
 description = "Assorted CLI utilities for Bosco’s workflows (dev, media, macOS, LLM helpers)."
 readme = "README.md"
 requires-python = ">=3.13"

bhtool-0.2.0/README.md

@@ -1,49 +0,0 @@
-# bhtool
-
-Assorted CLI utilities that are handy in Bosco’s day-to-day work—version bumps, file conversions, process helpers, macOS shortcuts, LLM-assisted movie renaming, and other small odds and ends. **Python ≥3.13.**
-
-### Install options
-
-
-| Option                                    | Description                                                                                                         |
-| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
-| **`uvx bhtool …`**                       | Run from PyPI on demand (no clone). Example:`uvx bhtool --help`, `uvx bhtool run cursor`.                           |
-| **`uv tool install bhtool`**              | Install**`b`** / **`bhtool`** globally from PyPI (released versions).                                               |
-| **`uv sync`** then **`uv run bhtool …`** | Use the project venv from a checkout (no global install).                                                           |
-| **`uv tool install .`**                   | Install**`b`** / **`bhtool`** globally from the current directory (pinned copy).                                    |
-| **`uv tool install --editable .`**        | Install**`b`** / **`bhtool`** globally in **editable** mode from a checkout (code changes apply without reinstall). |
-
-## Commands
-
-
-| Command         | Description                                                                                                                                                                                                    |   |
-| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- |
-| **bumpver**     | Bump version in`pyproject.toml`, commit, push; PyPI publish is on by default (`--no-publish` to skip)                                                                                                          |   |
-| **run**         | Open macOS applications by partial name (e.g.`uvx bhtool run cursor` or `b run cursor` after a local install)                                                                                                  |   |
-| **clr-chmod**   | Remove execute bit from non-shell files; tighten group/other write                                                                                                                                             |   |
-| **npread**      | Print the shape of NumPy`.npy` files                                                                                                                                                                           |   |
-| **psword**      | Find processes by name;`--kill` to terminate                                                                                                                                                                   |   |
-| **rm-npm**      | Recursively delete`node_modules` dirs and `package-lock.json` files                                                                                                                                            |   |
-| **text**        | Convert between Markdown, HTML, DOCX, and Pug (needs`pandoc` and related tools on `PATH`)                                                                                                                      |   |
-| **todict**      | JSON or YAML file, or stdin, → Python`dict(...)`-style repr on stdout                                                                                                                                         |   |
-| **movies**      | `uvx bhtool movies` (or `b movies`) — ask an LLM for normalized names; writes `movie_mapping.json` in the **current working directory**; `--execute` applies renames (default is dry-run table) |   |
-
-### Movies + LLM
-
-`LLM_SERVICE` selects the backend (`openai`, `groq`, `ollama`, `bedrock`, …). Set it in the process environment or in **`bhtool/.env`** (loaded from the installed package directory). Model defaults come from [microeval](https://pypi.org/project/microeval/)’s config for that service.
-
----
-
-## jtools
-
-Node CLI: pug formatting, agent config copy. Usage: `jtools <subcommand>`
-
-**Install:** `cd jtools && npm install` — dependencies only; this package is not published, so run it from that directory (or `npm link` after install).
-
-**Run (after install):** `npx jtools <subcommand>` resolves the local `jtools` binary (same as `node_modules/.bin/jtools`). Examples: `npx jtools format-pug`, `npx jtools copy-agent`.
-
-
-| Subcommand     | Description                               |
-| ---------------- | ------------------------------------------- |
-| **format-pug** | Format pug in`./index.html`               |
-| **copy-agent** | Copy`~/.claude/CLAUDE.md` → `./AGENT.md` |

bhtool-0.2.0/bhtool/cli.py

@@ -1,105 +0,0 @@
-#!/usr/bin/env python3
-
-"""Unified bhtool CLI (`b` and `bhtool` on PATH)."""
-
-from typing import Literal
-
-from cyclopts import App
-
-app = App(name="bhtool", help="boscoh tools")
-
-
-@app.command(name="run")
-def run(*params: str):
-    """Open macOS applications by partial name match."""
-    if not params:
-        app["run"].help_print()
-        return
-    from bhtool.run import run
-
-    run(*params)
-
-
-@app.command
-def bumpver(
-    part: Literal["major", "minor", "patch"] | None = None, *, publish: bool = True
-):
-    """Bump version in pyproject.toml, commit, push, and optionally publish to PyPI."""
-    from bhtool.bumpver import bumpver
-
-    bumpver(part, publish=publish)
-
-
-@app.command
-def clr_chmod():
-    """Remove execute permissions from non-script files and write permissions from group/other."""
-    from bhtool.clr_chmod import clr_chmod as clr_chmod_run
-
-    clr_chmod_run()
-
-
-@app.command
-def npread(*files: str):
-    """Print shape of numpy .npy files."""
-    if not files:
-        app["npread"].help_print()
-        return
-    from bhtool.npread import npread
-
-    npread(files)
-
-
-@app.command
-def psword(*words: str, kill: bool = False):
-    """Find processes by name and optionally kill them."""
-    if not words:
-        app["psword"].help_print()
-        return
-    from bhtool.psword import psword
-
-    psword(words, kill=kill)
-
-
-@app.command
-def rm_npm():
-    """Recursively remove node_modules directories and package-lock.json files."""
-    from bhtool.rm_npm import rm_npm
-
-    rm_npm()
-
-
-@app.command
-def text(in_fname: str | None = None, out_fname: str | None = None):
-    """Interconvert text-based formats: md, pug, docx, html."""
-    if in_fname is None or out_fname is None:
-        app["text"].help_print()
-        return
-    from bhtool.text import convert_text
-
-    convert_text(in_fname, out_fname)
-
-
-@app.command
-def todict(json: str | None = None, yaml: str | None = None):
-    """Convert JSON or YAML to Python dict format."""
-    from bhtool.todict import todict
-
-    todict(json=json, yaml=yaml)
-
-
-@app.command(name="movies")
-def movies(root_dir: str | None = None, execute: bool = False):
-    """Normalize movie directory and file names with an LLM (dry-run table by default).
-
-    :param root_dir: Root directory containing movies (positional); default is current working directory.
-    :param execute: If true, perform renames; otherwise dry run (table output).
-    """
-    from bhtool.list_movies import rename
-
-    if root_dir == "rename":
-        root_dir = None
-    rename(root_dir=root_dir, execute=execute)
-
-
-def main() -> None:
-    app()