Temporal Python SDK 使用教程

Temporal Python SDK 使用教程

sdk-python Temporal Python SDK 项目地址: https://gitcode.com/gh_mirrors/sd/sdk-python

1. 项目的目录结构及介绍

Temporal Python SDK 的目录结构如下：

temporalio/
├── scripts/
├── tests/
├── .gitignore
├── .gitmodules
├── LICENSE
├── README.md
├── build.py
├── poetry.lock
├── pyproject.toml

目录结构介绍

• scripts/: 包含项目相关的脚本文件。
• tests/: 包含项目的测试代码。
• .gitignore: Git 忽略文件配置。
• .gitmodules: Git 子模块配置。
• LICENSE: 项目的开源许可证文件。
• README.md: 项目的介绍文档。
• build.py: 项目的构建脚本。
• poetry.lock: Poetry 依赖锁定文件。
• pyproject.toml: Poetry 项目配置文件。

2. 项目的启动文件介绍

Temporal Python SDK 的启动文件通常是 run_worker.py 和 run_workflow.py。以下是这两个文件的简要介绍：

run_worker.py

import asyncio
import concurrent.futures
from temporalio.client import Client
from temporalio.worker import Worker
from activities import say_hello
from workflows import SayHello

async def main():
    client = await Client.connect("localhost:7233")
    with concurrent.futures.ThreadPoolExecutor(max_workers=100) as activity_executor:
        worker = Worker(
            client,
            task_queue="my-task-queue",
            workflows=[SayHello],
            activities=[say_hello],
            activity_executor=activity_executor,
        )
        await worker.run()

if __name__ == "__main__":
    asyncio.run(main())

run_workflow.py

import asyncio
from temporalio.client import Client
from workflows import SayHello

async def main():
    client = await Client.connect("localhost:7233")
    result = await client.execute_workflow(SayHello.run, "my name", id="my-workflow-id", task_queue="my-task-queue")
    print(f"Result: {result}")

if __name__ == "__main__":
    asyncio.run(main())

文件功能介绍

• run_worker.py: 用于启动 Temporal Worker，处理工作流和活动任务。
• run_workflow.py: 用于启动并执行一个工作流。

3. 项目的配置文件介绍

Temporal Python SDK 的配置文件主要是 pyproject.toml，它使用 Poetry 进行依赖管理和项目配置。

pyproject.toml

[tool.poetry]
name = "temporalio"
version = "0.1.0"
description = "Temporal Python SDK"
authors = ["Temporal Technologies Inc. <info@temporal.io>"]
license = "MIT"

[tool.poetry.dependencies]
python = "^3.7"

[tool.poetry.dev-dependencies]
pytest = "^5.2"

[build-system]
requires = ["poetry-core>=1.0.0"]
build-backend = "poetry.core.masonry.api"

配置文件介绍

• [tool.poetry]: 项目的基本信息，包括名称、版本、描述、作者和许可证。
• [tool.poetry.dependencies]: 项目的依赖包及其版本要求。
• [tool.poetry.dev-dependencies]: 开发环境下的依赖包。
• [build-system]: 构建系统的要求和后端。

通过这些配置文件，开发者可以轻松管理项目的依赖和构建过程。

sdk-python Temporal Python SDK 项目地址: https://gitcode.com/gh_mirrors/sd/sdk-python