tanh-tooling 0.1.0__tar.gz

tanh_tooling-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+# Python
+python/dist/
+python/build/
+**/__pycache__/
+*.egg-info/
+.venv/
+
+# Node
+node_modules/
+*.tsbuildinfo
+
+# Claude Code personal/local overrides
+.claude/settings.local.json
+
+# OS
+.DS_Store

tanh_tooling-0.1.0/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: tanh-tooling
+Version: 0.1.0
+Summary: tanh-lab shared Python developer configuration (ruff + pyright bases) and a sync CLI.
+Author: Fares Schulz
+Requires-Python: >=3.11
+Requires-Dist: pyright>=1.1.400
+Requires-Dist: ruff>=0.14
+Description-Content-Type: text/markdown
+
+# tanh-tooling (Python)
+
+Shared tanh-lab Python developer configuration: a `ruff` base and a `pyright`
+base, plus a `tanh-tooling sync` CLI that materialises them into a consuming repo.
+
+## Use it
+
+```sh
+uv add tanh-tooling
+uv run tanh-tooling sync        # writes ruff_base.toml + pyright_base.json
+```
+
+Then keep thin, hand-owned configs that extend the bases:
+
+```toml
+# ruff.toml
+extend = "ruff_base.toml"
+```
+
+```json
+// pyrightconfig.json
+{ "extends": "pyright_base.json", "include": ["src"] }
+```
+
+The synced `ruff_base.toml` / `pyright_base.json` are committed but **generated** —
+treat them like a lockfile, never hand-edit. CI drift check:
+
+```sh
+uv run tanh-tooling sync --check
+```

tanh_tooling-0.1.0/README.md

@@ -0,0 +1,30 @@
+# tanh-tooling (Python)
+
+Shared tanh-lab Python developer configuration: a `ruff` base and a `pyright`
+base, plus a `tanh-tooling sync` CLI that materialises them into a consuming repo.
+
+## Use it
+
+```sh
+uv add tanh-tooling
+uv run tanh-tooling sync        # writes ruff_base.toml + pyright_base.json
+```
+
+Then keep thin, hand-owned configs that extend the bases:
+
+```toml
+# ruff.toml
+extend = "ruff_base.toml"
+```
+
+```json
+// pyrightconfig.json
+{ "extends": "pyright_base.json", "include": ["src"] }
+```
+
+The synced `ruff_base.toml` / `pyright_base.json` are committed but **generated** —
+treat them like a lockfile, never hand-edit. CI drift check:
+
+```sh
+uv run tanh-tooling sync --check
+```

tanh_tooling-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "tanh-tooling"
+version = "0.1.0"
+description = "tanh-lab shared Python developer configuration (ruff + pyright bases) and a sync CLI."
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = ["ruff>=0.14", "pyright>=1.1.400"]   # co-pin the tools to the config
+
+[[project.authors]]
+name = "Fares Schulz"
+
+[project.scripts]
+tanh-tooling = "tanh_tooling._cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tanh_tooling"]
+# data/ lives inside the package dir, so ruff_base.toml / pyright_base.json
+# ship with the wheel automatically — no extra include needed.

tanh_tooling-0.1.0/src/tanh_tooling/__init__.py

@@ -0,0 +1,3 @@
+"""tanh-lab shared Python developer configuration."""
+
+__version__ = "0.1.0"

tanh_tooling-0.1.0/src/tanh_tooling/_cli.py

@@ -0,0 +1,47 @@
+import argparse
+import importlib.resources as res
+import shutil
+import sys
+from pathlib import Path
+
+from . import __version__
+
+# package-relative source -> filename written into the consuming repo
+FILES = {"ruff_base.toml": "ruff_base.toml", "pyright_base.json": "pyright_base.json"}
+
+
+def _bundled(name: str) -> Path:
+    # wheels unpack into site-packages, so this resolves to a real path
+    return Path(str(res.files("tanh_tooling").joinpath("data", name)))
+
+
+def main() -> int:
+    p = argparse.ArgumentParser(prog="tanh-tooling")
+    p.add_argument("--version", action="version", version=__version__)
+    sub = p.add_subparsers(dest="cmd", required=True)
+    s = sub.add_parser("sync", help="materialise Python base configs into this repo")
+    s.add_argument(
+        "--check",
+        action="store_true",
+        help="fail if a base config is missing or differs (CI)",
+    )
+    args = p.parse_args()
+
+    dest, drift = Path.cwd(), False
+    for src_name, out_name in FILES.items():
+        src, tgt = _bundled(src_name), dest / out_name
+        if args.check:
+            if not tgt.exists() or tgt.read_bytes() != src.read_bytes():
+                print(f"out of date: {out_name}")
+                drift = True
+        else:
+            shutil.copy(src, tgt)
+            print(f"wrote {out_name}")
+    if args.check and drift:
+        print("run `tanh-tooling sync` and commit the result", file=sys.stderr)
+        return 1
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

tanh_tooling-0.1.0/src/tanh_tooling/data/pyright_base.json

@@ -0,0 +1,7 @@
+{
+  // Reusable pyright policy (strictness + shared rule overrides).
+  // Other projects inherit via "extends": "<path>/pyright_base.json".
+  // Keep repo-specific paths (include/exclude/venv) in each project's pyrightconfig.json,
+  // since relative paths in a base file resolve against the base file's location.
+  "typeCheckingMode": "standard"
+}

tanh_tooling-0.1.0/src/tanh_tooling/data/ruff_base.toml

@@ -0,0 +1,12 @@
+# Reusable Ruff base config (shared style + rule selection).
+# Standalone ruff.toml format: keys are top-level, NOT under [tool.ruff].
+# Other projects can inherit this via `extend = "<path>/ruff_base.toml"`.
+# Named ruff_base.toml (not ruff.toml) on purpose: a bare ruff.toml would be
+# auto-discovered and would override pyproject.toml's [tool.ruff] instead of merging.
+
+line-length = 100
+target-version = "py311"
+
+[lint]
+# E/F = pyflakes + pycodestyle, I = isort, UP = pyupgrade, B = bugbear.
+select = ["E", "F", "I", "UP", "B"]