bindai-cli 0.1.7__tar.gz → 0.2.0__tar.gz

bindai_cli-0.2.0/PKG-INFO

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: bindai-cli
+Version: 0.2.0
+Summary: BindAI Command Line Interface
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.16
+Requires-Dist: rich>=14.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: bindai-config>=0.2.0
+Requires-Dist: bindai-connections[credentials]>=0.2.0
+
+# BindAI CLI
+
+`bindai-cli` provides the command-line interface for creating, inspecting, developing, and managing BindAI projects.
+
+The CLI is designed to provide a convenient developer workflow around the BindAI framework and its project structure.
+
+## Features
+
+The BindAI CLI provides commands for common development tasks, including:
+
+* Project creation
+* Project scaffolding
+* BindAI environment inspection
+* Framework diagnostics
+* Project creation
+* Development utilities
+* CLI-based project management
+
+## Installation
+
+The CLI is included as the `bindai-cli` package in the BindAI workspace.
+
+For development from the BindAI repository:
+
+```bash
+uv sync
+```
+
+The CLI can then be executed with:
+
+```bash
+uv run bindai
+```
+
+## Common Commands
+
+### Doctor
+
+Run BindAI diagnostics:
+
+```bash
+bindai doctor
+```
+
+This command is intended to help identify configuration or environment issues.
+
+### Inspect
+
+Inspect the current BindAI environment or project:
+
+```bash
+bindai inspect
+```
+
+### Create a Project
+
+Create a new BindAI project:
+
+```bash
+bindai new my-project
+```
+
+The generated project can then be developed independently while using the BindAI framework.
+
+## Project Scaffolding
+
+The CLI includes templates and scaffolding resources for creating BindAI projects.
+
+A typical workflow is:
+
+```text
+bindai new my-project
+        │
+        ▼
+   Project files
+        │
+        ▼
+   Configure project
+        │
+        ▼
+   Add agents / workflows
+        │
+        ▼
+      Develop
+```
+
+The package includes its CLI templates and scaffolding resources as package data so they can be distributed with the CLI.
+
+## Development
+
+`bindai-cli` is part of the BindAI workspace.
+
+From the repository root:
+
+```bash
+uv sync
+```
+
+Run the CLI:
+
+```bash
+uv run bindai
+```
+
+Run the complete test suite:
+
+```bash
+uv run pytest
+```
+
+Run static type checking:
+
+```bash
+uv run mypy packages/bindai-cli
+```
+
+Build the package:
+
+```bash
+uv build --package bindai-cli
+```
+
+## Package API
+
+The package currently exposes its version through:
+
+```python
+from bindai_cli import __version__
+
+print(__version__)
+```
+
+Current version:
+
+```text
+0.1.8
+```
+
+The primary public interface of this package is the command-line application rather than a large Python API.
+
+## Architecture
+
+The CLI sits at the developer-facing edge of the BindAI platform:
+
+```text
+Developer
+    │
+    ▼
+BindAI CLI
+    │
+    ├── Diagnostics
+    ├── Inspection
+    ├── Initialization
+    └── Project Scaffolding
+            │
+            ▼
+       BindAI Project
+            │
+      ┌─────┼─────┐
+      ▼     ▼     ▼
+   Agents Workflows Tools
+```
+
+This keeps command-line concerns separate from the core BindAI runtime and framework packages.
+
+## Documentation
+
+Full BindAI documentation is available at:
+
+https://docs.bindai.dev
+
+## License
+
+BindAI is released under the MIT License.

bindai_cli-0.2.0/README.md

@@ -0,0 +1,174 @@
+# BindAI CLI
+
+`bindai-cli` provides the command-line interface for creating, inspecting, developing, and managing BindAI projects.
+
+The CLI is designed to provide a convenient developer workflow around the BindAI framework and its project structure.
+
+## Features
+
+The BindAI CLI provides commands for common development tasks, including:
+
+* Project creation
+* Project scaffolding
+* BindAI environment inspection
+* Framework diagnostics
+* Project creation
+* Development utilities
+* CLI-based project management
+
+## Installation
+
+The CLI is included as the `bindai-cli` package in the BindAI workspace.
+
+For development from the BindAI repository:
+
+```bash
+uv sync
+```
+
+The CLI can then be executed with:
+
+```bash
+uv run bindai
+```
+
+## Common Commands
+
+### Doctor
+
+Run BindAI diagnostics:
+
+```bash
+bindai doctor
+```
+
+This command is intended to help identify configuration or environment issues.
+
+### Inspect
+
+Inspect the current BindAI environment or project:
+
+```bash
+bindai inspect
+```
+
+### Create a Project
+
+Create a new BindAI project:
+
+```bash
+bindai new my-project
+```
+
+The generated project can then be developed independently while using the BindAI framework.
+
+## Project Scaffolding
+
+The CLI includes templates and scaffolding resources for creating BindAI projects.
+
+A typical workflow is:
+
+```text
+bindai new my-project
+        │
+        ▼
+   Project files
+        │
+        ▼
+   Configure project
+        │
+        ▼
+   Add agents / workflows
+        │
+        ▼
+      Develop
+```
+
+The package includes its CLI templates and scaffolding resources as package data so they can be distributed with the CLI.
+
+## Development
+
+`bindai-cli` is part of the BindAI workspace.
+
+From the repository root:
+
+```bash
+uv sync
+```
+
+Run the CLI:
+
+```bash
+uv run bindai
+```
+
+Run the complete test suite:
+
+```bash
+uv run pytest
+```
+
+Run static type checking:
+
+```bash
+uv run mypy packages/bindai-cli
+```
+
+Build the package:
+
+```bash
+uv build --package bindai-cli
+```
+
+## Package API
+
+The package currently exposes its version through:
+
+```python
+from bindai_cli import __version__
+
+print(__version__)
+```
+
+Current version:
+
+```text
+0.1.8
+```
+
+The primary public interface of this package is the command-line application rather than a large Python API.
+
+## Architecture
+
+The CLI sits at the developer-facing edge of the BindAI platform:
+
+```text
+Developer
+    │
+    ▼
+BindAI CLI
+    │
+    ├── Diagnostics
+    ├── Inspection
+    ├── Initialization
+    └── Project Scaffolding
+            │
+            ▼
+       BindAI Project
+            │
+      ┌─────┼─────┐
+      ▼     ▼     ▼
+   Agents Workflows Tools
+```
+
+This keeps command-line concerns separate from the core BindAI runtime and framework packages.
+
+## Documentation
+
+Full BindAI documentation is available at:
+
+https://docs.bindai.dev
+
+## License
+
+BindAI is released under the MIT License.

{bindai_cli-0.1.7 → bindai_cli-0.2.0}/pyproject.toml

@@ -1,14 +1,16 @@
 [project]
 name = "bindai-cli"
-version = "0.1.7"
+version = "0.2.0"
 description = "BindAI Command Line Interface"
+readme = "README.md"
 requires-python = ">=3.11"
 
 dependencies = [
     "typer>=0.16",
     "rich>=14.0",
     "python-dotenv>=1.0",
-    "bindai-config>=0.1.2",
+    "bindai-config>=0.2.0",
+    "bindai-connections[credentials]>=0.2.0",
 ]
 
 [project.scripts]
@@ -26,4 +28,4 @@ bindai_cli = [
     "templates/*/template.json",
     "scaffolds/**/*",
     "scaffolds/**/.*",
-]
+]

bindai_cli-0.2.0/src/bindai_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.8"

{bindai_cli-0.1.7 → bindai_cli-0.2.0}/src/bindai_cli/__main__.py

@@ -1,7 +1,10 @@
+from bindai_providers import bootstrap
+
 from bindai_cli.app import app
 
 
 def main():
+    bootstrap()
     app()
 
 

{bindai_cli-0.1.7 → bindai_cli-0.2.0}/src/bindai_cli/app.py

@@ -1,8 +1,10 @@
 import typer
 
+from bindai_cli.commands.config import app as config_app
+from bindai_cli.commands.connections import app as connections_app
 from bindai_cli.commands.doctor import app as doctor_app
 from bindai_cli.commands.inspect import app as inspect_app
-from bindai_cli.commands.new import app as new_app
+from bindai_cli.commands.new import new
 from bindai_cli.commands.run import app as run_app
 from bindai_cli.commands.template import app as template_app
 from bindai_cli.commands.version import app as version_app
@@ -23,10 +25,9 @@ app.add_typer(
     name="doctor",
 )
 
-app.add_typer(
-    new_app,
+app.command(
     name="new",
-)
+)(new)
 
 app.add_typer(
     run_app,
@@ -47,3 +48,13 @@ app.add_typer(
     inspect_app,
     name="inspect",
 )
+
+app.add_typer(
+    config_app,
+    name="config",
+)
+
+app.add_typer(
+    connections_app,
+    name="connections",
+)

bindai_cli-0.2.0/src/bindai_cli/commands/config.py

@@ -0,0 +1,204 @@
+from __future__ import annotations
+
+from dataclasses import fields
+from pathlib import Path
+from typing import Any, get_args, get_type_hints
+
+import typer
+from bindai_config import ProjectConfig, ProjectRuntime, TomlWriter
+from rich.console import Console
+from rich.table import Table
+
+app = typer.Typer(
+    help="Inspect and modify BindAI project configuration.",
+    no_args_is_help=True,
+)
+
+console = Console()
+
+
+@app.command(name="list")
+def list_config() -> None:
+    """
+    List effective project configuration and its source.
+    """
+    runtime = ProjectRuntime(Path.cwd())
+    values = runtime.resolver.all()
+
+    table = Table(title="Configuration")
+    table.add_column("Name", style="cyan")
+    table.add_column("Value")
+    table.add_column("Source")
+
+    for name, config_value in values.items():
+        table.add_row(
+            name,
+            str(config_value.value),
+            config_value.source,
+        )
+
+    console.print(table)
+
+
+@app.command(name="get")
+def get_config(
+    name: str = typer.Argument(
+        ...,
+        help="Configuration field to inspect.",
+    ),
+) -> None:
+    """
+    Show one effective configuration value and its source.
+    """
+    runtime = ProjectRuntime(Path.cwd())
+
+    try:
+        config_value = runtime.resolver.resolve(name)
+    except KeyError as exc:
+        raise typer.BadParameter(
+            f'Unknown configuration field "{name}".',
+        ) from exc
+
+    console.print(f"{name} = {config_value.value}")
+    console.print(f"source = {config_value.source}")
+
+
+@app.command(name="set")
+def set_config(
+    name: str = typer.Argument(
+        ...,
+        help="Configuration field to update.",
+    ),
+    value: str = typer.Argument(
+        ...,
+        help="Value to persist in bindai.toml.",
+    ),
+) -> None:
+    """
+    Set one project configuration value in bindai.toml.
+    """
+    config_path = Path.cwd() / "bindai.toml"
+
+    if not config_path.exists():
+        raise typer.BadParameter(
+            f'No bindai.toml found in "{Path.cwd()}".',
+        )
+
+    try:
+        expected_type = _field_type(name)
+        converted_value = _convert_value(
+            name,
+            value,
+            expected_type,
+        )
+    except KeyError as exc:
+        raise typer.BadParameter(str(exc).strip("'")) from exc
+    except ValueError as exc:
+        raise typer.BadParameter(str(exc)) from exc
+
+    try:
+        TomlWriter().set(
+            config_path,
+            name,
+            converted_value,
+        )
+    except (TypeError, ValueError) as exc:
+        raise typer.BadParameter(str(exc)) from exc
+
+    console.print(
+        f'Set {name} = {converted_value!r} in {config_path.name}.',
+    )
+
+
+@app.command(name="path")
+def config_path() -> None:
+    """
+    Show the path to the active bindai.toml file.
+    """
+    config_path = Path.cwd() / "bindai.toml"
+
+    if not config_path.exists():
+        raise typer.BadParameter(
+            f'No bindai.toml found in "{Path.cwd()}".',
+        )
+
+    console.print(config_path.resolve())
+
+
+def _field_type(name: str) -> Any:
+    config_fields = {
+        field.name: field
+        for field in fields(ProjectConfig)
+    }
+
+    if name not in config_fields:
+        raise KeyError(
+            f'Unknown configuration field "{name}".'
+        )
+
+    return get_type_hints(ProjectConfig)[name]
+
+
+def _convert_value(
+    name: str,
+    value: str,
+    expected_type: Any,
+) -> Any:
+    expected_types = get_args(expected_type)
+
+    if expected_types:
+        non_none_types = tuple(
+            item
+            for item in expected_types
+            if item is not type(None)
+        )
+
+        if len(non_none_types) == 1:
+            return _convert_value(
+                name,
+                value,
+                non_none_types[0],
+            )
+
+        raise ValueError(
+            f'Unsupported configuration type for "{name}".',
+        )
+
+    if expected_type is str:
+        return value
+
+    if expected_type is int:
+        try:
+            return int(value)
+        except ValueError as exc:
+            raise ValueError(
+                f'Invalid value for "{name}": '
+                f'expected an integer, got "{value}".',
+            ) from exc
+
+    if expected_type is float:
+        try:
+            return float(value)
+        except ValueError as exc:
+            raise ValueError(
+                f'Invalid value for "{name}": '
+                f'expected a number, got "{value}".',
+            ) from exc
+
+    if expected_type is bool:
+        normalized = value.strip().lower()
+
+        if normalized in {"1", "true", "yes", "on"}:
+            return True
+
+        if normalized in {"0", "false", "no", "off"}:
+            return False
+
+        raise ValueError(
+            f'Invalid value for "{name}": '
+            f'expected a boolean, got "{value}".',
+        )
+
+    raise ValueError(
+        f'Unsupported configuration type for "{name}".',
+    )