temporal-python-testing

1# Temporal Python Testing Strategies
2 
3Comprehensive testing approaches for Temporal workflows using pytest, progressive disclosure resources for specific testing scenarios.
4 
5## When to Use This Skill
6 
7- **Unit testing workflows** - Fast tests with time-skipping
8- **Integration testing** - Workflows with mocked activities
9- **Replay testing** - Validate determinism against production histories
10- **Local development** - Set up Temporal server and pytest
11- **CI/CD integration** - Automated testing pipelines
12- **Coverage strategies** - Achieve ≥80% test coverage
13 
14## Testing Philosophy
15 
16**Recommended Approach** (Source: docs.temporal.io/develop/python/testing-suite):
17 
18- Write majority as integration tests
19- Use pytest with async fixtures
20- Time-skipping enables fast feedback (month-long workflows → seconds)
21- Mock activities to isolate workflow logic
22- Validate determinism with replay testing
23 
24**Three Test Types**:
25 
261. **Unit**: Workflows with time-skipping, activities with ActivityEnvironment
272. **Integration**: Workers with mocked activities
283. **End-to-end**: Full Temporal server with real activities (use sparingly)
29 
30## Available Resources
31 
32This skill provides detailed guidance through progressive disclosure. Load specific resources based on your testing needs:
33 
34### Unit Testing Resources
35 
36**File**: `resources/unit-testing.md`
37**When to load**: Testing individual workflows or activities in isolation
38**Contains**:
39 
40- WorkflowEnvironment with time-skipping
41…