↓Skip to main content
  1. Articles/

Basic Python Temporal Demo

Table of Contents

I created this repo https://github.com/qfennessy/basic-python-temporal to learn Temporal’s Python SDK to create, execute, and manage workflows and activities.

It includes an example workflow (EchoWorkflow) and an activity (echo_activity) that interact to process and log input data.

graph TD A[Start Workflow] -->|User Input| B[Temporal Client] B -->|Connects to| C[Temporal Server] C --> D[Task Queue: echo-task-queue] D -->|Schedules Workflow| E[Worker] E -->|Executes| F[EchoWorkflow] F -->|Calls Activity| G[echo_activity] G -->|Processes Input| H[Result: Formatted Output] H -->|Returns to Workflow| F F -->|Returns Final Output| B B -->|Sends Result| A

This is much simpler and less comprehensive than the excellent example code provided by Temporal’s Python samples I needed to start with a very basic setup to start to learn the technology. This is not a criticism of Temporal’s code.

If you want to learn Temporal, spend 30 minutes getting this to work and then graduate to the Python samples.

Features #

  • EchoWorkflow: A workflow that receives a string as input and executes an activity to process the input.
  • echo_activity: An activity that takes the workflow input and returns a formatted result.
  • Logging: Structured logging for workflows and activities to aid in debugging and monitoring.
  • Error Handling: Robust error handling to manage invalid inputs and unexpected failures.

File Structure #

  • worker.py: Sets up and starts a Temporal worker to listen for tasks on a designated task queue.
  • start_workflow.py: CLI-based script to start the EchoWorkflow with user-provided input.
  • workflows.py: Contains the definition of the EchoWorkflow and the associated echo_activity.
  • requirements.txt: Lists dependencies required to run the project.
  • LICENSE: MIT License for the project.