local-web-services-python-sdk 0.19.0__tar.gz → 0.20.0__tar.gz

{local_web_services_python_sdk-0.19.0 → local_web_services_python_sdk-0.20.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: local-web-services-python-sdk
-Version: 0.19.0
+Version: 0.20.0
 Summary: Python testing SDK for local-web-services — in-process pytest fixtures and boto3 helpers
 Project-URL: Homepage, https://local-web-services.github.io
 Project-URL: Repository, https://github.com/local-web-services/local-web-services-sdk-python

{local_web_services_python_sdk-0.19.0 → local_web_services_python_sdk-0.20.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "local-web-services-python-sdk"
-version = "0.19.0"
+version = "0.20.0"
 description = "Python testing SDK for local-web-services — in-process pytest fixtures and boto3 helpers"
 readme = "README.md"
 license = "MIT"

{local_web_services_python_sdk-0.19.0 → local_web_services_python_sdk-0.20.0}/tests/e2e/cloudformation/test_scenarios.py

@@ -18,7 +18,7 @@ def _has_runnable_scenarios(filepath: str) -> bool:
     return "@minimal" in content or "@standard" in content
 
 
-for _f in glob.glob(os.path.join(_INFORMAL, "cloudformation", "*.feature")):
+for _f in sorted(glob.glob(os.path.join(_INFORMAL, "cloudformation", "*.feature"))):
     if "sequences" not in os.path.basename(_f) and _has_runnable_scenarios(_f):
         scenarios(_f)
 

{local_web_services_python_sdk-0.19.0 → local_web_services_python_sdk-0.20.0}/tests/e2e/stepfunctions_dynamodb/client.py

@@ -5,9 +5,12 @@ from __future__ import annotations
 from .constants import (
     PASS_DEFINITION,
     ROLE_ARN,
+    TEST_INITIAL_STATUS,
     TEST_INPUT,
+    TEST_ITEM_KEY,
     TEST_PK,
     TEST_SM,
+    TEST_STATUS_ATTR,
     TEST_TABLE,
     _sm_arn,
 )
@@ -35,6 +38,15 @@ class StepfunctionsDynamodbTestClient:
             BillingMode="PAY_PER_REQUEST",
         )
 
+    def put_seed_item(self, table=TEST_TABLE):
+        self._ddb.put_item(
+            TableName=table,
+            Item={
+                TEST_PK: {"S": TEST_ITEM_KEY},
+                TEST_STATUS_ATTR: {"S": TEST_INITIAL_STATUS},
+            },
+        )
+
     def start_execution(self, name=TEST_SM):
         resp = self._sfn.start_execution(stateMachineArn=_sm_arn(name), input=TEST_INPUT)
         return resp["executionArn"]

{local_web_services_python_sdk-0.19.0 → local_web_services_python_sdk-0.20.0}/tests/e2e/stepfunctions_dynamodb/constants.py

@@ -59,5 +59,37 @@ def _dynamodb_get_item_definition(table_name: str, pk: str, item_key: str) -> st
     )
 
 
+TEST_STATUS_ATTR = "status"
+
+TEST_INITIAL_STATUS = "pending"
+
+TEST_UPDATED_STATUS = "processed"
+
+
+def _dynamodb_update_item_definition(
+    table_name: str, pk: str, item_key: str, attr: str, updated_val: str
+) -> str:
+    """Return a state machine definition with a DynamoDB UpdateItem task."""
+    return json.dumps(
+        {
+            "StartAt": "UpdateItem",
+            "States": {
+                "UpdateItem": {
+                    "Type": "Task",
+                    "Resource": "arn:aws:states:::dynamodb:updateItem",
+                    "Parameters": {
+                        "TableName": table_name,
+                        "Key": {pk: {"S": item_key}},
+                        "UpdateExpression": "SET #a = :val",
+                        "ExpressionAttributeNames": {"#a": attr},
+                        "ExpressionAttributeValues": {":val": {"S": updated_val}},
+                    },
+                    "End": True,
+                }
+            },
+        }
+    )
+
+
 def _sm_arn(name=TEST_SM):
     return f"arn:aws:states:us-east-1:000000000000:stateMachine:{name}"

{local_web_services_python_sdk-0.19.0 → local_web_services_python_sdk-0.20.0}/tests/e2e/stepfunctions_dynamodb/given/__init__.py

@@ -1,5 +1,6 @@
 from .dynamodb_putitem_task_configured_given import *  # noqa: F401,F403
 from .dynamodb_table_has_been_created import *  # noqa: F401,F403
+from .dynamodb_updateitem_task_configured_given import *  # noqa: F401,F403
 from .eid_in_exec_status import *  # noqa: F401,F403
 from .execution_is_running_given import *  # noqa: F401,F403
 from .execution_of_sm_has_been_started import *  # noqa: F401,F403
@@ -11,6 +12,7 @@ from .no_execution_slot_available import *  # noqa: F401,F403
 from .no_item_exists_in_target_table import *  # noqa: F401,F403
 from .no_item_slot_available import *  # noqa: F401,F403
 from .running_execution_get_item_failed_given import *  # noqa: F401,F403
+from .running_execution_updated_item_succeeded_given import *  # noqa: F401,F403
 from .running_execution_wrote_item_succeeded_given import *  # noqa: F401,F403
 from .sfn_sm_has_been_created import *  # noqa: F401,F403
 from .sm_already_exists import *  # noqa: F401,F403

local_web_services_python_sdk-0.20.0/tests/e2e/stepfunctions_dynamodb/given/dynamodb_updateitem_task_configured_given.py

@@ -0,0 +1,11 @@
+"""Given: a "dynamodb" "UpdateItem" task is configured on the "step functions" "state machine" """
+
+from __future__ import annotations
+
+import pytest
+from pytest_bdd import given
+
+
+@given('a "dynamodb" "UpdateItem" task is configured on the "step functions" "state machine"')
+def dynamodb_updateitem_task_configured_given():
+    pytest.skip("Cannot pre-set a DynamoDB UpdateItem task configuration state for sequence setup")

local_web_services_python_sdk-0.20.0/tests/e2e/stepfunctions_dynamodb/given/running_execution_updated_item_succeeded_given.py

@@ -0,0 +1,13 @@
+"""Given: a running "step functions" "execution" updates an item in the "dynamodb" "table" and succeeds"""
+
+from __future__ import annotations
+
+import pytest
+from pytest_bdd import given
+
+
+@given(
+    'a running "step functions" "execution" updates an item in the "dynamodb" "table" and succeeds'
+)
+def running_execution_updated_item_succeeded_given():
+    pytest.skip("Cannot pre-set a completed execution DynamoDB update state for sequence setup")

{local_web_services_python_sdk-0.19.0 → local_web_services_python_sdk-0.20.0}/tests/e2e/stepfunctions_dynamodb/then/__init__.py

@@ -3,6 +3,7 @@ from ._inv_stepfunctions_dynamodb_every_running_execution_references_an_active_s
 from .execution_failed_item_not_found import *  # noqa: F401,F403
 from .execution_is_running_then import *  # noqa: F401,F403
 from .item_exists_and_execution_succeeded import *  # noqa: F401,F403
+from .item_is_updated_and_execution_succeeded import *  # noqa: F401,F403
 from .sm_active_no_dynamodb_task import *  # noqa: F401,F403
 from .sm_will_write_item import *  # noqa: F401,F403
 from .table_is_active_then import *  # noqa: F401,F403

local_web_services_python_sdk-0.20.0/tests/e2e/stepfunctions_dynamodb/then/item_is_updated_and_execution_succeeded.py

@@ -0,0 +1,30 @@
+"""Then: the item will be updated in the "dynamodb" "table" and the "step functions" "execution" will be "SUCCEEDED" """
+
+from __future__ import annotations
+
+from pytest_bdd import then
+
+from ..constants import TEST_ITEM_KEY, TEST_PK, TEST_STATUS_ATTR, TEST_TABLE, TEST_UPDATED_STATUS
+
+
+@then(
+    'the item will be updated in the "dynamodb" "table" and the "step functions" "execution" will be "SUCCEEDED"'
+)
+def item_is_updated_and_execution_succeeded(lws_session, world):
+    expected_error = None
+    expected_status = TEST_UPDATED_STATUS
+    actual_error = world["error"]
+    assert (
+        actual_error is expected_error
+    ), f"Expected start_execution to succeed but got: {actual_error}"
+    actual_resp = lws_session.client("dynamodb").get_item(
+        TableName=TEST_TABLE, Key={TEST_PK: {"S": TEST_ITEM_KEY}}
+    )
+    actual_item = actual_resp.get("Item", {})
+    assert (
+        actual_item
+    ), f"Expected item with key '{TEST_ITEM_KEY}' to exist in table '{TEST_TABLE}' but got empty item"
+    actual_status = actual_item.get(TEST_STATUS_ATTR, {}).get("S")
+    assert (
+        actual_status == expected_status
+    ), f"Expected '{TEST_STATUS_ATTR}' to be {expected_status!r} but got {actual_status!r}"

{local_web_services_python_sdk-0.19.0 → local_web_services_python_sdk-0.20.0}/tests/e2e/stepfunctions_dynamodb/when/__init__.py

@@ -2,5 +2,6 @@ from .configure_dynamodb_task import *  # noqa: F401,F403
 from .create_dynamodb_table import *  # noqa: F401,F403
 from .create_state_machine import *  # noqa: F401,F403
 from .execution_gets_item_not_found import *  # noqa: F401,F403
+from .execution_updates_item import *  # noqa: F401,F403
 from .execution_writes_item import *  # noqa: F401,F403
 from .start_execution import *  # noqa: F401,F403

local_web_services_python_sdk-0.20.0/tests/e2e/stepfunctions_dynamodb/when/execution_updates_item.py

@@ -0,0 +1,51 @@
+"""When: a running "step functions" "execution" updates an item in the "dynamodb" "table" and succeeds"""
+
+from __future__ import annotations
+
+from botocore.exceptions import ClientError
+from pytest_bdd import when
+
+from ..client import StepfunctionsDynamodbTestClient
+from ..constants import (
+    TEST_INPUT,
+    TEST_ITEM_KEY,
+    TEST_PK,
+    TEST_STATUS_ATTR,
+    TEST_TABLE,
+    TEST_UPDATED_STATUS,
+    _dynamodb_update_item_definition,
+    _sm_arn,
+)
+
+
+@when(
+    'a running "step functions" "execution" updates an item in the "dynamodb" "table" and succeeds'
+)
+def execution_updates_item(lws_session, world):
+    try:
+        StepfunctionsDynamodbTestClient(lws_session).create_table()
+    except Exception:
+        pass
+    try:
+        StepfunctionsDynamodbTestClient(lws_session).put_seed_item()
+    except Exception:
+        pass
+    try:
+        lws_session.client("stepfunctions").update_state_machine(
+            stateMachineArn=_sm_arn(),
+            definition=_dynamodb_update_item_definition(
+                TEST_TABLE, TEST_PK, TEST_ITEM_KEY, TEST_STATUS_ATTR, TEST_UPDATED_STATUS
+            ),
+        )
+    except Exception:
+        pass
+    try:
+        resp = lws_session.client("stepfunctions").start_execution(
+            stateMachineArn=_sm_arn(), input=TEST_INPUT
+        )
+        world["result"] = resp
+        world["execution_arn"] = resp["executionArn"]
+        world["error"] = None
+    except (ClientError, Exception) as exc:
+        world["result"] = None
+        world["error"] = exc