什么是 Transitions?

Transitions 是 Python 中Zui受欢迎的有限状态机库之一。 它轻巧又强大，让你Ke以把任何对象变成可控的“状态机器人”。 说实话，用它来Zuo工作流或游戏角色行为简直是零敲零打地省力神器。 从代码行数上kan，它只需要几行即可搞定复杂逻辑，真的是编程界的小黑科技！

在 Transitions 的世界里有三件事物：States、Transitions和 Machine。 States 就像人走路时停留的位置；Transition 是从一个位置跳到另一个位置的方法；而 Machine 则负责维护整个旅程并决定下一步去哪儿。

我先想给你展示一个英雄穿甲的例子，名字叫 Hero，记得吗？ 其实我Zui初写成了 class Hero：但后来改成了 class Hero：因为 Python 3 默认新式类就够用了。

class Hero:
    def wear_armor:
        print
    def log_success:
        print
hero = Hero
states = 
machine = Machine(model=hero,
                  states=states,
                  initial='normal')
machine.add_transition(trigger='encounter_enemy',
                       source='normal',
                       dest='combat',
                       before='wear_armor',
                       after='log_success')
hero.encounter_enemy
# 控制台输出：
#  穿上战甲！
#  状态成功转换。

刚才那段代码运行后你会kan到两行提示信息，就像真正的英雄一样装上盔甲然后进入战斗模式。一切douhen顺利啊！ 不过我之前把 wear_armor 写成了 wearArmor 那样驼峰命名，结果报错，然后才改正过来——

不对不对，应该是 wear_armor 而不是 wearArmor。

为什么百度不收录？

说实话，百度会根据页面内容质量、原创性以及外部链接情况来决定是否抓取和索引。Ru果页面太短或者被认为内容重复，就可Neng被忽略。另外有些站点设置了 robots.txt 阻止搜索引擎抓取，也会导致没被收录。所以别着急，只要保证内容有价值，自然就Neng被搜到啦！

Ru果你的业务geng复杂，比如设备在“on”状态下又分为“standby”和“working”，那么直接使用普通机器就显得麻木无力。这时候 HierarchicalMachine 就派上用场啦！ 让我们kan个小示例：

from transitions.extensions import HierarchicalMachine as Machine
states = ,
     'initial': 'standby'}
]
machine = Machine(states=states,
                   initial='off')
machine.add_transition('power_on',   # 从 off 到 on
                       source='off',
                       dest='on')
machine.add_transition('activate',   # 从 standby 到 working
                       source='on_standby',
                       dest='on_working')
machine.add_transition('power_off', # 任意子状态到 off
                        source='on',
                        dest='off')
print      # 输出 off
machine.power_on
print      # 输出 on_standby
machine.activate
print      # 输出 on_working
# 如此，一个设备从关机到待机再到工作全流程一气呵成。

在现代 Web 开发里 async/await Yi经成为标配，Ru果你的业务需要与数据库或网络服务交互，那就必须考虑异步版本——AsyncMachine Neng让所有回调和触发器dou变成协程运行，geng加友好地融入 asyncio 场景哦！

import asyncio
from transitions.extensions.asyncio import AsyncMachine
class AsyncTask:
    async def notify_server:
        print
        await asyncio.sleep
        print
task = AsyncTask
states = 
machine = AsyncMachine(model=task,
                       states=states,
                       initial='pending')
machine.add_transition(trigger='complete',
                       source='pending',
                       dest='completed',
                       before='_notify_server')
async def main:
    await task.complete          # 注意这里要 await
    print
asyncio.run)
# 控制台输出：
# 开始向服务器同步状态…
# 同步完成.
# 当前状态：completed

Ru果你想让数据库里的某个字段随机器转移自动geng新，那就是 Model Attribute 的魔法时刻啦！我们只需告诉机器去读写哪个属性，然后每一次触发器执行完毕后 Session 就Neng自动感知变化并提交事务，无需手动赋值哦！ 下面给出完整示例，以订单管理为例说明如何Zuo到这一点。

from sqlalchemy import Column,String,Integer
from sqlalchemy.ext.asyncio import create_async_engine,\
                                    async_sessionmaker,\
                                    AsyncSession
from sqlalchemy.orm import declarative_base,Mapped,mapped_column
from transitions import Machine
DATABASE_URL = "postgresql+asyncpg://postgres:user@localhost/mydb"
engine = create_async_engine
async_session = async_sessionmaker
Base = declarative_base
class Order:
    __tablename__ = "orders"
    id       : Mapped      = mapped_column, primary_key=True)
    title    : Mapped       = mapped_column)
    status   : Mapped       = mapped_column, default="created")
# 全局订单机器，不绑定特定实例，而是通过 model_attribute 指定字段名：
order_machine = Machine(
                model=None,
                states=,
                initial="created",
                model_attribute="status",
                ignore_invalid_triggers=True)
order_machine.add_transition
order_machine.add_transition
order_machine.add_transition
order_machine.add_transition
async def process_order:
    async with async_session as sess:
        result   = await sess.execute.where)
        order_obj= result.scalar_one_or_none
        if not order_obj:
            print
            return
        # 把实例注入全局机器：
        order_machine.model=order_obj
        # 执行支付动作：
        success=await order_obj.pay          # 假设 pay 是异步方法返回 True/False
        if success:
            print   # 自动geng新 status 字段
            await sess.commit                 # Session 自动感知 status 字段变化并写入 DB
            print
        else:
            print
# 用法示例：
# asyncio.run)

    * MACHINE 的 ignoreinvalidtriggers=True 参数让无效触发器不会抛异常，而是返回 False，这在业务流程里非常友好。

    * MACHINE 会把模型实例作为弱引用管理，所以当对象失去引用时会自动回收，不必手动 remove_model。

    * If you prefer synchronous flow，你Ke以直接使用普通 Machine 并在每次转移后手动提交事务。

    * AIO 要确保所有回调函数dou是协程，否则可Neng出现阻塞。

Transitions Neng帮你将任意业务逻辑抽象为清晰可见的 state graph；

Hierarchical 和 Async 让你既Neng处理层级关系，又Neng跟进度协程；

与 SQLAlchemy 搭配可实现 ORM 字段直接驱动 FSM，让数据永远保持一致；

而且安装极其简单，只需 pip install transitions 即可获得绘图支持，Ru果你想把 FSM 可视化出来geng直观；

Zui后别忘记关注社区，一起分享经验，共同进步呀～

继续探索geng多技巧吧!