What is the recommended test coverage for Temporal applications?

Temporal best practices suggest maintaining at least 80% logic coverage for both workflows and activities, supplemented by integration tests for critical execution paths.

Can I test activities in isolation from workflows?

Yes, you can use the ActivityEnvironment provided by the Temporal Python SDK to run and test individual activities locally without the overhead of a full workflow or worker.

When should I use replay testing?

Replay testing is essential when modifying existing workflow code. It validates that your changes don't violate determinism by replaying old execution histories against the new code version.

How does time-skipping work in Temporal Python tests?

Time-skipping uses the WorkflowEnvironment.start_time_skipping() method to automatically advance the test clock whenever the workflow is blocked, allowing tests for long-running processes to complete in milliseconds.

Temporal Python Testing

Name: Temporal Python Testing
Author: HermeticOrmus

byHermeticOrmus

0•

Security & Testing

Implements comprehensive testing strategies for Temporal workflows and activities using pytest and advanced time-skipping techniques.

This skill provides specialized guidance for testing Temporal applications in Python, ensuring workflow determinism and logic reliability through structured patterns. It enables developers to leverage time-skipping for testing long-running processes in seconds, implement robust activity mocking, and perform replay testing to prevent non-determinism errors in production. By integrating with pytest and providing local development configurations, this skill streamlines the creation of high-coverage test suites for distributed systems.

Key Features

01Integration-ready pytest fixtures and async patterns

02Local development setup with Docker Compose and coverage tools

03Determinism validation through production history replay

04Time-skipping for rapid execution of long-running workflows

05Activity mocking strategies for isolated workflow logic testing

060 GitHub stars

Use Cases

01Validating workflow determinism before deploying logic updates

02Testing multi-month business processes in seconds via time-skipping

03Setting up automated CI/CD pipelines for Temporal Python services

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hermeticormus/floraheritage temporal-python-testing

For use in Claude.ai and ChatGPT

Download Skill