grafeo-cli 0.5.33__tar.gz

grafeo_cli-0.5.33/.gitignore

@@ -0,0 +1,90 @@
+# ── OS ────────────────────────────────────────────────────────────────
+.DS_Store
+Thumbs.db
+Desktop.ini
+
+# ── IDE / Editor ──────────────────────────────────────────────────────
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# ── Environment ───────────────────────────────────────────────────────
+.env
+*.tmp.*
+
+# ── Rust / Cargo ──────────────────────────────────────────────────────
+debug
+target
+**/*.rs.bk
+*.pdb
+**/mutants.out*/
+
+# ── Python / Maturin ─────────────────────────────────────────────────
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.pyd
+*.egg-info/
+*.egg
+*.whl
+dist/
+build/
+.eggs/
+.venv/
+venv/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+
+# ── Node.js / napi-rs ────────────────────────────────────────────────
+node_modules/
+*.node
+package-lock.json
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+# ── Native library artifacts (copied for local testing) ──────────────
+grafeo_c.dll
+grafeo_c.dylib
+libgrafeo_c.so
+
+# ── WASM ──────────────────────────────────────────────────────────────
+pkg/
+pkg-lite/
+pkg-lpg/
+pkg-rdf/
+
+# ── C# / .NET ───────────────────────────────────────────────────────
+**/obj/
+**/bin/
+
+# ── Dart ─────────────────────────────────────────────────────────────
+.dart_tool/
+pubspec.lock
+
+# ── Go ───────────────────────────────────────────────────────────────
+go.sum
+
+# ── Coverage & profiling ─────────────────────────────────────────────
+.coverage
+htmlcov/
+coverage/
+*.profraw
+*.profdata
+lcov.info
+tarpaulin-report.html
+perf.data
+perf.data.old
+flamegraph.svg
+cargo-timing*.html
+
+# ── Benchmarks ────────────────────────────────────────────────────────
+.benchmarks
+
+# ── Documentation (auto-generated) ───────────────────────────────────
+docs/changelog.md
+site/
+.cache/

grafeo_cli-0.5.33/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,58 @@
+# 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/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-0.5.33/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/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "grafeo-cli"
+version = "0.5.33"
+description = "Command-line interface for Grafeo graph database"
+readme = "README.md"
+license = { text = "Apache-2.0"}
+requires-python = ">=3.9"
+authors = [
+    { name = "S.T. Grond" }
+]
+keywords = ["graph", "database", "gql", "cli", "grafeo"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Rust",
+    "Topic :: Database",
+    "Topic :: Database :: Database Engines/Servers",
+]
+
+[project.urls]
+Homepage = "https://grafeo.dev"
+Documentation = "https://grafeo.dev/user-guide/cli"
+Repository = "https://github.com/GrafeoDB/grafeo"
+Issues = "https://github.com/GrafeoDB/grafeo/issues"
+
+[project.scripts]
+grafeo = "grafeo_cli:main"
+
+[tool.hatch.build]
+# Include pre-built binaries even though they're not tracked by git
+artifacts = ["grafeo_cli/grafeo", "grafeo_cli/grafeo.exe"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["grafeo_cli"]