temporal-python-testing

Test Temporal Python workflows deterministically with pytest and time-skipping.

4|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/AI-Foundry-Core/ril-agents --skill temporal-python-testing-ai-foundry-core
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: temporal-python-testing
Source: https://github.com/AI-Foundry-Core/ril-agents/tree/main/plugins/backend-development/skills/temporal-python-testing
Command: npx skills add https://github.com/AI-Foundry-Core/ril-agents --skill temporal-python-testing-ai-foundry-core

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Temporal workflow tests can be slow and flaky; this skill provides deterministic, fast tests via time-skipping and mocks.

Core Features & Use Cases

  • Time-skipping for fast, deterministic tests
  • Progressive-disclosure resources for targeted testing patterns (unit, integration, replay)
  • Local development workflows with pytest and Temporal Python SDK

Quick Start

Install and run Temporal Python testing workflows locally with time-skipping, using pytest and the Temporal SDK to validate 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 test Temporal workflows deterministically without waiting for timers?

Deterministic Temporal workflow testing uses time-skipping to automatically advance timers, ensuring tests run fast without flaky sleep delays. This approach validates workflow logic instantly by mocking time progression within the test environment.

Why are my Temporal workflow tests flaky and slow during local development?

Temporal workflow tests become flaky and slow when relying on real-time execution and external services. Using time-skipping and mocking eliminates external dependencies, providing fast, deterministic test results for local development workflows.

Can I use pytest with the Temporal Python SDK for workflow testing?

Yes, you can use pytest with the Temporal Python SDK to validate workflow behavior. This combination supports setting up test environments and applying time-skipping simulations to ensure deterministic, fast workflow execution during unit and integration testing.

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

Time-skipping in Temporal testing is a mechanism that fast-forwards workflow timers to completion instantly. You need it when testing long-running workflows to achieve fast, deterministic test execution without modifying the underlying workflow logic.

What's the best way to mock activities for Temporal workflow unit tests?

The best way to mock activities for Temporal workflow unit tests is by using a test environment that supports progressive disclosure patterns. This allows you to inject deterministic mocks, ensuring consistent workflow logic validation across unit, integration, and replay scenarios.