devmap 0.2.3__py3-none-any.whl → 0.2.5__py3-none-any.whl

devmap/__init__.py

@@ -1,27 +1,53 @@
-"""devmap — PyPI name-reservation shim.
+"""devmap — standalone CLI shipped via PyPI.
 
-The real devmap CLI is a TypeScript/Bun tool. This PyPI package exists only to
-reserve the ``devmap`` name and to point Python users at the canonical install:
+This package embeds the compiled devmap app (a self-contained JavaScript bundle,
+``_devmap.mjs``) and launches it with Node.js (or Bun) when you run ``devmap``.
+So ``pip install devmap && devmap`` works on its own — no separate npm/bun
+install required, as long as a JavaScript runtime is on PATH.
 
-    npm install -g devmap
-    bun install -g devmap
-
-Run ``devmap`` after installing either of the above. This shim just prints that
-guidance so a stray ``pip install devmap`` does not leave the user empty-handed.
+If you already manage devmap via ``npm i -g devmap`` / ``bun i -g devmap``,
+that install takes precedence on PATH and is equally valid.
 """
 
-__version__ = "0.2.3"
+import os
+import shutil
+import subprocess
+import sys
+
+__version__ = "0.2.5"
+
+_BUNDLE = os.path.join(os.path.dirname(os.path.abspath(__file__)), "_devmap.mjs")
+
+
+def _find_runtime() -> "str | None":
+    for name in ("node", "node.exe", "bun", "bun.exe"):
+        path = shutil.which(name)
+        if path:
+            return path
+    return None
 
 
 def main() -> None:
-    print("devmap — PyPI name-reservation shim (v" + __version__ + ")")
-    print()
-    print("The real devmap CLI is distributed via npm / bun, not PyPI:")
-    print("    npm install -g devmap")
-    print("    bun install -g devmap")
-    print()
-    print("After installing, run:  devmap   (the 'scan' word is optional)")
-    print("Source & docs: https://github.com/StevenLOL/devmap")
+    runtime = _find_runtime()
+    if runtime is None:
+        sys.stderr.write(
+            "devmap requires Node.js (or Bun) to run.\n"
+            "Install Node.js from https://nodejs.org (or Bun from https://bun.sh)\n"
+            "and make sure it is on your PATH, then re-run `devmap`.\n"
+        )
+        sys.exit(1)
+    if not os.path.exists(_BUNDLE):
+        sys.stderr.write(
+            f"devmap: bundled app not found at {_BUNDLE}.\n"
+            "Reinstall with `pip install --force-reinstall --no-cache-dir devmap`.\n"
+        )
+        sys.exit(1)
+    try:
+        proc = subprocess.run([runtime, _BUNDLE, *sys.argv[1:]])
+    except Exception as exc:  # pragma: no cover - defensive
+        sys.stderr.write(f"devmap: failed to launch runtime `{runtime}`: {exc}\n")
+        sys.exit(1)
+    sys.exit(proc.returncode)
 
 
 if __name__ == "__main__":