feat: add examples directory

Author: bchampp

.github/workflows/ci.yml

@@ -38,5 +38,7 @@ jobs:
       run: hatch run types:check
     - name: Run tests + coverage
       run: hatch run test:cov
+    - name: Run example tests
+      run: hatch run test:examples
     - name: Build distribution
       run: hatch build

examples/src/__init__.py

@@ -0,0 +1,3 @@
+"""AWS Durable Functions Python Examples."""
+
+__version__ = "0.1.0"

examples/src/hello_world.py

@@ -0,0 +1,10 @@
+from typing import Any
+from aws_durable_execution_sdk_python.context import DurableContext
+from aws_durable_execution_sdk_python.execution import durable_handler
+
+
+@durable_handler
+def handler(event: Any, context: DurableContext) -> str:
+    """Simple hello world durable function."""
+    print("Hello world from a durable function!")
+    return "Hello World!"

examples/test/__init__.py

@@ -0,0 +1 @@
+"""Integration tests for AWS Durable Functions Python Examples."""

examples/test/test_hello_world.py

@@ -0,0 +1,24 @@
+"""Integration tests for example durable functions."""
+
+import pytest
+from aws_durable_execution_sdk_python.execution import InvocationStatus
+from aws_durable_execution_sdk_python_testing.runner import (
+    DurableFunctionTestResult,
+    DurableFunctionTestRunner,
+)
+
+from src import hello_world
+
+
+class TestExamples:
+    """Integration tests for examples."""
+
+    def test_hello_world(self):
+        """Test hello world example."""
+        with DurableFunctionTestRunner(handler=hello_world.handler) as runner:
+            result: DurableFunctionTestResult = runner.run(
+                input="test", timeout=10
+            )
+
+        assert result.status is InvocationStatus.SUCCEEDED
+        assert result.result == '"Hello World!"'

pyproject.toml

@@ -53,9 +53,12 @@ dependencies = [
     "coverage[toml]",
     "pytest",
     "pytest-cov",
+    "aws_durable_execution_sdk_python @ git+ssh://git@github.com/aws/aws-durable-execution-sdk-python.git"
 ]
 
 [tool.hatch.envs.test.scripts]
+test = "pytest tests/ -v"
+examples = "pytest examples/test/ -v"
 cov="pytest --cov-report=term-missing --cov-config=pyproject.toml --cov=src/aws_durable_execution_sdk_python_testing --cov=tests --cov-fail-under=99"
 
 [tool.hatch.envs.types]