netra-core 0.1.0__py3-none-any.whl

netra_core/main.py

@@ -0,0 +1,82 @@
+"""
+Root CLI entry point and dynamic plugin router for the NetraBase ecosystem.
+"""
+
+import importlib.metadata
+from typing import Annotated
+
+import typer
+from rich.console import Console
+
+app = typer.Typer(
+    name="netra",
+    help="The NetraBase Data Reliability CLI.",
+    no_args_is_help=True,
+    add_completion=False,
+)
+console = Console()
+
+
+def _version_callback(value: bool) -> None:
+    """Prints the version of netra-core and all installed Netra plugins."""
+
+    if not value:
+        return
+
+    try:
+        core_version = importlib.metadata.version("netra-core")
+    except importlib.metadata.PackageNotFoundError:
+        core_version = "unknown"
+
+    console.print(f"[bold cyan]netra-core[/bold cyan]       : v{core_version}")
+
+    entry_points = sorted(
+        importlib.metadata.entry_points(group="netra.subcommands"),
+        key=lambda ep: ep.name,
+    )
+    for ep in entry_points:
+        dist_name = ep.dist.name if ep.dist else ep.name
+        dist_version = ep.dist.version if ep.dist else "unknown"
+        console.print(f"[bold white]{dist_name:<16}[/bold white]: v{dist_version} ({ep.name})")
+
+    raise typer.Exit(0)
+
+
+@app.callback()
+def main(
+    version: Annotated[
+        bool | None,
+        typer.Option(
+            "--version",
+            "-V",
+            "-v",
+            callback=_version_callback,
+            is_eager=True,
+            help="Show installed Netra package versions and exit.",
+        ),
+    ] = None,
+) -> None:
+    """Root callback for the Netra CLI."""
+
+
+def discover_plugins() -> None:
+    """Scans the Python environment for registered Netra subcommands."""
+
+    entry_points = sorted(
+        importlib.metadata.entry_points(group="netra.subcommands"),
+        key=lambda ep: ep.name,
+    )
+
+    for entry_point in entry_points:
+        try:
+            register_function = entry_point.load()
+            sub_app = register_function()
+            app.add_typer(sub_app, name=entry_point.name)
+        except Exception as e: # noqa: BLE001
+            console.print(f"[red]Failed to load plugin '{entry_point.name}': {e}[/red]")
+
+
+discover_plugins()
+
+if __name__ == "__main__":
+    app()

netra_core-0.1.0.dist-info/METADATA

@@ -0,0 +1,79 @@
+Metadata-Version: 2.5
+Name: netra-core
+Version: 0.1.0
+Summary: Core CLI router and plugin registry for the NetraBase data reliability ecosystem.
+Project-URL: Homepage, https://github.com/netrabase/netra-core
+Project-URL: Repository, https://github.com/netrabase/netra-core
+Project-URL: Issues, https://github.com/netrabase/netra-core/issues
+Author-email: Nitin Paul <nitinpaul.dev@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: cli,data-contracts,data-quality,netra,odcs
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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 :: Database
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: rich>=14.3.1
+Requires-Dist: typer>=0.24.0
+Description-Content-Type: text/markdown
+
+# Netra Core
+
+[![PyPI version](https://img.shields.io/pypi/v/netra-core.svg?color=blue)](https://pypi.org/project/netra-core/)
+
+**`netra-core`** is the lightweight CLI router and plugin registry for the **NetraBase** data reliability ecosystem.
+
+It provides the unified `netra` command-line entry point and dynamically discovers installed Netra packages via Python `importlib.metadata` entry points (`netra.subcommands`).
+
+## Ecosystem Packages
+
+| Package | CLI Subcommands | Description |
+| :--- | :--- | :--- |
+| **[`netra-profiler`](https://github.com/netrabase/netra-profiler)** | `netra profile`<br>`netra contract`<br>`netra diff` | High-performance statistical data profiler, ODCS v3.1.0 contract generator, and schema drift detector. |
+| **[`netra-validator`](https://github.com/netrabase/netra-validator)** | `netra validate` | High-performance data validator built with Polars and DuckDB. |
+
+## Installation
+
+Install the Netra tools you need (which automatically pulls in `netra-core`):
+
+```bash
+uv pip install netra-profiler netra-validator
+```
+
+Or with standard `pip`:
+
+```bash
+pip install netra-profiler netra-validator
+```
+
+## Usage
+
+Once installed, `netra` automatically routes subcommands to all installed Netra packages in your environment:
+
+```bash
+# View available subcommands
+netra --help
+
+# Check installed versions of netra-core and all registered plugins
+netra --version
+```
+
+Example output of `netra --version`:
+
+```text
+netra-core      : v0.1.0
+netra-profiler  : v0.5.0 (contract)
+netra-profiler  : v0.5.0 (diff)
+netra-profiler  : v0.5.0 (profile)
+netra-validator : v0.1.0 (validate)
+```

netra_core-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+netra_core/main.py,sha256=A07HW9oFNLnscHh3WG-CdyTKS-6bc7Fda_Y2UwpyQag,2155
+netra_core-0.1.0.dist-info/METADATA,sha256=rUjqsGLTwZPXEpAYaQggK9KTS3V8XJFQCmSWA9CnsYA,2811
+netra_core-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+netra_core-0.1.0.dist-info/entry_points.txt,sha256=-BJWW3DzaR7BSA7EqrwuBTQR7zw-uI0iqhTv-_Bw_3Q,46
+netra_core-0.1.0.dist-info/licenses/LICENSE,sha256=w5KOhiLMpKyXd_TNATwBCt3esKt2QyjdZ56Jr7WdZUw,1067
+netra_core-0.1.0.dist-info/RECORD,,

netra_core-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

netra_core-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+netra = netra_core.main:app

netra_core-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nitin Paul
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.