Add Python examples deployment infrastructure

- Add examples catalog with hello_world function
- Add build script to copy SDK dependencies from hatch environment
- Add deployment script with AWS Lambda integration
- Add SAM template for local testing
- Add GitHub workflow for automated deployment
- Add hatch examples environment with build/deploy/clean commands

Author: bchampp

.github/workflows/deploy-examples.yml

@@ -0,0 +1,119 @@
+name: Deploy Python Examples
+
+on:
+  push:
+    branches: [ "main", "development" ]
+    paths:
+      - 'src/aws_durable_execution_sdk_python_testing/**'
+      - 'examples/**'
+      - '.github/workflows/deploy-examples.yml'
+  pull_request:
+    branches: [ "main", "development"]
+    paths:
+      - 'src/aws_durable_execution_sdk_python_testing/**'
+      - 'examples/**'
+      - '.github/workflows/deploy-examples.yml'
+  workflow_dispatch:
+
+env:
+  AWS_REGION: us-west-2
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    outputs:
+      function-name-map: ${{ steps.deploy-functions.outputs.function-name-map }}
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Setup Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.13'
+
+    - name: Configure AWS credentials
+      if: github.event_name != 'workflow_dispatch' || github.actor != 'nektos/act'
+      uses: aws-actions/configure-aws-credentials@v4
+      with:
+        role-to-assume: "${{ secrets.ACTIONS_INTEGRATION_ROLE_NAME }}"
+        role-session-name: githubIntegrationTest
+        aws-region: ${{ env.AWS_REGION }}
+
+    - name: Install Hatch
+      run: pip install hatch
+
+    - name: Build examples
+      run: hatch run examples:build
+
+    - name: Deploy functions
+      id: deploy-functions
+      env:
+        AWS_ACCOUNT_ID: ${{ secrets.AWS_ACCOUNT_ID }}
+        LAMBDA_ENDPOINT: ${{ secrets.LAMBDA_ENDPOINT }}
+        INVOKE_ACCOUNT_ID: ${{ secrets.INVOKE_ACCOUNT_ID }}
+        KMS_KEY_ARN: ${{ secrets.KMS_KEY_ARN }}
+        GITHUB_EVENT_NAME: ${{ github.event_name }}
+        GITHUB_EVENT_NUMBER: ${{ github.event.number }}
+      run: |
+        # Read examples catalog and deploy each function
+        FUNCTION_NAME_MAP="{}"
+        
+        for example in $(jq -r '.examples[] | select(.integration == true) | .handler' examples/examples-catalog.json); do
+          EXAMPLE_NAME=$(echo $example | sed 's/\.handler$//')
+          
+          if [ "$GITHUB_EVENT_NAME" = "pull_request" ]; then
+            FUNCTION_NAME="${EXAMPLE_NAME}-Python-PR-$GITHUB_EVENT_NUMBER"
+          else
+            FUNCTION_NAME="${EXAMPLE_NAME}-Python"
+          fi
+          
+          echo "Deploying $EXAMPLE_NAME as $FUNCTION_NAME"
+          hatch run examples:deploy "$EXAMPLE_NAME" "$FUNCTION_NAME"
+          
+          # Add to function name map
+          FUNCTION_NAME_MAP=$(echo $FUNCTION_NAME_MAP | jq --arg key "$EXAMPLE_NAME" --arg value "$FUNCTION_NAME" '. + {($key): $value}')
+        done
+        
+        echo "function-name-map=$FUNCTION_NAME_MAP" >> $GITHUB_OUTPUT
+        echo "Function name map: $FUNCTION_NAME_MAP"
+
+  cleanup:
+    needs: [deploy]
+    runs-on: ubuntu-latest
+    if: always()
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Setup Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.13'
+
+    - name: Configure AWS credentials
+      if: github.event_name != 'workflow_dispatch' || github.actor != 'nektos/act'
+      uses: aws-actions/configure-aws-credentials@v4
+      with:
+        role-to-assume: "${{ secrets.ACTIONS_INTEGRATION_ROLE_NAME }}"
+        role-session-name: githubIntegrationTest
+        aws-region: ${{ env.AWS_REGION }}
+
+    - name: Install Hatch
+      run: pip install hatch
+
+    - name: Cleanup Lambda functions
+      env:
+        LAMBDA_ENDPOINT: ${{ secrets.LAMBDA_ENDPOINT }}
+        FUNCTION_NAME_MAP: ${{ needs.deploy.outputs.function-name-map }}
+      run: |
+        # Delete deployed functions
+        echo "Cleaning up functions: $FUNCTION_NAME_MAP"
+        
+        for function_name in $(echo $FUNCTION_NAME_MAP | jq -r '.[]'); do
+          echo "Deleting function: $function_name"
+          aws lambda delete-function --function-name "$function_name" --endpoint-url "$LAMBDA_ENDPOINT" --region "$AWS_REGION" || true
+        done

examples/.env.template

@@ -0,0 +1,6 @@
+# AWS Configuration for Lambda Deployment
+AWS_REGION=us-west-2
+AWS_ACCOUNT_ID=123456789012
+LAMBDA_ENDPOINT=https://lambda.us-west-2.amazonaws.com
+INVOKE_ACCOUNT_ID=123456789012
+KMS_KEY_ARN=arn:aws:kms:us-west-2:123456789012:key/12345678-1234-1234-1234-123456789012

examples/.gitignore

@@ -0,0 +1,4 @@
+build/
+*.zip
+.env
+.aws-sam/

examples/README.md

@@ -0,0 +1,44 @@
+# Python Durable Functions Examples
+
+## Local Testing with SAM
+
+Test functions locally:
+```bash
+sam local invoke HelloWorldFunction
+```
+
+Test with custom event:
+```bash
+sam local invoke HelloWorldFunction -e event.json
+```
+
+## Deploy Functions
+
+Deploy with Python script:
+```bash
+python3 deploy.py hello_world
+```
+
+Deploy with SAM:
+```bash
+sam build
+sam deploy --guided
+```
+
+## Environment Variables
+
+- `AWS_ACCOUNT_ID`: Your AWS account ID
+- `LAMBDA_ENDPOINT`: Your Lambda service endpoint  
+- `INVOKE_ACCOUNT_ID`: Account ID allowed to invoke functions
+- `AWS_REGION`: AWS region (default: us-west-2)
+- `KMS_KEY_ARN`: KMS key for encryption (optional)
+
+## Available Examples
+
+- **hello_world**: Simple hello world function
+
+## Adding New Examples
+
+1. Add your Python function to `src/`
+2. Update `examples-catalog.json` and `template.yaml`
+3. Deploy using either script above

examples/build.py

@@ -0,0 +1,49 @@
+#!/usr/bin/env python3
+
+import shutil
+import site
+from pathlib import Path
+
+
+def build():
+    """Build examples with SDK dependencies from current environment."""
+    examples_dir = Path(__file__).parent
+    build_dir = examples_dir / "build"
+    
+    # Clean build directory
+    if build_dir.exists():
+        shutil.rmtree(build_dir)
+    build_dir.mkdir()
+    
+    print("Copying SDK from current environment...")
+    
+    # Copy the SDK from current environment (hatch installs it)
+    for site_dir in site.getsitepackages():
+        sdk_path = Path(site_dir) / "aws_durable_execution_sdk_python"
+        if sdk_path.exists():
+            shutil.copytree(sdk_path, build_dir / "aws_durable_execution_sdk_python")
+            print(f"Copied SDK from {sdk_path}")
+            break
+    else:
+        print("SDK not found in site-packages")
+    
+    print("Copying testing SDK source...")
+    
+    # Copy testing SDK source
+    sdk_src = examples_dir.parent / "src" / "aws_durable_execution_sdk_python_testing"
+    if sdk_src.exists():
+        shutil.copytree(sdk_src, build_dir / "aws_durable_execution_sdk_python_testing")
+    
+    print("Copying example functions...")
+    
+    # Copy example source files
+    src_dir = examples_dir / "src"
+    for py_file in src_dir.glob("*.py"):
+        if py_file.name != "__init__.py":
+            shutil.copy2(py_file, build_dir)
+    
+    print(f"Build complete: {build_dir}")
+
+
+if __name__ == "__main__":
+    build()