Code Repository for Temporal Versioning (Python)

This repository provides code used for exercises and demonstrations included in the Python version of the Versioning training course.

It's important to remember that the example code used in this course was designed to support learning a specific aspect of Temporal, not to serve as a ready-to-use template for implementing a production system.

For the exercises, make sure to run temporal server start-dev --ui-port 8080 --db-filename clusterdata.db in one terminal to start the Temporal server. For more details on this command, please refer to the Setting up a Local Development Environment chapter in the course. Note: If you're using the Codespaces environment to run this exercise, you can skip this step.

Hands-On Exercises

Directory Name	Exercise
exercises/version-workflow	Exercise 1

Reference

The following links provide additional information that you may find helpful as you work through this course.

• General Temporal Documentation
• Temporal Python SDK Documentation
• Python Language Documentation
• Python Packaging and Virtual Environment Documentation

Exercise Environment for this Course

You can launch an exercise environment for this course using GitHub Codespaces by following this walkthrough.

Alternatively, you can follow these instructions to set up your own Temporal Cluster with Docker Compose, which you can use as an exercise environment.

Set Up Your Python Virtual Environment

All Python libraries for this course should be installed in a virtual environment. If you are running these exercises in the course's Codespaces environment, there is a virtual environment already setup for you and you can skip this section. If you are running these exercises locally, be sure you are using Python 3.7+.

1. Open a terminal window in the environment and change directories to the root directory of the edu-versioning-python-code repository
2. Run the following command to create a virtual environment

$ python3 -m venv env

3. Activate the virtual environment

Linux/Mac:

$ source env/bin/activate

Windows:

$ env\Scripts\activate

Once the environment is active you should see (env) prepended to your prompt similar to below

(env) $

4. Install the necessary packages into the virtual environment

python -m pip install -r requirements.txt

5. For every new terminal you open, you will need to activate the environment using the following command

Linux/Mac:

$ source env/bin/activate

Windows:

$ env\Scripts\activate

However, the packages are already installed, so there is no need to run pip again.