rachfop / saga-2

SAGAS with Temporal

This tutorial covers the implementation of the Sagas pattern using Temporal.

Running the Example

To run the example, open four terminal instances and follow the instructions below.

Prerequisites

Create a virtual environment:

python3 -m venv venv

Activate your virtual environment:

source .venv/bin/activate

Install the dependencies:

pip install -r requirements.txt

Step 1: Start Temporal Server

In the first terminal, start the Temporal server in development mode:

temporal server start-dev

Step 2: Start the Worker

In the second terminal, run the worker script:

python run_worker.py

Step 3: Start the Workflow

In the third terminal, run the workflow script:

python run_workflow.py

Run a Successful Booking

In the fourth terminal, run the following curl command to initiate a successful booking process.

Input

curl -X POST http://localhost:3002/book \
-H "Content-Type: application/json" \
-d '{
    "name": "John Doe",
    "attempts": 5,
    "car": "valid-car-id",
    "hotel": "valid-hotel-id",
    "flight": "valid-flight-id"
}'

Expected Output

{
  "result": {
    "message": {
      "booked_car": "valid-car-id",
      "booked_flight": "valid-flight-id",
      "booked_hotel": "valid-hotel-id"
    },
    "status": "success"
  },
  "user_id": "jane-smith-288524"
}

Run a Failed Booking

To simulate a booking failure, run the following curl command in the fourth terminal.

Input

curl -X POST http://localhost:3002/book \
-H "Content-Type: application/json" \
-d '{
    "name": "Jane Smith",
    "attempts": 3,
    "car": "valid-car-id",
    "hotel": "invalid-hotel-id",
    "flight": "valid-flight-id"
}'

Expected Output

{
  "result": {
    "message": "Activity task failed",
    "status": "failure"
  },
  "user_id": "jane-smith-935816"
}

Formatting Documentation and Code

Format Documentation

To format the documentation, run the following command:

dprint fmt -c dprint.json

Format Python Examples

To format the Python examples in the documentation, run the following command:

blacken-docs tutorial.md

Format Code

To format the code, run the following commands:

isort . && black .

If you need further assistance or have any questions, feel free to ask.