codeanalyzer-typescript 0.1.0__py3-none-macosx_10_12_x86_64.whl

codeanalyzer_typescript/__init__.py

@@ -0,0 +1,52 @@
+"""Prebuilt ``codeanalyzer-typescript`` backend binary for CLDK.
+
+This package carries the platform-specific, self-contained ``codeanalyzer-typescript``
+executable (built from this repo with ``bun build --compile``) and exposes its
+filesystem path. CLDK's Python SDK depends on this package and calls
+:func:`bin_path` to locate the analyzer, exactly as it imports ``codeanalyzer-python``
+for the Python backend.
+
+Each published wheel is platform-tagged and contains the single binary for that
+platform; pip resolves the correct wheel at install time.
+"""
+
+from __future__ import annotations
+
+import os
+import stat
+import sys
+from importlib import resources
+from pathlib import Path
+
+__version__ = "0.1.0"
+
+__all__ = ["bin_path", "__version__"]
+
+_BINARY_NAME = "codeanalyzer-typescript" + (".exe" if sys.platform == "win32" else "")
+
+
+def bin_path() -> Path:
+    """Return the absolute path to the bundled ``codeanalyzer-typescript`` binary.
+
+    Raises:
+        FileNotFoundError: if the wheel for this platform did not include a binary
+            (e.g. an unsupported platform, or a source/dev install with no build run).
+    """
+    resource = resources.files("codeanalyzer_typescript") / "_bin" / _BINARY_NAME
+    with resources.as_file(resource) as extracted:
+        path = Path(extracted)
+
+    if not path.exists():
+        raise FileNotFoundError(
+            f"Bundled codeanalyzer-typescript binary not found at {path}. "
+            "This usually means there is no prebuilt wheel for your platform; "
+            "build the binary with `bun build --compile` and point CLDK at it via "
+            "analysis_backend_path or $CODEANALYZER_TS_BIN."
+        )
+
+    # Wheels may not preserve the executable bit on POSIX; restore it best-effort.
+    if os.name == "posix":
+        mode = path.stat().st_mode
+        path.chmod(mode | stat.S_IEXEC | stat.S_IXGRP | stat.S_IXOTH)
+
+    return path

codeanalyzer_typescript/_bin/.gitignore

@@ -0,0 +1,5 @@
+# The compiled binary is produced per-platform at build time and bundled into
+# the wheel via `artifacts` in pyproject.toml. Never commit it (platform-specific,
+# ~70 MB). Keep this directory present so the package is importable in dev.
+*
+!.gitignore

codeanalyzer_typescript-0.1.0.dist-info/METADATA

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: codeanalyzer-typescript
+Version: 0.1.0
+Summary: Prebuilt codeanalyzer-typescript backend binary for CLDK (codellm-devkit).
+Project-URL: Homepage, https://codellm-devkit.info
+Project-URL: Repository, https://github.com/codellm-devkit/codeanalyzer-ts
+Author-email: Rahul Krishna <i.m.ralk@gmail.com>
+License: Apache-2.0
+Keywords: cldk,code analysis,codellm-devkit,typescript
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# codeanalyzer-typescript (Python distribution)
+
+This directory packages the compiled `codeanalyzer-typescript` binary as a set of
+platform-specific Python wheels, published to PyPI as **`codeanalyzer-typescript`**.
+
+The CLDK Python SDK depends on this package and calls `codeanalyzer_typescript.bin_path()`
+to locate the analyzer binary — the same way it imports `codeanalyzer-python` for the
+Python backend. The binary itself is built from this repo's `src/` with
+`bun build --compile`, so it is fully self-contained (no Node/Bun needed at runtime).
+
+## Why platform wheels?
+
+Unlike the Java backend (one cross-platform `.jar`), a `bun --compile` binary is
+platform-specific and large (~70 MB). So we ship **one wheel per OS/arch**, tagged
+`py3-none-<platform>` (the binary is Python-agnostic — no per-Python-version matrix),
+and let pip resolve the correct one at install time. There is intentionally no usable
+sdist: the binary cannot be built without Bun.
+
+## Building & publishing
+
+```bash
+python -m pip install build wheel hatchling twine
+./build_wheels.sh            # cross-compiles every target via Bun, emits ./dist/*.whl
+twine upload dist/*.whl
+```
+
+`build_wheels.sh` loops over the Bun targets, compiles each binary into
+`src/codeanalyzer_typescript/_bin/`, builds a pure wheel, and retags it to the platform.
+Bun cross-compiles all targets from a single host, so this does not need a CI runner
+matrix.
+
+## Versioning
+
+The released version comes from the **git tag**. A push of `vX.Y.Z` triggers the
+release workflow, which derives `X.Y.Z` from the tag, verifies it matches this
+repo's `package.json` `version` (failing fast on mismatch), and stamps it into
+`__init__.py` via `$PKG_VERSION` — hatch reads `__version__` as the wheel version
+(`pyproject.toml` declares `dynamic = ["version"]`). So the GitHub Release tag, the
+PyPI wheel version, and the npm `package.json` version are always in lockstep.
+
+To cut a release: bump `package.json` `version`, then push the matching tag, e.g.
+
+```bash
+npm version 0.2.0 --no-git-tag-version   # or edit package.json
+git commit -am "Release v0.2.0" && git tag v0.2.0 && git push --tags
+```
+
+For a **local** wheel build, override the fallback version explicitly:
+`PKG_VERSION=0.2.0 ./build_wheels.sh`.
+
+One thing still tracked by hand: the python-sdk pin — `[tool.backend-versions]
+codeanalyzer-typescript` and the `dependencies` entry
+`codeanalyzer-typescript==<version>` — must be bumped to consume a new release.
+
+## SDK integration
+
+In the python-sdk, `TSCodeanalyzer._get_codeanalyzer_exec()` resolves the binary in
+this order: `analysis_backend_path` → `$CODEANALYZER_TS_BIN` → **this package** →
+in-tree bundled `bin/`. Adding `codeanalyzer-typescript` to the SDK's `dependencies`
+makes the binary available automatically on install.

codeanalyzer_typescript-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+codeanalyzer_typescript/__init__.py,sha256=f2JzA_PPc4SU59_EDbYC1YktWFtEWnEwGuj_8ovQypY,1900
+codeanalyzer_typescript/_bin/.gitignore,sha256=_mZ_61eDWQ65V05VrmLP33rSeppQmwCwV8_qsgHUOHM,251
+codeanalyzer_typescript/_bin/codeanalyzer-typescript,sha256=XM4QAD0h_50LTHZzoOeuozdcFGasck94jdopJm_LY5k,82182224
+codeanalyzer_typescript-0.1.0.dist-info/METADATA,sha256=MzNfbhKNfb4KV85v8PGqbqauwA81aP5Emd4J_FUKL2w,3477
+codeanalyzer_typescript-0.1.0.dist-info/WHEEL,sha256=SJq-BPVeMh94RRAzlvEIJBbA0stBAC0qkxOhcE8kbKA,104
+codeanalyzer_typescript-0.1.0.dist-info/RECORD,,

codeanalyzer_typescript-0.1.0.dist-info/WHEEL

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