lambda-forge-cli-aws 1.0.0__py3-none-any.whl

templates/python-api/{{cookiecutter.project_slug}}/src/utils/logger.py

@@ -0,0 +1,39 @@
+"""Structured logger utilities."""
+from __future__ import annotations
+
+import json
+import logging
+from typing import Any
+
+logger = logging.getLogger()
+logger.setLevel(logging.INFO)
+
+
+def log_event(event_type: str, **kwargs: Any) -> None:
+    """Log a structured event as JSON.
+
+    Args:
+        event_type: A short identifier for the event
+        **kwargs: Additional fields to log
+    """
+    payload = {"type": event_type, **kwargs}
+    logger.info(json.dumps(payload))
+
+
+def log_error(error: Exception, context: dict[str, Any] | None = None) -> None:
+    """Log an error with full context.
+
+    Args:
+        error: The exception
+        context: Optional context dict
+    """
+    import traceback
+
+    payload = {
+        "type": "error",
+        "error_type": type(error).__name__,
+        "error_message": str(error),
+        "traceback": traceback.format_exc(),
+        "context": context or {},
+    }
+    logger.error(json.dumps(payload))

templates/python-api/{{cookiecutter.project_slug}}/tests/conftest.py

@@ -0,0 +1,22 @@
+"""Test configuration and fixtures."""
+from __future__ import annotations
+
+import os
+
+import pytest
+
+
+@pytest.fixture(autouse=True)
+def aws_credentials(monkeypatch):
+    """Mock AWS credentials for moto."""
+    monkeypatch.setenv("AWS_ACCESS_KEY_ID", "testing")
+    monkeypatch.setenv("AWS_SECRET_ACCESS_KEY", "testing")
+    monkeypatch.setenv("AWS_SECURITY_TOKEN", "testing")
+    monkeypatch.setenv("AWS_SESSION_TOKEN", "testing")
+    monkeypatch.setenv("AWS_DEFAULT_REGION", "us-east-1")
+
+
+@pytest.fixture
+def table_name():
+    """Provide a test table name."""
+    return os.environ.get("TABLE_NAME", "test-table")

templates/python-api/{{cookiecutter.project_slug}}/tests/test_handler.py

@@ -0,0 +1,68 @@
+"""Tests for {{ cookiecutter.project_name }} Lambda handler."""
+from __future__ import annotations
+
+import json
+from unittest.mock import MagicMock
+
+import pytest
+
+from src.handler import handler
+
+
+@pytest.fixture
+def api_gateway_event():
+    """Sample API Gateway GET event."""
+    return {
+        "httpMethod": "GET",
+        "path": "/health",
+        "headers": {},
+        "multiValueHeaders": {},
+        "queryStringParameters": None,
+        "pathParameters": None,
+        "stageVariables": None,
+        "requestContext": {
+            "requestId": "test-request-id",
+            "stage": "test",
+        },
+        "body": None,
+        "isBase64Encoded": False,
+    }
+
+
+def test_health_check(api_gateway_event):
+    """Test the health check endpoint returns 200."""
+    context = MagicMock()
+    context.function_name = "test-function"
+    context.aws_request_id = "test-request-id"
+
+    response = handler(api_gateway_event, context)
+
+    assert response["statusCode"] == 200
+    body = json.loads(response["body"])
+    assert body["status"] == "ok"
+
+
+def test_list_items_without_table(api_gateway_event):
+    """Test listing items when TABLE_NAME is not set."""
+    api_gateway_event["path"] = "/items"
+    api_gateway_event["httpMethod"] = "GET"
+
+    context = MagicMock()
+    response = handler(api_gateway_event, context)
+
+    assert response["statusCode"] == 200
+    body = json.loads(response["body"])
+    assert "items" in body
+    assert body["count"] == 0
+
+
+def test_create_item_missing_name(api_gateway_event):
+    """Test creating an item without name returns 400."""
+    api_gateway_event["path"] = "/items"
+    api_gateway_event["httpMethod"] = "POST"
+    api_gateway_event["body"] = json.dumps({"description": "no name"})
+
+    context = MagicMock()
+    response = handler(api_gateway_event, context)
+
+    assert response["statusCode"] == 400

templates/python-cron/cookiecutter.json

@@ -0,0 +1,13 @@
+{
+  "project_name": "my-cron-job",
+  "project_slug": "{{ cookiecutter.project_name|replace('-', '_') }}",
+  "module_name": "{{ cookiecutter.project_slug }}",
+  "description": "Scheduled Lambda triggered by EventBridge",
+  "author_name": "LambdaForge User",
+  "author_email": "user@example.com",
+  "runtime": "python3.12",
+  "aws_region": "us-east-1",
+  "memory_mb": 512,
+  "timeout_seconds": 300,
+  "schedule_expression": "rate(5 minutes)"
+}

templates/python-cron/{{cookiecutter.project_slug}}/.gitignore

@@ -0,0 +1,65 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+
+# Type checking
+.mypy_cache/
+.ruff_cache/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+
+# CDK
+cdk.out/
+cdk.context.json
+
+# Lambda
+*.zip
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Secrets
+*.pem
+*.key
+secrets.yml

templates/python-cron/{{cookiecutter.project_slug}}/Dockerfile

@@ -0,0 +1,11 @@
+FROM public.ecr.aws/lambda/python:3.12-arm64
+
+# Install dependencies first for better layer caching
+COPY requirements.txt ${LAMBDA_TASK_ROOT}/
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy function code
+COPY src/ ${LAMBDA_TASK_ROOT}/
+
+# Set the handler
+CMD [ "handler.handler" ]

templates/python-cron/{{cookiecutter.project_slug}}/infrastructure/app.js

@@ -0,0 +1,25 @@
+const cdk = require('aws-cdk-lib');
+const { {{ cookiecutter.project_name|replace('-', '')|capitalize }}Stack } = require('./lib/stack');
+
+const app = new cdk.App();
+
+// Environment from CDK context (default: dev)
+const envName = app.node.tryGetContext('env') || 'dev';
+
+new {{ cookiecutter.project_name|replace('-', '')|capitalize }}Stack(app, `{{ cookiecutter.project_name }}-${envName}`, {
+  stackName: `{{ cookiecutter.project_name }}-${envName}`,
+  env: {
+    account: process.env.CDK_DEFAULT_ACCOUNT,
+    region: process.env.CDK_DEFAULT_REGION || '{{ cookiecutter.aws_region }}',
+  },
+  description: `{{ cookiecutter.description }} (${envName})`,
+  tags: {
+    Project: '{{ cookiecutter.project_name }}',
+    Environment: envName,
+    ManagedBy: 'LambdaForge',
+    CostCenter: '{{ cookiecutter.project_name }}',
+  },
+  envName: envName,
+});
+
+app.synth();

templates/python-cron/{{cookiecutter.project_slug}}/infrastructure/cdk.json

@@ -0,0 +1,3 @@
+{
+  "app": "node app.js"
+}

templates/python-cron/{{cookiecutter.project_slug}}/infrastructure/lib/stack.js

@@ -0,0 +1,55 @@
+const cdk = require('aws-cdk-lib');
+const lambda = require('aws-cdk-lib/aws-lambda');
+const events = require('aws-cdk-lib/aws-events');
+const targets = require('aws-cdk-lib/aws-events-targets');
+const dynamodb = require('aws-cdk-lib/aws-dynamodb');
+const logs = require('aws-cdk-lib/aws-logs');
+const sqs = require('aws-cdk-lib/aws-sqs');
+
+class {{ cookiecutter.project_name|replace('-', '')|capitalize }}Stack extends cdk.Stack {
+  constructor(scope, id, props) {
+    super(scope, id, props);
+    const envName = props.envName || 'dev';
+
+    const table = new dynamodb.Table(this, 'RunHistoryTable', {
+      partitionKey: { name: 'id', type: dynamodb.AttributeType.STRING },
+      billingMode: dynamodb.BillingMode.PAY_PER_REQUEST,
+      removalPolicy: cdk.RemovalPolicy.DESTROY,
+    });
+
+    const dlq = new sqs.Queue(this, 'DLQ', { retentionPeriod: cdk.Duration.days(14) });
+
+    const fn = new lambda.Function(this, 'CronFunction', {
+      runtime: lambda.Runtime.PYTHON_3_12,
+      architecture: lambda.Architecture.ARM_64,
+      handler: 'handler.handler',
+      code: lambda.Code.fromAsset('../src'),
+      memorySize: {{ cookiecutter.memory_mb }},
+      timeout: cdk.Duration.seconds({{ cookiecutter.timeout_seconds }}),
+      tracing: lambda.Tracing.ACTIVE,
+      deadLetterQueue: dlq,
+      retryAttempts: 2,
+      environment: {
+        TABLE_NAME: table.tableName,
+        STAGE: envName,
+        POWERTOOLS_SERVICE_NAME: '{{ cookiecutter.project_slug }}',
+      },
+    });
+
+    table.grantReadWriteData(fn);
+
+    new events.Rule(this, 'ScheduleRule', {
+      schedule: events.Schedule.expression('{{ cookiecutter.schedule_expression }}'),
+      targets: [new targets.LambdaFunction(fn)],
+    });
+
+    cdk.Tags.of(this).add('Project', '{{ cookiecutter.project_name }}');
+    cdk.Tags.of(this).add('ManagedBy', 'LambdaForge');
+    cdk.Tags.of(this).add('Environment', envName);
+
+    new cdk.CfnOutput(this, 'FunctionName', { value: fn.functionName });
+    new cdk.CfnOutput(this, 'TableName', { value: table.tableName });
+  }
+}
+
+module.exports = { {{ cookiecutter.project_name|replace('-', '')|capitalize }}Stack };

templates/python-cron/{{cookiecutter.project_slug}}/infrastructure/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "{{ cookiecutter.project_slug }}-infrastructure",
+  "version": "0.1.0",
+  "description": "AWS CDK infrastructure for {{ cookiecutter.project_name }}",
+  "private": true,
+  "scripts": {
+    "cdk": "cdk",
+    "synth": "cdk synth",
+    "deploy": "cdk deploy --require-approval never",
+    "destroy": "cdk destroy --force",
+    "diff": "cdk diff"
+  },
+  "dependencies": {
+    "aws-cdk-lib": "^2.170.0",
+    "constructs": "^10.4.0"
+  }
+}

templates/python-cron/{{cookiecutter.project_slug}}/pyproject.toml

@@ -0,0 +1,56 @@
+[project]
+name = "{{ cookiecutter.project_slug }}"
+version = "0.1.0"
+description = "{{ cookiecutter.description }}"
+authors = [
+    {name = "{{ cookiecutter.author_name }}", email = "{{ cookiecutter.author_email }}"}
+]
+readme = "README.md"
+requires-python = ">=3.12"
+license = {text = "MIT"}
+keywords = ["aws", "lambda", "serverless", "cron", "scheduled"]
+
+dependencies = [
+    "aws-lambda-powertools[tracer,logger]>=3.0.0",
+    "boto3>=1.34.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-cov>=4.1.0",
+    "moto[dynamodb]>=5.0.0",
+    "ruff>=0.1.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]
+addopts = "-v --strict-markers --cov=src --cov-report=term-missing"
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "N", "S", "RUF"]
+ignore = ["S101"]
+
+[tool.coverage.run]
+source = ["src"]
+omit = ["tests/*"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "if __name__ == .__main__.:",
+    "raise NotImplementedError",
+]

templates/python-cron/{{cookiecutter.project_slug}}/requirements.txt

@@ -0,0 +1,2 @@
+aws-lambda-powertools[tracer,logger]>=3.0.0
+boto3>=1.34.0

templates/python-cron/{{cookiecutter.project_slug}}/src/handler.py

@@ -0,0 +1,53 @@
+"""{{ cookiecutter.project_name }} — Scheduled Lambda handler.
+
+Triggered by EventBridge Schedule ({{ cookiecutter.schedule_expression }}).
+"""
+from __future__ import annotations
+
+import os
+from datetime import UTC, datetime
+from typing import Any
+
+import boto3
+from aws_lambda_powertools import Logger, Tracer
+from aws_lambda_powertools.utilities.typing import LambdaContext
+
+logger = Logger(service="{{ cookiecutter.project_slug }}")
+tracer = Tracer(service="{{ cookiecutter.project_slug }}")
+
+TABLE_NAME = os.environ.get("TABLE_NAME", "")
+STAGE = os.environ.get("STAGE", "dev")
+
+dynamodb = boto3.resource("dynamodb")
+
+
+@tracer.capture_method
+def run_job() -> dict[str, Any]:
+    """Main job logic — replace with your business logic."""
+    now = datetime.now(UTC)
+    logger.info("job_started", extra={"timestamp": now.isoformat()})
+
+    result = {
+        "status": "completed",
+        "executed_at": now.isoformat(),
+        "items_processed": 0,
+    }
+
+    if TABLE_NAME:
+        table = dynamodb.Table(TABLE_NAME)
+        table.put_item(Item={"id": f"run#{now.strftime('%Y%m%d-%H%M%S')}", **result})
+
+    logger.info("job_completed", extra=result)
+    return result
+
+
+@logger.inject_lambda_context
+@tracer.capture_lambda_handler
+def handler(event: dict, context: LambdaContext) -> dict[str, Any]:
+    """Lambda handler — triggered by EventBridge schedule."""
+    try:
+        result = run_job()
+        return {"statusCode": 200, "body": result}
+    except Exception:
+        logger.exception("job_failed")
+        return {"statusCode": 500, "body": {"error": "Job failed"}}

templates/python-cron/{{cookiecutter.project_slug}}/tests/conftest.py

@@ -0,0 +1,22 @@
+"""Test configuration and fixtures."""
+from __future__ import annotations
+
+import os
+
+import pytest
+
+
+@pytest.fixture(autouse=True)
+def aws_credentials(monkeypatch):
+    """Mock AWS credentials for moto."""
+    monkeypatch.setenv("AWS_ACCESS_KEY_ID", "testing")
+    monkeypatch.setenv("AWS_SECRET_ACCESS_KEY", "testing")
+    monkeypatch.setenv("AWS_SECURITY_TOKEN", "testing")
+    monkeypatch.setenv("AWS_SESSION_TOKEN", "testing")
+    monkeypatch.setenv("AWS_DEFAULT_REGION", "us-east-1")
+
+
+@pytest.fixture
+def table_name():
+    """Provide a test table name."""
+    return os.environ.get("TABLE_NAME", "test-table")

templates/python-cron/{{cookiecutter.project_slug}}/tests/test_handler.py

@@ -0,0 +1,48 @@
+"""Tests for {{ cookiecutter.project_name }} scheduled Lambda handler."""
+from __future__ import annotations
+
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+from src.handler import handler
+
+
+@pytest.fixture
+def scheduled_event():
+    """Sample EventBridge scheduled event."""
+    return {
+        "version": "0",
+        "id": "test-event-id",
+        "detail-type": "Scheduled Event",
+        "source": "aws.events",
+        "time": "2024-01-01T00:00:00Z",
+        "region": "us-east-1",
+        "resources": ["arn:aws:events:us-east-1:123456789012:rule/test-rule"],
+        "detail": {},
+    }
+
+
+def test_handler_invocation(scheduled_event):
+    """Test scheduled handler executes without error."""
+    context = MagicMock()
+    context.function_name = "test-function"
+    context.aws_request_id = "test-request-id"
+
+    with patch("src.handler.dynamodb"):
+        response = handler(scheduled_event, context)
+
+    assert response["statusCode"] == 200
+    assert response["body"]["status"] == "completed"
+
+
+def test_handler_returns_execution_timestamp(scheduled_event):
+    """Test that handler response includes execution timestamp."""
+    context = MagicMock()
+    context.function_name = "test-function"
+    context.aws_request_id = "test-request-id"
+
+    with patch("src.handler.dynamodb"):
+        response = handler(scheduled_event, context)
+
+    assert "executed_at" in response["body"]

templates/python-queue/cookiecutter.json

@@ -0,0 +1,12 @@
+{
+  "project_name": "my-queue-processor",
+  "project_slug": "{{ cookiecutter.project_name|replace('-', '_') }}",
+  "module_name": "{{ cookiecutter.project_slug }}",
+  "description": "SQS queue processor Lambda with partial batch response",
+  "author_name": "LambdaForge User",
+  "author_email": "user@example.com",
+  "runtime": "python3.12",
+  "aws_region": "us-east-1",
+  "memory_mb": 1024,
+  "timeout_seconds": 60
+}

templates/python-queue/{{cookiecutter.project_slug}}/.gitignore

@@ -0,0 +1,65 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+
+# Type checking
+.mypy_cache/
+.ruff_cache/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+
+# CDK
+cdk.out/
+cdk.context.json
+
+# Lambda
+*.zip
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Secrets
+*.pem
+*.key
+secrets.yml

templates/python-queue/{{cookiecutter.project_slug}}/Dockerfile

@@ -0,0 +1,11 @@
+FROM public.ecr.aws/lambda/python:3.12-arm64
+
+# Install dependencies first for better layer caching
+COPY requirements.txt ${LAMBDA_TASK_ROOT}/
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy function code
+COPY src/ ${LAMBDA_TASK_ROOT}/
+
+# Set the handler
+CMD [ "handler.handler" ]

templates/python-queue/{{cookiecutter.project_slug}}/infrastructure/app.js

@@ -0,0 +1,25 @@
+const cdk = require('aws-cdk-lib');
+const { {{ cookiecutter.project_name|replace('-', '')|capitalize }}Stack } = require('./lib/stack');
+
+const app = new cdk.App();
+
+// Environment from CDK context (default: dev)
+const envName = app.node.tryGetContext('env') || 'dev';
+
+new {{ cookiecutter.project_name|replace('-', '')|capitalize }}Stack(app, `{{ cookiecutter.project_name }}-${envName}`, {
+  stackName: `{{ cookiecutter.project_name }}-${envName}`,
+  env: {
+    account: process.env.CDK_DEFAULT_ACCOUNT,
+    region: process.env.CDK_DEFAULT_REGION || '{{ cookiecutter.aws_region }}',
+  },
+  description: `{{ cookiecutter.description }} (${envName})`,
+  tags: {
+    Project: '{{ cookiecutter.project_name }}',
+    Environment: envName,
+    ManagedBy: 'LambdaForge',
+    CostCenter: '{{ cookiecutter.project_name }}',
+  },
+  envName: envName,
+});
+
+app.synth();

templates/python-queue/{{cookiecutter.project_slug}}/infrastructure/cdk.json

@@ -0,0 +1,3 @@
+{
+  "app": "node app.js"
+}