https://github.com/temporalio/edu-versioning-python-code
https://github.com/temporalio/edu-versioning-python-code
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/temporalio/edu-versioning-python-code
- Owner: temporalio
- License: mit
- Created: 2023-11-06T17:49:25.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-07-15T09:59:21.000Z (12 months ago)
- Last Synced: 2025-10-07T12:46:52.055Z (9 months ago)
- Language: CSS
- Homepage:
- Size: 132 KB
- Stars: 2
- Watchers: 5
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Code Repository for Temporal Versioning (Python)
This repository provides code used for exercises and demonstrations
included in the Python version of the
[Versioning](https://learn.temporal.io/courses/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](exercises/version-workflow/README.md)
## Reference
The following links provide additional information that you may find helpful as you work through this course.
- [General Temporal Documentation](https://docs.temporal.io/)
- [Temporal Python SDK Documentation](https://python.temporal.io/)
- [Python Language Documentation](https://docs.python.org/3/)
- [Python Packaging and Virtual Environment Documentation](https://packaging.python.org/en/latest/tutorials/installing-packages/#creating-virtual-environments)
## Exercise Environment for this Course
You can launch an exercise environment for this course using GitHub Codespaces by
following [this](codespaces.md) walkthrough.
Alternatively, you can follow
[these instructions](https://learn.temporal.io/getting_started/python/dev_environment/) 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.