tanh-tooling 0.1.0__py3-none-any.whl

tanh_tooling/__init__.py

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

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/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/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"]

tanh_tooling-0.1.0.dist-info/METADATA

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

@@ -0,0 +1,8 @@
+tanh_tooling/__init__.py,sha256=qs7C_q4cG8210WILzcfa6hITDJdswYsdn-Mpcs7KsEc,77
+tanh_tooling/_cli.py,sha256=-PcJ1cP3xB0iNEzHr_dwk7gOS12Q4-jLkkOPcuwy7r8,1509
+tanh_tooling/data/pyright_base.json,sha256=iooIpeQA82s5XWToZD5s0NT-h_vVp9VluHM-VD83cJY,349
+tanh_tooling/data/ruff_base.toml,sha256=yuvs0dIjco5acxqHyryC-cvwPXMrSvpQCIcKGEhgvrE,532
+tanh_tooling-0.1.0.dist-info/METADATA,sha256=DKda8fIBqlW_Zk3utCRM7pvhUz92h_6rxvDYfP0xF5g,991
+tanh_tooling-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+tanh_tooling-0.1.0.dist-info/entry_points.txt,sha256=j6gZdU29PjqX1705lfaY3Q873Taml_EO6uYBtJannRg,56
+tanh_tooling-0.1.0.dist-info/RECORD,,

tanh_tooling-0.1.0.dist-info/WHEEL

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

tanh_tooling-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tanh-tooling = tanh_tooling._cli:main