orchestra-cli 0.2.0__tar.gz → 0.3.0__tar.gz

{orchestra_cli-0.2.0 → orchestra_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orchestra-cli
-Version: 0.2.0
+Version: 0.3.0
 Summary: Orchestra CLI. Perform operations with Orchestra locally.
 Author-email: Orchestra Technologies <support@getorchestra.io>
 Requires-Python: >=3.10
@@ -31,15 +31,17 @@ pipx install orchestra-cli
 
 ## Environment variables
 
-- `ORCHESTRA_API_KEY`: Required for actions that call the API (`import`, `run`).
+- `ORCHESTRA_API_KEY`: Required for actions that call the API (`import`, `create-pipeline`, `update-pipeline`, `delete-pipeline`, `run`).
 - `BASE_URL`: Optional. Override the default Orchestra host (`https://app.getorchestra.io`) for non‑production/testing.
 
 ## Commands overview
 
 - `validate`: Validate a pipeline YAML locally against the Orchestra API schema.
 - `import`: Register a pipeline YAML (from a git repo) with Orchestra under an alias.
+- `fetch-pipelines`: Fetch the pipelines visible to the current API key as JSON.
 - `create-pipeline`: Create an Orchestra-backed pipeline from a local YAML file.
 - `update-pipeline`: Update an existing Orchestra-backed pipeline from a local YAML file.
+- `delete-pipeline`: Delete an existing pipeline by alias.
 - `run`: Start a pipeline run by alias, optionally pinning branch/commit and waiting for completion.
 
 Use `orchestra --help` or `orchestra <command> --help` for built-in help.
@@ -149,6 +151,24 @@ Behavior
 
 ---
 
+## fetch-pipelines
+
+Fetch the pipelines available to the current Orchestra API key.
+
+```bash
+export ORCHESTRA_API_KEY=...
+
+orchestra fetch-pipelines
+```
+
+Behavior
+
+- Sends `GET /api/engine/public/pipelines`. Responses always include each pipeline's latest run metadata.
+- Prints the response payload as pretty JSON for scripting and inspection.
+- Exit codes: `0` on success, `1` on failure.
+
+---
+
 ## update-pipeline
 
 Update an existing Orchestra-backed pipeline from a local YAML file.
@@ -178,6 +198,29 @@ Behavior
 
 ---
 
+## delete-pipeline
+
+Delete a pipeline by alias.
+
+```bash
+export ORCHESTRA_API_KEY=...
+
+orchestra delete-pipeline --alias my-pipeline
+```
+
+Options
+
+- `-a, --alias` (required): Pipeline alias to delete.
+
+Behavior
+
+- Sends `DELETE /pipelines/{alias}` with API key authentication.
+- Deletes the pipeline resolved by alias within the authenticated account.
+- On success, exits with code `0` after printing a confirmation message.
+- Exit codes: `0` on success, `1` on failure.
+
+---
+
 ## run
 
 Start a pipeline run by alias. Optionally specify a branch and/or commit. By default, the command waits and polls the run status until completion.

{orchestra_cli-0.2.0 → orchestra_cli-0.3.0}/README.md

@@ -20,15 +20,17 @@ pipx install orchestra-cli
 
 ## Environment variables
 
-- `ORCHESTRA_API_KEY`: Required for actions that call the API (`import`, `run`).
+- `ORCHESTRA_API_KEY`: Required for actions that call the API (`import`, `create-pipeline`, `update-pipeline`, `delete-pipeline`, `run`).
 - `BASE_URL`: Optional. Override the default Orchestra host (`https://app.getorchestra.io`) for non‑production/testing.
 
 ## Commands overview
 
 - `validate`: Validate a pipeline YAML locally against the Orchestra API schema.
 - `import`: Register a pipeline YAML (from a git repo) with Orchestra under an alias.
+- `fetch-pipelines`: Fetch the pipelines visible to the current API key as JSON.
 - `create-pipeline`: Create an Orchestra-backed pipeline from a local YAML file.
 - `update-pipeline`: Update an existing Orchestra-backed pipeline from a local YAML file.
+- `delete-pipeline`: Delete an existing pipeline by alias.
 - `run`: Start a pipeline run by alias, optionally pinning branch/commit and waiting for completion.
 
 Use `orchestra --help` or `orchestra <command> --help` for built-in help.
@@ -138,6 +140,24 @@ Behavior
 
 ---
 
+## fetch-pipelines
+
+Fetch the pipelines available to the current Orchestra API key.
+
+```bash
+export ORCHESTRA_API_KEY=...
+
+orchestra fetch-pipelines
+```
+
+Behavior
+
+- Sends `GET /api/engine/public/pipelines`. Responses always include each pipeline's latest run metadata.
+- Prints the response payload as pretty JSON for scripting and inspection.
+- Exit codes: `0` on success, `1` on failure.
+
+---
+
 ## update-pipeline
 
 Update an existing Orchestra-backed pipeline from a local YAML file.
@@ -167,6 +187,29 @@ Behavior
 
 ---
 
+## delete-pipeline
+
+Delete a pipeline by alias.
+
+```bash
+export ORCHESTRA_API_KEY=...
+
+orchestra delete-pipeline --alias my-pipeline
+```
+
+Options
+
+- `-a, --alias` (required): Pipeline alias to delete.
+
+Behavior
+
+- Sends `DELETE /pipelines/{alias}` with API key authentication.
+- Deletes the pipeline resolved by alias within the authenticated account.
+- On success, exits with code `0` after printing a confirmation message.
+- Exit codes: `0` on success, `1` on failure.
+
+---
+
 ## run
 
 Start a pipeline run by alias. Optionally specify a branch and/or commit. By default, the command waits and polls the run status until completion.

{orchestra_cli-0.2.0 → orchestra_cli-0.3.0}/orchestra_cli/src/cli.py

@@ -1,6 +1,8 @@
 import typer
 
 from .create_pipeline import create_pipeline
+from .delete_pipeline import delete_pipeline
+from .fetch_pipelines import fetch_pipelines
 from .import_pipeline import import_pipeline
 from .run_pipeline import run_pipeline
 from .update_pipeline import update_pipeline
@@ -12,5 +14,7 @@ app = typer.Typer(help="Orchestra CLI – perform operations with Orchestra loca
 app.command(name="validate")(validate)
 app.command(name="import")(import_pipeline)
 app.command(name="run")(run_pipeline)
+app.command(name="fetch-pipelines")(fetch_pipelines)
 app.command(name="create-pipeline")(create_pipeline)
 app.command(name="update-pipeline")(update_pipeline)
+app.command(name="delete-pipeline")(delete_pipeline)

orchestra_cli-0.3.0/orchestra_cli/src/delete_pipeline.py

@@ -0,0 +1,39 @@
+import json
+
+import httpx
+import typer
+
+from ..utils.constants import get_delete_pipeline_url
+from ..utils.styling import green, indent_message, red, yellow
+from .pipeline_upsert import require_api_key
+
+
+def delete_pipeline(
+    alias: str = typer.Option(..., "--alias", "-a", help="Pipeline alias"),
+):
+    """
+    Delete a pipeline by alias.
+    """
+    api_key = require_api_key()
+
+    try:
+        response = httpx.delete(
+            get_delete_pipeline_url(alias),
+            timeout=30,
+            headers={"Authorization": f"Bearer {api_key}"},
+        )
+    except Exception as e:
+        typer.echo(red(f"HTTP request failed: {e}"))
+        raise typer.Exit(code=1)
+
+    if response.status_code == 204:
+        typer.echo(green(f"✅ Pipeline '{alias}' deleted successfully"))
+        raise typer.Exit(code=0)
+
+    typer.echo(red(f"❌ Delete failed with status {response.status_code}"))
+    try:
+        typer.echo(yellow(indent_message(json.dumps(response.json(), indent=2))))
+    except Exception:
+        if response.text:
+            typer.echo(yellow(indent_message(response.text)))
+    raise typer.Exit(code=1)

orchestra_cli-0.3.0/orchestra_cli/src/fetch_pipelines.py

@@ -0,0 +1,45 @@
+import json
+
+import httpx
+import typer
+
+from ..utils.constants import get_api_url
+from ..utils.styling import indent_message, red, yellow
+from .pipeline_upsert import require_api_key
+
+
+def fetch_pipelines():
+    """
+    Fetch pipelines available to the current Orchestra API key.
+
+    The API always includes each pipeline's latest run metadata.
+    """
+    api_key = require_api_key()
+
+    try:
+        response = httpx.get(
+            get_api_url(""),
+            timeout=30,
+            headers={"Authorization": f"Bearer {api_key}"},
+        )
+    except Exception as e:
+        typer.echo(red(f"HTTP request failed: {e}"))
+        raise typer.Exit(code=1)
+
+    if response.status_code == 200:
+        try:
+            pipelines = response.json()
+        except Exception:
+            typer.echo(red("❌ Fetch pipelines failed: success response was not valid JSON"))
+            typer.echo(yellow(indent_message(response.text)))
+            raise typer.Exit(code=1)
+
+        typer.echo(json.dumps(pipelines, indent=2))
+        raise typer.Exit(code=0)
+
+    typer.echo(red(f"❌ Fetch pipelines failed with status {response.status_code}"))
+    try:
+        typer.echo(yellow(indent_message(json.dumps(response.json(), indent=2))))
+    except Exception:
+        typer.echo(yellow(indent_message(response.text)))
+    raise typer.Exit(code=1)

{orchestra_cli-0.2.0 → orchestra_cli-0.3.0}/orchestra_cli/tests/test_cli.py

@@ -10,5 +10,7 @@ def test_help():
     assert result.exit_code == 0
     assert "Orchestra CLI" in result.output
     assert "validate" in result.output
+    assert "fetch-pipelines" in result.output
     assert "create-pipeline" in result.output
+    assert "delete-pipeline" in result.output
     assert "update-pipeline" in result.output

orchestra_cli-0.3.0/orchestra_cli/tests/test_delete_pipeline.py

@@ -0,0 +1,82 @@
+import httpx
+import pytest
+from pytest_httpx import HTTPXMock
+from typer.testing import CliRunner
+
+from orchestra_cli.src.cli import app
+
+runner = CliRunner()
+mock_api_key = "fake-key"
+
+
+@pytest.fixture(autouse=True)
+def mock_env(monkeypatch):
+    monkeypatch.setenv("ORCHESTRA_API_KEY", mock_api_key)
+    monkeypatch.setenv("BASE_URL", "")
+
+
+def test_delete_success(httpx_mock: HTTPXMock):
+    alias = "demo"
+    httpx_mock.add_response(
+        method="DELETE",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/demo",
+        match_headers={"Authorization": f"Bearer {mock_api_key}"},
+        status_code=204,
+    )
+
+    result = runner.invoke(app, ["delete-pipeline", "--alias", alias])
+
+    assert result.exit_code == 0
+    assert "deleted successfully" in result.output
+
+
+def test_delete_uuid_like_alias_uses_alias_path(httpx_mock: HTTPXMock):
+    alias = "798d7121-6809-4148-aecb-26740cfabdf1"
+    httpx_mock.add_response(
+        method="DELETE",
+        url=f"https://app.getorchestra.io/api/engine/public/pipelines/{alias}",
+        match_headers={"Authorization": f"Bearer {mock_api_key}"},
+        status_code=204,
+    )
+
+    result = runner.invoke(app, ["delete-pipeline", "--alias", alias])
+
+    assert result.exit_code == 0
+    assert "deleted successfully" in result.output
+
+
+def test_delete_missing_api_key(monkeypatch):
+    monkeypatch.delenv("ORCHESTRA_API_KEY", raising=False)
+
+    result = runner.invoke(app, ["delete-pipeline", "--alias", "demo"])
+
+    assert result.exit_code == 1
+    assert "ORCHESTRA_API_KEY is not set" in result.output
+
+
+def test_delete_http_request_failure(monkeypatch):
+    def raise_timeout(*args, **kwargs):  # noqa: ARG001
+        raise httpx.TimeoutException("timed out")
+
+    monkeypatch.setattr(httpx, "delete", raise_timeout)
+
+    result = runner.invoke(app, ["delete-pipeline", "--alias", "demo"])
+
+    assert result.exit_code == 1
+    assert "HTTP request failed" in result.output
+
+
+def test_delete_api_error(httpx_mock: HTTPXMock):
+    httpx_mock.add_response(
+        method="DELETE",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/demo",
+        match_headers={"Authorization": f"Bearer {mock_api_key}"},
+        json={"detail": "Pipeline not found"},
+        status_code=404,
+    )
+
+    result = runner.invoke(app, ["delete-pipeline", "--alias", "demo"])
+
+    assert result.exit_code == 1
+    assert "Delete failed with status 404" in result.output
+    assert "Pipeline not found" in result.output

orchestra_cli-0.3.0/orchestra_cli/tests/test_fetch_pipelines.py

@@ -0,0 +1,78 @@
+import json
+
+import pytest
+from pytest_httpx import HTTPXMock
+from typer.testing import CliRunner
+
+from orchestra_cli.src.cli import app
+
+runner = CliRunner()
+
+
+@pytest.fixture(autouse=True)
+def mock_env(monkeypatch):
+    monkeypatch.setenv("ORCHESTRA_API_KEY", "fake-key")
+    monkeypatch.setenv("BASE_URL", "")
+
+
+def test_fetch_pipelines_success(httpx_mock: HTTPXMock):
+    pipelines = [
+        {
+            "id": "pipe-1",
+            "alias": "demo",
+            "name": "Demo pipeline",
+            "latestRunStatus": "SUCCEEDED",
+        },
+    ]
+    httpx_mock.add_response(
+        method="GET",
+        url="https://app.getorchestra.io/api/engine/public/pipelines",
+        json=pipelines,
+        status_code=200,
+        match_headers={"Authorization": "Bearer fake-key"},
+    )
+
+    result = runner.invoke(app, ["fetch-pipelines"])
+
+    assert result.exit_code == 0
+    assert result.output == f"{json.dumps(pipelines, indent=2)}\n"
+
+
+def test_fetch_pipelines_missing_api_key(monkeypatch):
+    monkeypatch.delenv("ORCHESTRA_API_KEY", raising=False)
+
+    result = runner.invoke(app, ["fetch-pipelines"])
+
+    assert result.exit_code == 1
+    assert "ORCHESTRA_API_KEY is not set" in result.output
+
+
+def test_fetch_pipelines_api_error(httpx_mock: HTTPXMock):
+    httpx_mock.add_response(
+        method="GET",
+        url="https://app.getorchestra.io/api/engine/public/pipelines",
+        json={"detail": "Forbidden"},
+        status_code=403,
+        match_headers={"Authorization": "Bearer fake-key"},
+    )
+
+    result = runner.invoke(app, ["fetch-pipelines"])
+
+    assert result.exit_code == 1
+    assert "Fetch pipelines failed with status 403" in result.output
+    assert "Forbidden" in result.output
+
+
+def test_fetch_pipelines_invalid_success_json(httpx_mock: HTTPXMock):
+    httpx_mock.add_response(
+        method="GET",
+        url="https://app.getorchestra.io/api/engine/public/pipelines",
+        text="ok",
+        status_code=200,
+        match_headers={"Authorization": "Bearer fake-key"},
+    )
+
+    result = runner.invoke(app, ["fetch-pipelines"])
+
+    assert result.exit_code == 1
+    assert "success response was not valid JSON" in result.output

{orchestra_cli-0.2.0 → orchestra_cli-0.3.0}/orchestra_cli/utils/constants.py

@@ -24,5 +24,9 @@ def get_update_pipeline_url(alias: str) -> str:
     return get_api_url(alias)
 
 
+def get_delete_pipeline_url(alias: str) -> str:
+    return get_api_url(alias)
+
+
 def get_pipeline_edit_url(pipeline_id: str) -> str:
     return f"{get_base_url()}/pipelines/{pipeline_id}/edit"

{orchestra_cli-0.2.0 → orchestra_cli-0.3.0}/orchestra_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orchestra-cli
-Version: 0.2.0
+Version: 0.3.0
 Summary: Orchestra CLI. Perform operations with Orchestra locally.
 Author-email: Orchestra Technologies <support@getorchestra.io>
 Requires-Python: >=3.10
@@ -31,15 +31,17 @@ pipx install orchestra-cli
 
 ## Environment variables
 
-- `ORCHESTRA_API_KEY`: Required for actions that call the API (`import`, `run`).
+- `ORCHESTRA_API_KEY`: Required for actions that call the API (`import`, `create-pipeline`, `update-pipeline`, `delete-pipeline`, `run`).
 - `BASE_URL`: Optional. Override the default Orchestra host (`https://app.getorchestra.io`) for non‑production/testing.
 
 ## Commands overview
 
 - `validate`: Validate a pipeline YAML locally against the Orchestra API schema.
 - `import`: Register a pipeline YAML (from a git repo) with Orchestra under an alias.
+- `fetch-pipelines`: Fetch the pipelines visible to the current API key as JSON.
 - `create-pipeline`: Create an Orchestra-backed pipeline from a local YAML file.
 - `update-pipeline`: Update an existing Orchestra-backed pipeline from a local YAML file.
+- `delete-pipeline`: Delete an existing pipeline by alias.
 - `run`: Start a pipeline run by alias, optionally pinning branch/commit and waiting for completion.
 
 Use `orchestra --help` or `orchestra <command> --help` for built-in help.
@@ -149,6 +151,24 @@ Behavior
 
 ---
 
+## fetch-pipelines
+
+Fetch the pipelines available to the current Orchestra API key.
+
+```bash
+export ORCHESTRA_API_KEY=...
+
+orchestra fetch-pipelines
+```
+
+Behavior
+
+- Sends `GET /api/engine/public/pipelines`. Responses always include each pipeline's latest run metadata.
+- Prints the response payload as pretty JSON for scripting and inspection.
+- Exit codes: `0` on success, `1` on failure.
+
+---
+
 ## update-pipeline
 
 Update an existing Orchestra-backed pipeline from a local YAML file.
@@ -178,6 +198,29 @@ Behavior
 
 ---
 
+## delete-pipeline
+
+Delete a pipeline by alias.
+
+```bash
+export ORCHESTRA_API_KEY=...
+
+orchestra delete-pipeline --alias my-pipeline
+```
+
+Options
+
+- `-a, --alias` (required): Pipeline alias to delete.
+
+Behavior
+
+- Sends `DELETE /pipelines/{alias}` with API key authentication.
+- Deletes the pipeline resolved by alias within the authenticated account.
+- On success, exits with code `0` after printing a confirmation message.
+- Exit codes: `0` on success, `1` on failure.
+
+---
+
 ## run
 
 Start a pipeline run by alias. Optionally specify a branch and/or commit. By default, the command waits and polls the run status until completion.

{orchestra_cli-0.2.0 → orchestra_cli-0.3.0}/orchestra_cli.egg-info/SOURCES.txt

@@ -9,6 +9,8 @@ orchestra_cli.egg-info/top_level.txt
 orchestra_cli/src/__init__.py
 orchestra_cli/src/cli.py
 orchestra_cli/src/create_pipeline.py
+orchestra_cli/src/delete_pipeline.py
+orchestra_cli/src/fetch_pipelines.py
 orchestra_cli/src/import_pipeline.py
 orchestra_cli/src/pipeline_upsert.py
 orchestra_cli/src/run_pipeline.py
@@ -18,6 +20,8 @@ orchestra_cli/tests/__init__.py
 orchestra_cli/tests/conftest.py
 orchestra_cli/tests/test_cli.py
 orchestra_cli/tests/test_create_pipeline.py
+orchestra_cli/tests/test_delete_pipeline.py
+orchestra_cli/tests/test_fetch_pipelines.py
 orchestra_cli/tests/test_import_pipeline.py
 orchestra_cli/tests/test_run_pipeline.py
 orchestra_cli/tests/test_update_pipeline.py

{orchestra_cli-0.2.0 → orchestra_cli-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "orchestra-cli"
-version = "0.2.0"
+version = "0.3.0"
 description = "Orchestra CLI. Perform operations with Orchestra locally."
 readme = "README.md"
 authors = [