Python workflow testing examples?

Community Support
1

Hi! :wave: I’m looking to understand how testing of workflows defined in the Python SDK can be accomplished. Testing activities seems simple enough, i.e., it’s really no different from testing any other function. I didn’t see any obvious guidance in the sdk-python repo, nor in GitHub - temporalio/samples-python: Samples for working with the Temporal Python SDK .

Can anyone provide guidance and/or examples on testing workflows defined in Python?

2

Hi @pleases.borderland

Here is a more in detail example of a workflow using python: GitHub - temporalio/sdk-python: Temporal Python SDK. Further down there is more information going over how to run a workflow, invoking activities, invoking child workflows, timers, conditions, asyncio and cancellation, workflow utilities, exceptions, etc…

Let me know if this is resourceful.

Best Regards,
Jordan

3

Thanks for the reply, @jreynolds23 !

The link you shared definitely provides guidance on running workflows, but I can’t find anything describing writing unit/integration tests for workflows. Do you happen to know of code samples of tests covering workflow code?

Thanks again!

4

The test framework to make unit testing of activities and workflows in Python is under active development. I hope to complete it soon. I will update Test framework · Issue #81 · temporalio/sdk-python · GitHub when the PR is available.

In the meantime, some users write integration tests using a real Temporal server (e.g. Temporalite). In fact, the Python SDK tests are written this way.

2 Likes
6

Hi @Chad_Retz , I see that Github issue is closed, but I am not aware of any further framework for writing tests for activities and workflows implemented in Python other than using a real Temporal instance (Temporalite) or using native Python testing mocking within Pytest for example. Am I missing something?

7

Am I missing something?

Many people use the time-skipping server to test in their unit test framework of choice. Pytest is just one example. See the Testing section of the README or look at example tests which use a server defined in conftest.py for Pytest.