Temporalio Python SDK 安装与使用教程

Temporalio Python SDK 安装与使用教程

【免费下载链接】sdk-python Temporal Python SDK 项目地址: https://gitcode.com/GitHub_Trending/sd/sdk-python

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

Temporalio Python SDK 的目录结构如下：

sdk-python/
├── examples/
│   ├── basic_workflow.py
│   ├── advanced_workflow.py
│   └── ...
├── temporalio/
│   ├── activity.py
│   ├── client.py
│   ├── worker.py
│   ├── workflow.py
│   └── ...
├── tests/
│   ├── test_activity.py
│   ├── test_client.py
│   ├── test_worker.py
│   ├── test_workflow.py
│   └── ...
├── setup.py
├── README.md
└── ...

目录结构介绍

• examples/: 包含一些示例代码，展示了如何使用 Temporalio Python SDK 创建和运行工作流。
• temporalio/: 核心代码库，包含了 SDK 的主要功能模块，如 activity.py、client.py、worker.py 和 workflow.py。
• tests/: 包含 SDK 的测试代码，确保 SDK 的各个模块正常工作。
• setup.py: 用于安装 SDK 的配置文件。
• README.md: 项目的基本介绍和使用说明。

2. 项目的启动文件介绍

Temporalio Python SDK 的启动文件通常是 examples/basic_workflow.py 或 examples/advanced_workflow.py。这些文件展示了如何启动一个简单的工作流。

示例启动文件 basic_workflow.py

from temporalio import workflow, activity, client

@workflow.defn
class MyWorkflow:
    @workflow.run
    async def run(self):
        result = await workflow.execute_activity(my_activity, "Hello, Temporal!")
        return result

@activity.defn
def my_activity(name: str) -> str:
    return f"Hello, {name}"

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

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

启动文件介绍

• MyWorkflow 类: 定义了一个简单的工作流，调用 my_activity 活动并返回结果。
• my_activity 函数: 一个简单的活动，接收一个字符串并返回一个问候语。
• main 函数: 连接到 Temporal 服务器，执行工作流，并打印结果。

3. 项目的配置文件介绍

Temporalio Python SDK 的配置文件主要是 setup.py，用于定义项目的依赖和安装方式。

setup.py 文件内容

from setuptools import setup, find_packages

setup(
    name="temporalio-sdk-python",
    version="0.1.0",
    packages=find_packages(),
    install_requires=[
        "temporalio>=0.1.0",
        "requests>=2.25.1",
        "aiohttp>=3.7.4",
    ],
    entry_points={
        "console_scripts": [
            "temporalio-cli=temporalio.cli:main",
        ],
    },
)

配置文件介绍

• name: 项目的名称。
• version: 项目的版本号。
• packages: 需要包含的 Python 包。
• install_requires: 项目依赖的其他 Python 包。
• entry_points: 定义了命令行工具的入口点。

通过以上配置，用户可以使用 pip install . 命令安装 Temporalio Python SDK。

---

以上是 Temporalio Python SDK 的安装与使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些内容能帮助你快速上手使用 Temporalio Python SDK。

【免费下载链接】sdk-python Temporal Python SDK 项目地址: https://gitcode.com/GitHub_Trending/sd/sdk-python