flowbase-cli 0.1.0__tar.gz → 0.1.1__tar.gz

{flowbase_cli-0.1.0 → flowbase_cli-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flowbase-cli
-Version: 0.1.0
+Version: 0.1.1
 Summary: Command line client for the FlowBase OpenAPI
 Author: DeepFlowAI
 License: Apache-2.0
@@ -23,7 +23,9 @@ export FLOWBASE_API_KEY=fbk_xxx
 
 flowbase objects list
 flowbase records create obj_xxx --json '{"values":{"name":"Example"}}'
+flowbase changes commit --message "Add customer field" --yes
+flowbase changes release --message "Release customer field" --yes
 flowbase docs list
 ```
 
-`--host` selects the environment through its Host. The CLI never accepts a separate environment override and never stores API keys on disk. See `flowbase --help` and `flowbase docs list` for the complete command set.
+`--host` selects the environment through its Host. Version commands are limited to the current enabled test environment; release can succeed only when its current version meets FlowBase's fast-forward checks. The CLI never accepts a separate environment override and never stores API keys on disk. See `flowbase --help` and `flowbase docs list` for the complete command set.

flowbase_cli-0.1.1/README.md

@@ -0,0 +1,22 @@
+# FlowBase CLI
+
+Install from this checkout:
+
+```bash
+python -m pip install ./packages/flowbase-cli
+```
+
+Configure an environment Base URL and an API key:
+
+```bash
+export FLOWBASE_HOST=https://flowbase-test-a.deepflowagent.com
+export FLOWBASE_API_KEY=fbk_xxx
+
+flowbase objects list
+flowbase records create obj_xxx --json '{"values":{"name":"Example"}}'
+flowbase changes commit --message "Add customer field" --yes
+flowbase changes release --message "Release customer field" --yes
+flowbase docs list
+```
+
+`--host` selects the environment through its Host. Version commands are limited to the current enabled test environment; release can succeed only when its current version meets FlowBase's fast-forward checks. The CLI never accepts a separate environment override and never stores API keys on disk. See `flowbase --help` and `flowbase docs list` for the complete command set.

{flowbase_cli-0.1.0 → flowbase_cli-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flowbase-cli"
-version = "0.1.0"
+version = "0.1.1"
 description = "Command line client for the FlowBase OpenAPI"
 readme = "README.md"
 requires-python = ">=3.11"

{flowbase_cli-0.1.0 → flowbase_cli-0.1.1}/src/flowbase_cli/__init__.py

@@ -1,3 +1,3 @@
 """FlowBase OpenAPI CLI."""
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"

{flowbase_cli-0.1.0 → flowbase_cli-0.1.1}/src/flowbase_cli/endpoints.py

@@ -27,6 +27,8 @@ ENDPOINTS = (
     Endpoint("fields.update", "flowbase_fields_update", "PUT", "/objects/{object_id}/fields/{field_id}", "metadata:write", "Update a field draft.", "flowbase fields update obj_xxx fld_xxx --label Name --description 'Customer name'"),
     Endpoint("fields.delete", "flowbase_fields_delete", "DELETE", "/objects/{object_id}/fields/{field_id}", "metadata:write", "Logically delete a field.", "flowbase fields delete obj_xxx fld_xxx --yes", True),
     Endpoint("fields.restore", "flowbase_fields_restore", "POST", "/objects/{object_id}/fields/{field_id}/restore", "metadata:write", "Restore a field.", "flowbase fields restore obj_xxx fld_xxx --yes", True),
+    Endpoint("changes.commit", "flowbase_changes_commit", "POST", "/changes/commit", "metadata:write", "Commit current test-environment drafts.", "flowbase changes commit --message 'Add customer field' --yes", True),
+    Endpoint("changes.release", "flowbase_changes_release", "POST", "/changes/release", "metadata:write", "Release the current test-environment version.", "flowbase changes release --message 'Release customer field' --yes", True),
     Endpoint("records.list", "flowbase_records_list", "GET", "/objects/{object_id}/records", "records:read", "List records.", "flowbase records list obj_xxx --page 1"),
     Endpoint("records.get", "flowbase_records_get", "GET", "/objects/{object_id}/records/{record_id}", "records:read", "Get a record.", "flowbase records get obj_xxx rec_xxx"),
     Endpoint("records.create", "flowbase_records_create", "POST", "/objects/{object_id}/records", "records:write", "Create a record.", "flowbase records create obj_xxx --json-file record.json"),

{flowbase_cli-0.1.0 → flowbase_cli-0.1.1}/src/flowbase_cli/main.py

@@ -2,6 +2,7 @@
 from __future__ import annotations
 
 import argparse
+from decimal import Decimal
 import json
 import os
 import sys
@@ -49,7 +50,7 @@ def load_json_payload(json_text: str | None, json_file: str | None) -> dict[str,
     except OSError as exc:
         raise CliError(f"Cannot read JSON file: {exc}") from exc
     try:
-        payload = json.loads(source)
+        payload = json.loads(source, parse_float=Decimal)
     except json.JSONDecodeError as exc:
         raise CliError(f"Invalid JSON at line {exc.lineno}, column {exc.colno}: {exc.msg}") from exc
     if not isinstance(payload, dict):
@@ -99,7 +100,7 @@ class OpenApiClient:
         headers = {"Accept": "application/json", "Authorization": f"Bearer {self.api_key}"}
         data = None
         if body is not None:
-            data = json.dumps(body, ensure_ascii=False).encode("utf-8")
+            data = exact_json_dumps(body).encode("utf-8")
             headers["Content-Type"] = "application/json"
         request = Request(url, data=data, headers=headers, method=endpoint.method)
         try:
@@ -127,6 +128,33 @@ def _error_detail(payload: str) -> str:
     return json.dumps(parsed, ensure_ascii=False)
 
 
+def exact_json_dumps(value: Any) -> str:
+    if value is None:
+        return "null"
+    if value is True:
+        return "true"
+    if value is False:
+        return "false"
+    if isinstance(value, str):
+        return json.dumps(value, ensure_ascii=False)
+    if isinstance(value, Decimal):
+        if not value.is_finite():
+            raise CliError("JSON numbers must be finite.")
+        return format(value, "f")
+    if isinstance(value, int):
+        return str(value)
+    if isinstance(value, float):
+        raise CliError("Binary floating-point values are not accepted.")
+    if isinstance(value, list):
+        return "[" + ",".join(exact_json_dumps(item) for item in value) + "]"
+    if isinstance(value, dict):
+        return "{" + ",".join(
+            f"{json.dumps(str(key), ensure_ascii=False)}:{exact_json_dumps(item)}"
+            for key, item in value.items()
+        ) + "}"
+    raise CliError(f"Unsupported JSON value: {type(value).__name__}")
+
+
 def print_output(data: bytes, *, pretty: bool, raw: bool) -> None:
     text = data.decode("utf-8", errors="replace")
     if raw:
@@ -240,6 +268,10 @@ def handle_fields(args: argparse.Namespace) -> int:
     return run_request(args, f"fields.{action}", path_params=path)
 
 
+def handle_changes(args: argparse.Namespace) -> int:
+    return run_request(args, f"changes.{args.changes_action}", body={"message": args.message})
+
+
 def handle_records(args: argparse.Namespace) -> int:
     action = args.records_action
     path = {"object_id": args.object_id}
@@ -322,6 +354,14 @@ def build_parser() -> argparse.ArgumentParser:
         add_yes(item)
     fields.set_defaults(handler=handle_fields)
 
+    changes = groups.add_parser("changes", help="Commit or release eligible test-environment metadata versions.")
+    change_actions = changes.add_subparsers(dest="changes_action", required=True)
+    for action in ("commit", "release"):
+        item = change_actions.add_parser(action)
+        item.add_argument("--message", required=True)
+        add_yes(item)
+    changes.set_defaults(handler=handle_changes)
+
     records = groups.add_parser("records", help="Manage business records.")
     record_actions = records.add_subparsers(dest="records_action", required=True)
     record_list = record_actions.add_parser("list")

{flowbase_cli-0.1.0 → flowbase_cli-0.1.1}/src/flowbase_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flowbase-cli
-Version: 0.1.0
+Version: 0.1.1
 Summary: Command line client for the FlowBase OpenAPI
 Author: DeepFlowAI
 License: Apache-2.0
@@ -23,7 +23,9 @@ export FLOWBASE_API_KEY=fbk_xxx
 
 flowbase objects list
 flowbase records create obj_xxx --json '{"values":{"name":"Example"}}'
+flowbase changes commit --message "Add customer field" --yes
+flowbase changes release --message "Release customer field" --yes
 flowbase docs list
 ```
 
-`--host` selects the environment through its Host. The CLI never accepts a separate environment override and never stores API keys on disk. See `flowbase --help` and `flowbase docs list` for the complete command set.
+`--host` selects the environment through its Host. Version commands are limited to the current enabled test environment; release can succeed only when its current version meets FlowBase's fast-forward checks. The CLI never accepts a separate environment override and never stores API keys on disk. See `flowbase --help` and `flowbase docs list` for the complete command set.

{flowbase_cli-0.1.0 → flowbase_cli-0.1.1}/tests/test_cli.py

@@ -3,12 +3,20 @@ from __future__ import annotations
 import io
 import json
 import unittest
+from decimal import Decimal
 from pathlib import Path
 from tempfile import TemporaryDirectory
 from unittest.mock import patch
 
 from flowbase_cli.endpoints import ENDPOINTS
-from flowbase_cli.main import CliError, OpenApiClient, api_root, load_json_payload, main
+from flowbase_cli.main import (
+    CliError,
+    OpenApiClient,
+    api_root,
+    exact_json_dumps,
+    load_json_payload,
+    main,
+)
 
 
 class FlowBaseCliTest(unittest.TestCase):
@@ -33,6 +41,18 @@ class FlowBaseCliTest(unittest.TestCase):
             path.write_text('{"label":"客户"}', encoding="utf-8")
             self.assertEqual(load_json_payload(None, str(path)), {"label": "客户"})
 
+    def test_decimal_payload_preserves_json_number_text(self):
+        payload = load_json_payload(
+            '{"values":{"amount":12345678901234.5678}}', None
+        )
+        self.assertEqual(
+            payload["values"]["amount"], Decimal("12345678901234.5678")
+        )
+        self.assertEqual(
+            exact_json_dumps(payload),
+            '{"values":{"amount":12345678901234.5678}}',
+        )
+
     def test_missing_key_is_rejected_before_network(self):
         client = OpenApiClient("https://example.com", None)
         with patch("flowbase_cli.main.urlopen") as mocked:
@@ -53,6 +73,7 @@ class FlowBaseCliTest(unittest.TestCase):
         self.assertEqual(code, 0)
         payload = json.loads(stdout.getvalue())
         self.assertTrue(any(item["key"] == "records.create" for item in payload))
+        self.assertTrue(any(item["key"] == "changes.release" for item in payload))
 
     def test_object_create_requires_business_description(self):
         stderr = io.StringIO()
@@ -68,6 +89,13 @@ class FlowBaseCliTest(unittest.TestCase):
         self.assertEqual(code, 1)
         self.assertIn("without --yes", stderr.getvalue())
 
+    def test_noninteractive_commit_requires_yes(self):
+        stderr = io.StringIO()
+        with patch("sys.stderr", stderr), patch("sys.stdin.isatty", return_value=False):
+            code = main(["--api-key", "fbk_test", "changes", "commit", "--message", "Add customer field"])
+        self.assertEqual(code, 1)
+        self.assertIn("without --yes", stderr.getvalue())
+
 
 if __name__ == "__main__":
     unittest.main()

flowbase_cli-0.1.0/README.md

@@ -1,20 +0,0 @@
-# FlowBase CLI
-
-Install from this checkout:
-
-```bash
-python -m pip install ./packages/flowbase-cli
-```
-
-Configure an environment Base URL and an API key:
-
-```bash
-export FLOWBASE_HOST=https://flowbase-test-a.deepflowagent.com
-export FLOWBASE_API_KEY=fbk_xxx
-
-flowbase objects list
-flowbase records create obj_xxx --json '{"values":{"name":"Example"}}'
-flowbase docs list
-```
-
-`--host` selects the environment through its Host. The CLI never accepts a separate environment override and never stores API keys on disk. See `flowbase --help` and `flowbase docs list` for the complete command set.