temporal-python-testing

Temporal Python Testing Strategies

Comprehensive testing approaches for Temporal workflows using pytest, progressive disclosure resources for specific testing scenarios.

Do not use this skill when

Instructions

Use this skill when

Testing Philosophy

Recommended Approach (Source: docs.temporal.io/develop/python/testing-suite):

Three Test Types:

Available Resources

This skill provides detailed guidance through progressive disclosure. Load specific resources based on your testing needs:

Unit Testing Resources

File: resources/unit-testing.md

When to load: Testing individual workflows or activities in isolation

Contains:

Integration Testing Resources

File: resources/integration-testing.md

When to load: Testing workflows with mocked external dependencies

Contains:

Replay Testing Resources

File: resources/replay-testing.md

When to load: Validating determinism or deploying workflow changes

Contains:

Local Development Resources

File: resources/local-setup.md

When to load: Setting up development environment

Contains:

Quick Start Guide

Basic Workflow Test

import pytest
from temporalio.testing import WorkflowEnvironment
from temporalio.worker import Worker

@pytest.fixture
async def workflow_env():
    env = await WorkflowEnvironment.start_time_skipping()
    yield env
    await env.shutdown()

@pytest.mark.asyncio
async def test_workflow(workflow_env):
    async with Worker(
        workflow_env.client,
        task_queue="test-queue",
        workflows=[YourWorkflow],
        activities=[your_activity],
    ):
        result = await workflow_env.client.execute_workflow(
            YourWorkflow.run,
            args,
            id="test-wf-id",
            task_queue="test-queue",
        )
        assert result == expected

Basic Activity Test

from temporalio.testing import ActivityEnvironment

async def test_activity():
    env = ActivityEnvironment()
    result = await env.run(your_activity, "test-input")
    assert result == expected_output

Coverage Targets

Recommended Coverage (Source: docs.temporal.io best practices):

Key Testing Principles

How to Use Resources

Load specific resource when needed:

Additional References