current-cli 0.1.35__tar.gz → 0.1.36__tar.gz

{current_cli-0.1.35 → current_cli-0.1.36}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: current-cli
-Version: 0.1.35
+Version: 0.1.36
 Summary: Command line interface for the Current API, generated from its OpenAPI schema at runtime
 Author-email: Orin <your-email@example.com>
 License-Expression: MIT

{current_cli-0.1.35 → current_cli-0.1.36}/current_cli/build.py

@@ -16,9 +16,14 @@ def _make_callback(op: Operation):
         for param in op.path_params:
             path = path.replace("{" + param.name + "}", str(kwargs.pop(param.name)))
 
-        params: dict[str, str] = {}
+        params: dict[str, str | list[str]] = {}
         for param in op.query_params:
             value = kwargs.pop(param.name, None)
+            # click gives a repeatable option an empty tuple, not None, when
+            # it is absent; treat that as "not given" so it never becomes an
+            # empty query key.
+            if param.is_array:
+                value = list(value) if value else None
             if value is None and param.name == "workspace":
                 value = config.get("default_workspace")
             if value is None:
@@ -48,6 +53,7 @@ def _make_command(op: Operation) -> click.Command:
             click.Option(
                 [f"--{param.name.replace('_', '-')}"],
                 required=False,
+                multiple=param.is_array,
                 help=param.description or None,
             )
         )

{current_cli-0.1.35 → current_cli-0.1.36}/current_cli/schema.py

@@ -21,6 +21,9 @@ class Parameter:
     location: str  # "path" or "query"
     required: bool
     description: str
+    # An array query param is sent as the repeated key the API reads with
+    # getlist (?fields=a&fields=b), so its option has to be repeatable too.
+    is_array: bool = False
 
 
 @dataclass(frozen=True)
@@ -90,6 +93,7 @@ def extract_operations(spec: dict) -> list[Operation]:
                     location=raw["in"],
                     required=raw.get("required", False),
                     description=raw.get("description", ""),
+                    is_array=raw.get("schema", {}).get("type") == "array",
                 )
                 if param.location == "path":
                     path_params.append(param)

{current_cli-0.1.35 → current_cli-0.1.36}/current_cli/schema.yml

@@ -1841,12 +1841,17 @@ paths:
     get:
       operationId: projects_projects_inventory_retrieve
       description: |-
-        Page current field values, optionally narrowed to named keys.
+        Page current field values, optionally narrowed to named keys and
+        to projects whose values match.
 
         The full project list serializes every field of every project —
         megabytes at production scale. This page is the compact census a
         chat agent can scan: identity plus the keys it asked for, no
-        timeline, no provenance. See state.list_projects.
+        timeline, no provenance.
+
+        Filter here rather than page-and-sift: a caller that reads every
+        page and picks the matches by eye miscounts, and "total" under a
+        filter is the count it was really after. See state.list_projects.
       parameters:
       - in: query
         name: fields
@@ -1855,6 +1860,16 @@ paths:
           items:
             type: string
         description: Field keys to keep; omit to return every current value
+      - in: query
+        name: filter
+        schema:
+          type: array
+          items:
+            type: string
+        description: Keep only projects whose current value matches, as 'key:value'
+          (for example 'status:Active'). Repeat for more fields; repeating one key
+          accepts any of its values. An option matches by label, value, or ID. 'total'
+          counts the matching projects.
       - in: query
         name: limit
         schema:
@@ -1865,6 +1880,14 @@ paths:
         schema:
           type: integer
         description: Number of projects to skip (default 0)
+      - in: query
+        name: values
+        schema:
+          type: string
+          enum:
+          - ids
+          - labels
+        description: Read option values as labels (default) or as option IDs
       - in: query
         name: workspace
         schema:

{current_cli-0.1.35 → current_cli-0.1.36}/llms.txt

@@ -617,19 +617,26 @@ Options:
 
 ### current projects inventory retrieve
 
-Page current field values, optionally narrowed to named keys.
+Page current field values, optionally narrowed to named keys and
+to projects whose values match.
 
 The full project list serializes every field of every project —
 megabytes at production scale. This page is the compact census a
 chat agent can scan: identity plus the keys it asked for, no
-timeline, no provenance. See state.list_projects.
+timeline, no provenance.
+
+Filter here rather than page-and-sift: a caller that reads every
+page and picks the matches by eye miscounts, and "total" under a
+filter is the count it was really after. See state.list_projects.
 
 GET /api/projects/projects/inventory/
 
 Options:
 - `--fields` - Field keys to keep; omit to return every current value
+- `--filter` - Keep only projects whose current value matches, as 'key:value' (for example 'status:Active'). Repeat for more fields; repeating one key accepts any of its values. An option matches by label, value, or ID. 'total' counts the matching projects.
 - `--limit` - Max projects per page (default 100, max 200)
 - `--offset` - Number of projects to skip (default 0)
+- `--values` - Read option values as labels (default) or as option IDs
 - `--workspace` - Workspace UUID
 
 ### current projects list

{current_cli-0.1.35 → current_cli-0.1.36}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "current-cli"
-version = "0.1.35"
+version = "0.1.36"
 description = "Command line interface for the Current API, generated from its OpenAPI schema at runtime"
 readme = "README.md"
 requires-python = ">=3.10"

{current_cli-0.1.35 → current_cli-0.1.36}/tests/test_requests.py

@@ -60,6 +60,40 @@ def test_create_sends_json_body(cli, runner, transport_factory):
     assert json.loads(request.content) == {"name": "Order beams", "workspace": "w1"}
 
 
+def test_array_query_param_repeats(cli, runner, transport_factory):
+    """An array param must repeat its key, the shape the API reads with
+    getlist — one AND-ed filter per --filter."""
+    transport = transport_factory(ok({}))
+
+    result = runner.invoke(
+        cli,
+        [
+            "projects",
+            "inventory",
+            "retrieve",
+            "--workspace",
+            "ws-uuid",
+            "--filter",
+            "status:Active",
+            "--filter",
+            "site_type:Garden Style",
+        ],
+    )
+
+    assert result.exit_code == 0, result.output
+    params = transport.requests[0].url.params
+    assert params.get_list("filter") == ["status:Active", "site_type:Garden Style"]
+
+
+def test_array_query_param_is_absent_when_not_given(cli, runner, transport_factory):
+    transport = transport_factory(ok({}))
+
+    result = runner.invoke(cli, ["projects", "inventory", "retrieve", "--workspace", "ws-uuid"])
+
+    assert result.exit_code == 0, result.output
+    assert "filter" not in transport.requests[0].url.params
+
+
 def test_default_workspace_fallback(cli, runner, transport_factory):
     config.set_value("default_workspace", "default-ws")
     transport = transport_factory(ok({}))