temporal-python-testing

Test Temporal Python SDK workflows and activities with pytest.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ACGSpgp/ACGS --skill temporal-python-testing-acgspgp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: temporal-python-testing
Source: https://github.com/ACGSpgp/ACGS/tree/main/.agent/workflows/backend-development/1.2.3/skills/temporal-python-testing
Command: npx skills add https://github.com/ACGSpgp/ACGS --skill temporal-python-testing-acgspgp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill streamlines the process of testing Temporal workflows and activities written in Python, ensuring reliability and correctness through various testing strategies.

Core Features & Use Cases

  • Unit Testing: Write fast, isolated tests for workflows and activities using time-skipping and mock environments.
  • Integration Testing: Test workflows with mocked external dependencies and verify complex orchestration logic.
  • Replay Testing: Ensure backward compatibility and determinism by replaying production event histories.
  • Local Development Setup: Configure a local Temporal environment for seamless testing.
  • Use Case: You've just updated a Temporal workflow and need to ensure it still functions correctly with existing production data and doesn't introduce regressions. This Skill provides the tools and guidance to perform thorough replay testing.

Quick Start

Use the temporal-python-testing skill to set up a local Temporal development environment with pytest.

Frequently Asked Questions about temporal-python-testing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test Temporal Python workflows and activities with pytest?

Test Temporal Python workflows and activities with pytest by leveraging time-skipping and mock environments. This approach isolates workflow logic and verifies complex orchestration behavior without waiting for real time to pass.

How does replay testing work for Temporal workflows?

Replay testing for Temporal workflows works by replaying production event histories against your updated workflow code. This ensures backward compatibility and determinism, verifying that new code changes process existing production data without introducing regressions.

Can I set up a local Temporal environment for integration testing?

Yes, you can set up a local Temporal environment for integration testing using Docker Compose. This allows you to test workflows with mocked external dependencies and verify complex orchestration logic seamlessly before deployment.

What is time-skipping in Temporal unit testing?

Time-skipping in Temporal unit testing is a mechanism that fast-forwards simulated time during workflow execution. It allows tests to instantly complete long-running workflows and validate time-dependent logic without delaying the test suite.

Why does my Temporal workflow fail replay testing after an update?

Temporal workflow replay testing fails after an update due to non-deterministic changes in the workflow code. Replay testing enforces backward compatibility by checking new code against production histories, failing when event sequences mismatch.