grafeo-cli 0.5.33__py3-none-win_amd64.whl

grafeo_cli/__init__.py

@@ -0,0 +1,89 @@
+"""Grafeo CLI launcher.
+
+Thin wrapper that finds and runs the grafeo binary bundled with this package.
+Install with: pip install grafeo-cli
+"""
+
+from __future__ import annotations
+
+import os
+import platform
+import subprocess
+import sys
+from pathlib import Path
+
+__version__ = "0.5.33"
+
+# GitHub release download URL template
+_GITHUB_RELEASE = "https://github.com/GrafeoDB/grafeo/releases/download"
+
+
+def _binary_name() -> str:
+    """Return the platform-specific binary name."""
+    return "grafeo.exe" if platform.system() == "Windows" else "grafeo"
+
+
+def _find_binary() -> Path | None:
+    """Find the grafeo binary.
+
+    Search order:
+    1. Bundled with this package (wheel data)
+    2. Adjacent to this package (development installs)
+    3. On PATH
+    """
+    binary = _binary_name()
+
+    # 1. Bundled in package directory
+    pkg_dir = Path(__file__).parent
+    bundled = pkg_dir / binary
+    if bundled.is_file():
+        return bundled
+
+    # 2. Adjacent to package (e.g., bin/ directory in virtualenv)
+    for bin_dir in [pkg_dir.parent / "bin", pkg_dir.parent / "Scripts"]:
+        candidate = bin_dir / binary
+        if candidate.is_file():
+            return candidate
+
+    # 3. On system PATH
+    from shutil import which
+
+    on_path = which("grafeo")
+    if on_path:
+        return Path(on_path)
+
+    return None
+
+
+def main() -> None:
+    """Run the grafeo CLI binary, forwarding all arguments."""
+    binary = _find_binary()
+
+    if binary is None:
+        print(
+            "error: grafeo binary not found.\n"
+            "\n"
+            "The grafeo-cli package is a thin launcher for the Grafeo CLI binary.\n"
+            "Install the binary via one of:\n"
+            f"  - Download from {_GITHUB_RELEASE}/v{__version__}/\n"
+            "  - cargo install grafeo-cli\n"
+            "  - Place the 'grafeo' binary on your PATH\n",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    # Make binary executable on Unix
+    if os.name != "nt":
+        binary.chmod(binary.stat().st_mode | 0o111)
+
+    try:
+        result = subprocess.run(
+            [str(binary), *sys.argv[1:]],
+            check=False,
+        )
+        sys.exit(result.returncode)
+    except KeyboardInterrupt:
+        sys.exit(130)
+    except FileNotFoundError:
+        print(f"error: failed to execute {binary}", file=sys.stderr)
+        sys.exit(1)

grafeo_cli/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running the CLI via `python -m grafeo_cli`."""
+
+from grafeo_cli import main
+
+main()

grafeo_cli-0.5.33.dist-info/METADATA

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: grafeo-cli
+Version: 0.5.33
+Summary: Command-line interface for Grafeo graph database
+Project-URL: Homepage, https://grafeo.dev
+Project-URL: Documentation, https://grafeo.dev/user-guide/cli
+Project-URL: Repository, https://github.com/GrafeoDB/grafeo
+Project-URL: Issues, https://github.com/GrafeoDB/grafeo/issues
+Author: S.T. Grond
+License: Apache-2.0
+Keywords: cli,database,gql,grafeo,graph
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Database
+Classifier: Topic :: Database :: Database Engines/Servers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# grafeo-cli
+
+Command-line interface for [Grafeo](https://grafeo.dev) graph database.
+
+This is a thin Python launcher package that runs the pre-built Grafeo CLI binary.
+
+## Installation
+
+```bash
+uv add grafeo-cli
+# or: pip install grafeo-cli
+```
+
+The package looks for the `grafeo` binary in this order:
+1. Bundled with the wheel (platform-specific wheels)
+2. In the virtualenv `bin/` or `Scripts/` directory
+3. On your system `PATH`
+
+If no binary is found, install it separately:
+
+```bash
+# Via cargo
+cargo install grafeo-cli
+
+# Or download from GitHub releases
+# https://github.com/GrafeoDB/grafeo/releases
+```
+
+## Usage
+
+```bash
+# Database management
+grafeo info ./my-db
+grafeo stats ./my-db
+grafeo validate ./my-db
+
+# Query execution
+grafeo query ./my-db "MATCH (n:Person) RETURN n.name"
+
+# Interactive shell
+grafeo shell ./my-db
+
+# Create a new database
+grafeo init ./new-db
+
+# Shell completions
+grafeo completions bash > ~/.local/share/bash-completion/completions/grafeo
+```
+
+## Links
+
+- [Documentation](https://grafeo.dev)
+- [GitHub](https://github.com/GrafeoDB/grafeo)
+- [Grafeo Python Library](https://pypi.org/project/grafeo/) (the database engine, not this CLI tool)
+
+## License
+
+Apache-2.0

grafeo_cli-0.5.33.dist-info/RECORD

@@ -0,0 +1,7 @@
+grafeo_cli/__init__.py,sha256=R5ZT1lAbvL3eTx6V4Wi9CyjR3GW1Q2njJpXVCFbEsd8,2353
+grafeo_cli/__main__.py,sha256=lKWNwlcnLVfML88xVqcXHMUB2aLvKi8umcnQsePM0ak,93
+grafeo_cli/grafeo.exe,sha256=fi-rqw_b7Y2FgwxcqumfTEGT5eYuNUXVyQA1Y2QjZ4E,10499072
+grafeo_cli-0.5.33.dist-info/METADATA,sha256=ATFiIpwFlx_rmO3arEw4s1_e1oGX8m9AYQrGvceOi6g,2047
+grafeo_cli-0.5.33.dist-info/WHEEL,sha256=fip2IBhkkNvH-S_Xh3PV94_XVqHJB1nn9gTAcldDBj4,94
+grafeo_cli-0.5.33.dist-info/entry_points.txt,sha256=KKaKkAJNnVWo-lVBSFAykz2_Lw2slApF2hLX9j9paEc,43
+grafeo_cli-0.5.33.dist-info/RECORD,,

grafeo_cli-0.5.33.dist-info/WHEEL

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

grafeo_cli-0.5.33.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+grafeo = grafeo_cli:main