temporal-python-testing

Validate Temporal workflows with pytest, time-skipping, and mocking strategies.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/leonardoteodoroo/amino-advanced --skill temporal-python-testing-leonardoteodoroo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: temporal-python-testing
Source: https://github.com/leonardoteodoroo/amino-advanced/tree/main/.agent/skills/temporal-python-testing
Command: npx skills add https://github.com/leonardoteodoroo/amino-advanced --skill temporal-python-testing-leonardoteodoroo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Temporal workflow testing can be slow and brittle without deterministic techniques. This skill provides structured guidance to test Temporal workflows using pytest, time-skipping, and activity/workflow mocking strategies.

Core Features & Use Cases

  • Unit testing with time-skipping: Run long-running workflows quickly.
  • Integration & replay testing: Validate determinism with mocked activities and live server contexts.
  • Local development setup: Set up Temporal server and pytest configuration for fast feedback loops.
  • Use Case: Apply when implementing Temporal workflows or debugging test failures.

Quick Start

Install dependencies, start a Temporal server locally, and run pytest with unit and integration markers to exercise time-skipping and mocked activities.

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 with pytest using time-skipping?

To test Temporal workflows with pytest using time-skipping, you apply deterministic testing techniques that mock activities and manipulate time, allowing long-running workflows to execute quickly. This approach validates workflow logic without waiting for real time to pass.

What is the best way to set up a local Temporal server for pytest testing?

Setting up a local Temporal server for pytest testing involves starting a local server instance and configuring pytest with unit and integration markers. This creates a fast feedback loop for exercising time-skipping and mocked activities during local development.

How do I mock activities in Temporal Python workflows for integration testing?

Mocking activities in Temporal Python workflows for integration testing requires injecting mocked activity implementations into the workflow context. This validates workflow determinism against live server contexts while isolating external dependencies.

Can I use pytest markers to separate Temporal unit and integration tests?

Yes, you can use pytest markers to separate Temporal unit and integration tests. By applying markers, you can selectively run unit tests with time-skipping or integration and replay tests against a live server, ensuring fast and targeted feedback loops.

Why are my Temporal workflow tests brittle and slow without time-skipping?

Temporal workflow tests are brittle and slow without time-skipping because they rely on real time progression and live external dependencies. Implementing time-skipping and activity mocking provides deterministic, fast testing by controlling workflow time automatically.

Does Temporal Python testing require a live server for replay testing?

Replay testing in Temporal Python can utilize a live server context to validate determinism with mocked activities. While local development setups often use a local server, replay testing focuses on ensuring workflow history yields consistent results.