temporal-python-testing

Automate deterministic Temporal Python workflow tests with pytest and time-skipping.

3|2|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/wesleyegberto/software-engineering-skills --skill temporal-python-testing-wesleyegberto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: temporal-python-testing
Source: https://github.com/wesleyegberto/software-engineering-skills/tree/main/plugins/python/skills/temporal-python-testing
Command: npx skills add https://github.com/wesleyegberto/software-engineering-skills --skill temporal-python-testing-wesleyegberto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Temporal Python testing is often slow, brittle, and hard to reproduce; this skill provides structured guidance for fast, deterministic tests using pytest, time-skipping, and mocks to validate Temporal workflows.

Core Features & Use Cases

  • Deterministic unit, integration, and replay testing patterns for Temporal workflows
  • Time-skipping and mock strategies to speed up feedback cycles
  • Local development setup and resource references to support Python Temporal testing

Quick Start

Create a time-skipping workflow test using Temporal's Python SDK and run it with pytest to verify deterministic behavior.

Frequently Asked Questions about temporal-python-testing

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

FAQPage Schema
How do I write deterministic tests for Temporal Python workflows?

Deterministic Temporal Python workflow testing uses pytest with time-skipping and mocks to validate workflow code without waiting for real timers. It structures unit, integration, and replay tests to ensure fast, reproducible feedback cycles.

Why are my Temporal Python workflow tests slow and flaky?

Temporal Python workflow tests become slow and flaky when relying on real time progression. Using time-skipping utilities and mock strategies eliminates actual delays, making workflow tests deterministic and fast for reliable local development.

What is time-skipping in Temporal testing and when do I need it?

Time-skipping in Temporal testing accelerates workflow execution by jumping past sleep timers instantly. It is needed when validating long-running Temporal Python workflows to achieve fast, deterministic unit and integration tests without real time delays.

Does pytest work with Temporal Python SDK for workflow testing?

Yes, pytest integrates with the Temporal Python SDK to run deterministic workflow tests. Combined with time-skipping utilities and mocking, pytest enables structured unit, integration, and replay testing for validating workflow behavior locally.

What's the best way to mock activities in Temporal Python workflow tests?

Mocking activities in Temporal Python workflow tests is best done using time-skipping and mock strategies within pytest. This approach isolates workflow logic from external dependencies, enabling fast, deterministic replay and integration testing.

What are the limitations of time-skipping for Temporal Python testing?

Time-skipping for Temporal Python testing is limited to validating workflow logic deterministically within the SDK's test environment. It does not test real external integrations, requiring separate local development resources for end-to-end validation.