testscan 0.1.0__py3-none-win_amd64.whl

testscan-0.1.0.dist-info/METADATA

@@ -0,0 +1,107 @@
+Metadata-Version: 2.5
+Name: testscan
+Version: 0.1.0
+Summary: Static analysis for AI-generated Python tests — thin launcher for the Go testscan CLI
+Project-URL: Homepage, https://github.com/Nikita527/testscan
+Project-URL: Repository, https://github.com/Nikita527/testscan
+Project-URL: Issues, https://github.com/Nikita527/testscan/issues
+Author: Nikita527
+License-Expression: MIT
+Keywords: ai,linter,pytest,static-analysis,test-smells,testing
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# testscan (Python launcher)
+
+English | [Русский](README.ru.md)
+
+Thin wrapper: finds the Go binary and forwards `argv` / exit code.  
+**Source of truth is the Go CLI** (`cmd/testscan`). Python has no rules, parsing, or flag handling.
+
+Package name on PyPI: **`testscan`**. Version comes from git tags (`v*`) via hatch-vcs.
+
+## Install (PyPI)
+
+```bash
+uvx testscan@latest tests/
+# or: pipx run testscan tests/
+# or: pip install testscan && testscan tests/
+```
+
+Release CI builds platform wheels (`linux/amd64`, `darwin/arm64`, `windows/amd64`) with the Go binary under `testscan_py/bin/`.
+
+## Local embed (contributors)
+
+Binaries under `src/testscan_py/bin/` are **not committed** (`.gitignore`). Embed before `uvx --from ./python`. `pyproject.toml` sets `ignore-vcs = true` and `force-include` for `bin/*`, otherwise hatchling can drop the binary because of gitignore.
+
+```powershell
+powershell -ExecutionPolicy Bypass -File python/scripts/embed_bin.ps1
+```
+
+```bash
+bash python/scripts/embed_bin.sh
+```
+
+Manual equivalent:
+
+```bash
+go build -o python/src/testscan_py/bin/testscan ./cmd/testscan
+# Windows: .../bin/testscan.exe
+```
+
+Then:
+
+```bash
+uvx --from ./python testscan --help
+uvx --from ./python testscan rules/testdata/empty --fail-on never
+```
+
+Without embed — via env (handy for debugging the wrapper):
+
+```bash
+go build -o /tmp/testscan ./cmd/testscan
+TESTSCAN_BIN=/tmp/testscan uvx --from ./python testscan --help
+```
+
+### Platform wheel (release / maintainers)
+
+```bash
+# from repo root; needs git tag history for hatch-vcs
+bash python/scripts/build_platform_wheel.sh linux-amd64 manylinux_2_17_x86_64
+```
+
+Tag a release (`v0.1.0`) to trigger `.github/workflows/release.yml` → multi-OS wheels → PyPI + GitHub Release.
+
+Before the first publish: create a PyPI project + [Trusted Publisher](https://docs.pypi.org/trusted-publishers/) for this repo (workflow `Release`, environment `pypi`), or the publish job will fail on OIDC.
+
+## Binary lookup (priority)
+
+1. `TESTSCAN_BIN`
+2. bundled: `testscan_py/bin/testscan.exe` (Windows) / `testscan` (unix)
+3. `PATH` (`shutil.which("testscan")`)
+
+If not found → message on stderr, exit `2`.
+
+## Manual check list
+
+- [x] `uvx testscan@latest --help` (after PyPI publish) → usage (exit 0)
+- [x] `uvx --from ./python testscan --help` after embed → usage (exit 0)
+- [x] `uvx --from ./python testscan rules/testdata/empty/hit --rule empty-test --fail-on error` → exit 1
+- [x] `uvx --from ./python testscan rules/testdata/empty/clean --fail-on error` → exit 0
+- [x] bundled binary in wheel after embed + `ignore-vcs` / `force-include`
+- [x] `go test ./...` green

testscan-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+testscan_py/__init__.py,sha256=JmfAvCrIymZlazY3cDkZBtkCxb1FgUd4dpvIVyCo_O0,208
+testscan_py/_version.py,sha256=ptILGutmCA6QX4OPt03bkYZX2VUTr2ovOOy8vb2k2ZU,544
+testscan_py/cli.py,sha256=8q1-JprvPWDTeAEfhCxCOm-jZPnpqnEYd3_6fBcLBvM,1478
+testscan_py/bin/.gitkeep,sha256=Zou8IZ3GE4d1_ImZSH2x9-hiGPsg6bg2TcMsL9Sl4XY,178
+testscan_py/bin/testscan.exe,sha256=_WJCtW1MIz9mt0lxzLqsYldNO7mySG_EIrDfQOq4ld4,2958848
+testscan-0.1.0.dist-info/METADATA,sha256=thduCBOfCOnhpUw-xQDU_cAjWiammBbI2eMM86cDwsY,3878
+testscan-0.1.0.dist-info/WHEEL,sha256=DqRKTdcjqcnA9JhnVHem7iyI7zn0B1vfHx5zVCEXDZY,95
+testscan-0.1.0.dist-info/entry_points.txt,sha256=ORpinBgXEk20x8X-dzXLTyeF66kD2f0OCCV2rFPdjTU,50
+testscan-0.1.0.dist-info/RECORD,,

testscan-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: false
+Tag: py3-none-win_amd64
+

testscan-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+testscan = testscan_py.cli:main

testscan_py/__init__.py

@@ -0,0 +1,6 @@
+"""Launcher package for the Go testscan CLI."""
+
+try:
+    from testscan_py._version import __version__
+except ImportError:  # pragma: no cover - missing only in bare checkouts
+    __version__ = "0.0.0"

testscan_py/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.1.0'
+__version_tuple__ = version_tuple = (0, 1, 0)
+
+__commit_id__ = commit_id = None

testscan_py/bin/.gitkeep

@@ -0,0 +1,4 @@
+# Go binary is not committed (see repo .gitignore *.exe).
+# Build into this directory:
+#   powershell python/scripts/embed_bin.ps1
+#   # or: bash python/scripts/embed_bin.sh

testscan_py/cli.py

@@ -0,0 +1,51 @@
+"""Thin launcher for the Go testscan binary. No parsing or rules here."""
+
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+
+def resolve_bin() -> Path:
+    if env := os.environ.get("TESTSCAN_BIN"):
+        p = Path(env)
+        if not p.is_file():
+            raise FileNotFoundError(f"TESTSCAN_BIN not a file: {env}")
+        return p
+
+    name = "testscan.exe" if os.name == "nt" else "testscan"
+    bundled = Path(__file__).resolve().parent / "bin" / name
+    if bundled.is_file():
+        return bundled
+
+    which = shutil.which("testscan")
+    if which:
+        p = Path(which).resolve()
+        # не выбирать сам uvx/pip entry-point (рекурсия)
+        argv0 = Path(sys.argv[0]).resolve()
+        if p != argv0 and p.is_file():
+            return p
+
+    raise FileNotFoundError(
+        "testscan binary not found. Install from PyPI (uvx testscan@latest), "
+        "set TESTSCAN_BIN, run python/scripts/embed_bin.ps1 (or .sh), "
+        "or put the Go binary on PATH."
+    )
+
+
+def main() -> None:
+    try:
+        bin_path = resolve_bin()
+    except FileNotFoundError as exc:
+        print(f"testscan: {exc}", file=sys.stderr)
+        raise SystemExit(2) from exc
+
+    # Windows + uvx: subprocess надёжнее os.execv
+    raise SystemExit(subprocess.call([str(bin_path), *sys.argv[1:]]))
+
+
+if __name__ == "__main__":
+    main()