minitest-cli 0.25.2__tar.gz → 0.26.0__tar.gz

{minitest_cli-0.25.2 → minitest_cli-0.26.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: minitest-cli
-Version: 0.25.2
+Version: 0.26.0
 Summary: Minitest CLI – command-line interface for the Minitest testing platform
 Project-URL: Homepage, https://minitap.ai/
 Project-URL: Source, https://github.com/minitap-ai/minitest-cli

{minitest_cli-0.25.2 → minitest_cli-0.26.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "minitest-cli"
-version = "0.25.2"
+version = "0.26.0"
 description = "Minitest CLI – command-line interface for the Minitest testing platform"
 readme = "README.md"
 license = "MIT"

{minitest_cli-0.25.2 → minitest_cli-0.26.0}/src/minitest_cli/commands/user_story_create.py

@@ -61,8 +61,20 @@ def create_user_story(
     camera_media: Annotated[
         str | None, typer.Option("--camera-media", help=CAMERA_MEDIA_HELP)
     ] = None,
+    idempotency_key: Annotated[
+        str | None,
+        typer.Option(
+            "--idempotency-key",
+            help="Opaque 1-255 character key for idempotent creation retries.",
+        ),
+    ] = None,
 ) -> None:
     """Create a new user story."""
+    if idempotency_key is not None and not 1 <= len(idempotency_key) <= 255:
+        raise typer.BadParameter(
+            "must contain between 1 and 255 characters",
+            param_hint="--idempotency-key",
+        )
     settings = get_settings()
     json_mode = is_json_mode()
     require_auth(settings)
@@ -89,7 +101,10 @@ def create_user_story(
                 payload["camera_media_file_id"] = await resolve_camera_media_file_id(
                     client, app_id, camera_source
                 )
-            resp = await client.post(base_path(app_id), json=payload)
+            request_options: dict[str, Any] = {"json": payload}
+            if idempotency_key is not None:
+                request_options["headers"] = {"Idempotency-Key": idempotency_key}
+            resp = await client.post(base_path(app_id), **request_options)
             handle_response_error(resp)
             created = resp.json()
             if depends_on:

{minitest_cli-0.25.2 → minitest_cli-0.26.0}/tests/test_user_story_commands.py

@@ -11,6 +11,7 @@ from unittest.mock import AsyncMock, MagicMock, patch
 import httpx
 import pytest
 import typer
+from click import unstyle
 from typer.testing import CliRunner
 
 from minitest_cli.commands.user_story import app as user_story_app
@@ -87,6 +88,17 @@ def _mock_response(status_code=200, json_data=None):
     return resp
 
 
+@contextmanager
+def _patch_http_transport(handler):
+    async_client = httpx.AsyncClient
+    transport = httpx.MockTransport(handler)
+    with patch(
+        "minitest_cli.api.client.httpx.AsyncClient",
+        side_effect=lambda **kwargs: async_client(**kwargs, transport=transport),
+    ):
+        yield
+
+
 SAMPLE_USER_STORY = {
     "id": "story-1",
     "name": "Login Story",
@@ -143,6 +155,100 @@ class TestCreateUserStory:
             )
         assert result.exit_code == 0
 
+    def test_absent_idempotency_key_preserves_legacy_request_and_human_output(self, tmp_path):
+        settings = _make_settings(tmp_path)
+        requests = []
+
+        def handler(request):
+            requests.append(request)
+            return httpx.Response(
+                201,
+                json={"id": "legacy-story", "name": "Story", "type": "login"},
+            )
+
+        with _patch_flow_types(), _patch_http_transport(handler):
+            result = _run_with_context(["create", "--name", "Story", "--type", "login"], settings)
+
+        assert result.exit_code == 0
+        assert "Idempotency-Key" not in requests[0].headers
+        assert "id: legacy-story" in result.stdout
+        assert "User story created: legacy-story" in result.stderr
+
+    def test_idempotency_replay_and_conflict_follow_server_contract(self, tmp_path):
+        settings = _make_settings(tmp_path)
+        key = "Draft-Operation-AbC"
+        requests = []
+        stored_payload = None
+        created = {
+            "id": "stable-story-id",
+            "acceptanceCriteria": [
+                {
+                    "id": "stable-criterion-version-id",
+                    "criterionId": "stable-criterion-id",
+                    "content": "The user can sign in.",
+                    "createdAt": "2026-08-28T20:00:00Z",
+                }
+            ],
+        }
+
+        def handler(request):
+            nonlocal stored_payload
+            requests.append(request)
+            payload = json.loads(request.content)
+            if stored_payload is None:
+                stored_payload = payload
+                return httpx.Response(201, json=created)
+            if payload == stored_payload:
+                return httpx.Response(201, json=created)
+            return httpx.Response(
+                409,
+                json={"detail": "Idempotency key is already used for a different request."},
+            )
+
+        base_args = ["create", "--name", "Story", "--type", "login", "--idempotency-key", key]
+        with _patch_flow_types(), _patch_http_transport(handler):
+            first = _run_with_context(base_args, settings, json_mode=True)
+            replay = _run_with_context(base_args, settings, json_mode=True)
+            conflict = _run_with_context(
+                [
+                    "create",
+                    "--name",
+                    "Different story",
+                    "--type",
+                    "login",
+                    "--idempotency-key",
+                    key,
+                ],
+                settings,
+                json_mode=True,
+            )
+
+        assert first.exit_code == replay.exit_code == 0
+        first_output = json.loads(first.stdout)
+        replay_output = json.loads(replay.stdout)
+        assert first_output == replay_output == created
+        assert replay_output["id"] == first_output["id"] == "stable-story-id"
+        assert replay_output["acceptanceCriteria"][0]["criterionId"] == "stable-criterion-id"
+        assert replay_output["acceptanceCriteria"][0]["id"] == "stable-criterion-version-id"
+        assert [request.headers["Idempotency-Key"] for request in requests] == [key, key, key]
+        assert conflict.exit_code == 3
+        assert conflict.stdout == ""
+        assert "already used for a different request" in conflict.stderr
+
+    @pytest.mark.parametrize("key", ["", "x" * 256])
+    def test_invalid_idempotency_key_is_rejected_locally(self, tmp_path, key):
+        settings = _make_settings(tmp_path)
+        with _patch_flow_types():
+            result = _run_with_context(
+                ["create", "--name", "Story", "--type", "login", "--idempotency-key", key],
+                settings,
+            )
+
+        assert result.exit_code == 2
+        plain_output = unstyle(result.output)
+        assert "Invalid value for --idempotency-key" in plain_output
+        assert "between 1 and 255" in plain_output
+
 
 class TestCreateUserStoryProfiles:
     def test_repeated_profile_sends_test_profile_ids(self, tmp_path):