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

{bindai_cli-0.1.8 → bindai_cli-0.2.0}/PKG-INFO

@@ -1,13 +1,14 @@
 Metadata-Version: 2.4
 Name: bindai-cli
-Version: 0.1.8
+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.1.2
+Requires-Dist: bindai-config>=0.2.0
+Requires-Dist: bindai-connections[credentials]>=0.2.0
 
 # BindAI CLI
 
@@ -19,7 +20,7 @@ The CLI is designed to provide a convenient developer workflow around the BindAI
 
 The BindAI CLI provides commands for common development tasks, including:
 
-* Project initialization
+* Project creation
 * Project scaffolding
 * BindAI environment inspection
 * Framework diagnostics
@@ -63,14 +64,6 @@ Inspect the current BindAI environment or project:
 bindai inspect
 ```
 
-### Initialize
-
-Initialize a BindAI project:
-
-```bash
-bindai init
-```
-
 ### Create a Project
 
 Create a new BindAI project:

{bindai_cli-0.1.8 → bindai_cli-0.2.0}/README.md

@@ -8,7 +8,7 @@ The CLI is designed to provide a convenient developer workflow around the BindAI
 
 The BindAI CLI provides commands for common development tasks, including:
 
-* Project initialization
+* Project creation
 * Project scaffolding
 * BindAI environment inspection
 * Framework diagnostics
@@ -52,14 +52,6 @@ Inspect the current BindAI environment or project:
 bindai inspect
 ```
 
-### Initialize
-
-Initialize a BindAI project:
-
-```bash
-bindai init
-```
-
 ### Create a Project
 
 Create a new BindAI project:

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

@@ -1,6 +1,6 @@
 [project]
 name = "bindai-cli"
-version = "0.1.8"
+version = "0.2.0"
 description = "BindAI Command Line Interface"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -9,7 +9,8 @@ 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]
@@ -27,4 +28,4 @@ bindai_cli = [
     "templates/*/template.json",
     "scaffolds/**/*",
     "scaffolds/**/.*",
-]
+]

{bindai_cli-0.1.8 → 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}".',
+    )

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

@@ -0,0 +1,144 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+import typer
+from bindai_config import get_provider_connection
+from bindai_connections import (
+    ConnectionManifest,
+    KeyringProviderCredentialStore,
+)
+from rich.console import Console
+from rich.table import Table
+
+app = typer.Typer(
+    help="Manage provider connections.",
+    no_args_is_help=True,
+)
+
+console = Console()
+
+
+@app.command(name="add")
+def add_connection(
+    provider: str = typer.Argument(
+        ...,
+        help="Provider to connect.",
+    ),
+    name: str | None = typer.Option(
+        None,
+        "--name",
+        help="Connection name. Defaults to the provider name.",
+    ),
+) -> None:
+    """
+    Store a connection credential and register its non-secret metadata.
+    """
+    provider_name = provider.strip().lower()
+
+    try:
+        get_provider_connection(provider_name)
+    except KeyError as exc:
+        raise typer.BadParameter(
+            str(exc).strip("'"),
+        ) from exc
+
+    connection_name = (
+        name.strip().lower()
+        if name is not None
+        else provider_name
+    )
+
+    if not connection_name:
+        raise typer.BadParameter(
+            "Connection name cannot be empty.",
+        )
+
+    credential = typer.prompt(
+        "Credential",
+        hide_input=True,
+    )
+
+    store = KeyringProviderCredentialStore()
+    manifest = ConnectionManifest(
+        Path.cwd() / ".bindai" / "connections.toml",
+    )
+
+    store.set(
+        connection_name,
+        credential,
+    )
+
+    manifest.add(
+        connection_name,
+        provider_name,
+    )
+
+    console.print(
+        f'Connection "{connection_name}" added for provider '
+        f'"{provider_name}".',
+    )
+
+
+@app.command(name="list")
+def list_connections() -> None:
+    """
+    List configured provider connections and credential status.
+    """
+    manifest = ConnectionManifest(
+        Path.cwd() / ".bindai" / "connections.toml",
+    )
+    store = KeyringProviderCredentialStore()
+
+    connections = manifest.list()
+
+    table = Table(title="BindAI Connections")
+
+    table.add_column("Name", style="cyan")
+    table.add_column("Provider")
+    table.add_column("Credential")
+
+    for connection in connections:
+        credential_status = (
+            "Configured"
+            if store.exists(connection.name)
+            else "Missing"
+        )
+
+        table.add_row(
+            connection.name,
+            connection.provider,
+            credential_status,
+        )
+
+    console.print(table)
+
+
+@app.command(name="remove")
+def remove_connection(
+    name: str = typer.Argument(
+        ...,
+        help="Connection name to remove.",
+    ),
+) -> None:
+    """
+    Remove a named provider connection and its stored credential.
+    """
+    manifest = ConnectionManifest(
+        Path.cwd() / ".bindai" / "connections.toml",
+    )
+    store = KeyringProviderCredentialStore()
+
+    connection = manifest.get(name)
+
+    if connection is None:
+        raise typer.BadParameter(
+            f'Connection "{name}" not found.',
+        )
+
+    store.delete(connection.name)
+    manifest.remove(connection.name)
+
+    console.print(
+        f'Connection "{connection.name}" removed.',
+    )

{bindai_cli-0.1.8 → bindai_cli-0.2.0}/src/bindai_cli/commands/doctor.py

@@ -3,8 +3,13 @@ from __future__ import annotations
 import os
 import platform
 import sys
+from pathlib import Path
 
 import typer
+from bindai_connections import (
+    ConnectionManifest,
+    KeyringProviderCredentialStore,
+)
 from dotenv import load_dotenv
 from rich.console import Console
 from rich.table import Table
@@ -64,6 +69,11 @@ def doctor() -> None:
         table.add_row("Default Provider", config.provider)
 
         table.add_row("Default Model", config.model)
+
+        _add_connection_checks(
+            table,
+            config.connection,
+        )
     else:
         table.add_row(
             "Configuration",
@@ -120,3 +130,46 @@ def doctor() -> None:
     )
 
     console.print(table)
+
+
+def _add_connection_checks(
+    table: Table,
+    connection_name: str | None,
+) -> None:
+    if connection_name is None:
+        table.add_row(
+            "Connection",
+            "Not configured",
+        )
+        return
+
+    table.add_row(
+        "Connection",
+        connection_name,
+    )
+
+    manifest = ConnectionManifest(
+        Path.cwd() / ".bindai" / "connections.toml",
+    )
+
+    connection = manifest.get(connection_name)
+
+    if connection is None:
+        table.add_row(
+            "Connection Credential",
+            "Connection not configured",
+        )
+        return
+
+    store = KeyringProviderCredentialStore()
+
+    if store.exists(connection.name):
+        table.add_row(
+            "Connection Credential",
+            "Configured",
+        )
+    else:
+        table.add_row(
+            "Connection Credential",
+            "Missing",
+        )

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

@@ -0,0 +1,116 @@
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+import typer
+from rich.console import Console
+
+from bindai_cli.utils.scaffold import copy_scaffold
+
+console = Console()
+
+
+def _venv_python(root: Path) -> Path:
+    bin_dir = "Scripts" if os.name == "nt" else "bin"
+    return root / ".venv" / bin_dir / "python"
+
+
+def _activation_command() -> str:
+    if os.name == "nt":
+        return ".venv\\Scripts\\activate"
+    return "source .venv/bin/activate"
+
+
+def new(
+    name: str,
+    install: bool = typer.Option(
+        False,
+        "--install",
+        help="Install dependencies.",
+    ),
+) -> None:
+    """
+    Create a new BindAI project.
+    """
+
+    root = Path(name)
+
+    if root.exists():
+        console.print(f"[red]Project '{name}' already exists.[/red]")
+        raise typer.Exit(1)
+
+    scaffold = Path(__file__).parent.parent / "scaffolds" / "basic"
+
+    copy_scaffold(
+        scaffold,
+        root,
+    )
+
+    console.print("[cyan]Creating virtual environment...[/cyan]")
+
+    try:
+        subprocess.run(
+            [
+                sys.executable,
+                "-m",
+                "venv",
+                str(root / ".venv"),
+            ],
+            check=True,
+        )
+    except subprocess.CalledProcessError as exc:
+        console.print(
+            "[red]Failed to create the virtual environment.[/red]"
+        )
+        console.print(
+            f"Project '{name}' was created, but setup is incomplete."
+        )
+        console.print(f"Command exited with status {exc.returncode}.")
+        raise typer.Exit(1) from exc
+
+    print()
+
+    if install:
+        console.print("[cyan]Installing dependencies...[/cyan]")
+
+        try:
+            subprocess.run(
+                [
+                    str(_venv_python(root)),
+                    "-m",
+                    "pip",
+                    "install",
+                    "-r",
+                    str(root / "requirements.txt"),
+                ],
+                check=True,
+            )
+        except subprocess.CalledProcessError as exc:
+            console.print(
+                "[red]Failed to install project dependencies.[/red]"
+            )
+            console.print(
+                f"Project '{name}' was created, but setup is incomplete."
+            )
+            console.print(f"Command exited with status {exc.returncode}.")
+            raise typer.Exit(1) from exc
+
+        print()
+
+    console.print(
+        f"[green]✓ Project '{name}' created successfully.[/green]"
+    )
+
+    print()
+
+    console.print("[bold]Next steps:[/bold]")
+
+    console.print(f"  cd {name}")
+    console.print(f"  {_activation_command()}")
+
+    if not install:
+        console.print("  pip install -r requirements.txt")
+
+    console.print("  bindai doctor")
+    console.print("  python main.py")

bindai_cli-0.2.0/src/bindai_cli/scaffolds/basic/requirements.txt

@@ -0,0 +1 @@
+bindai[openai]>=0.1.6

{bindai_cli-0.1.8 → bindai_cli-0.2.0}/src/bindai_cli.egg-info/PKG-INFO

@@ -1,13 +1,14 @@
 Metadata-Version: 2.4
 Name: bindai-cli
-Version: 0.1.8
+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.1.2
+Requires-Dist: bindai-config>=0.2.0
+Requires-Dist: bindai-connections[credentials]>=0.2.0
 
 # BindAI CLI
 
@@ -19,7 +20,7 @@ The CLI is designed to provide a convenient developer workflow around the BindAI
 
 The BindAI CLI provides commands for common development tasks, including:
 
-* Project initialization
+* Project creation
 * Project scaffolding
 * BindAI environment inspection
 * Framework diagnostics
@@ -63,14 +64,6 @@ Inspect the current BindAI environment or project:
 bindai inspect
 ```
 
-### Initialize
-
-Initialize a BindAI project:
-
-```bash
-bindai init
-```
-
 ### Create a Project
 
 Create a new BindAI project: