RxPY迁移指南：从v1到v4的演进之路-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00883/article/details/148508275

RxPY迁移指南：从v1到v4的演进之路

RxPY ReactiveX for Python 项目地址: https://gitcode.com/gh_mirrors/rx/RxPY

前言

RxPY（ReactiveX for Python）是一个强大的响应式编程库，它实现了ReactiveX规范，为Python开发者提供了优雅的异步编程解决方案。随着版本的演进，RxPY经历了多次重大更新，本文将深入解析从v1到v4的迁移路径，帮助开发者平滑过渡到最新版本。

RxPY v4的主要变化

RxPY v4是向现代Python标准迈进的重要一步，主要包含以下改进：

模块重命名：主模块从rx更名为reactivex，以避免与旧版RxPY混淆
类型注解支持：全面支持泛型类型注解，可与pyright/pylance严格类型检查良好配合
函数重命名：
- pipe函数更名为compose
- 新增了行为类似pipe方法的pipe函数
现代化工具链：采用pyproject.toml替代setup.py，整合了Poetry、Black和isort等现代工具

# v4典型用法示例
import reactivex as rx
from reactivex import operators as ops

rx.of("Alpha", "Beta", "Gamma", "Delta", "Epsilon").pipe(
    ops.map(lambda s: len(s)),
    ops.filter(lambda i: i >= 5)
).subscribe(lambda value: print(f"Received {value}"))

RxPY v3的重大革新

v3版本是RxPY发展历程中的里程碑，带来了诸多重要改进：

基于pipe的操作符链式调用

v3最核心的变化是操作符链式调用方式的改变：

v1方式（方法链）：

from rx import Observable

Observable.of("Alpha", "Beta", "Gamma", "Delta", "Epsilon") \
    .map(lambda s: len(s)) \
    .filter(lambda i: i >= 5) \
    .subscribe(lambda value: print(f"Received {value}"))

v3方式（函数式pipe）：

import rx
from rx import operators as ops

rx.of("Alpha", "Beta", "Gamma", "Delta", "Epsilon").pipe(
    ops.map(lambda s: len(s)),
    ops.filter(lambda i: i >= 5)
).subscribe(lambda value: print(f"Received {value}"))

这种变化带来了两个主要优势：

IDE自动补全支持更好
开发者可以轻松实现自定义操作符，无需通过let操作符包装

结果映射器的移除

v3移除了组合多个Observable时使用的映射器函数，影响以下操作符：

combine_latest
group_join
join
with_latest_from
zip
zip_with_iterable

v1方式：

a.zip(b, lambda a, b: a * b).subscribe(print)

v3方式：

a.pipe(
    ops.zip(b),
    ops.map(lambda z: z[0] * z[1])
).subscribe(print)

更简洁的写法是使用starmap：

a.pipe(
    ops.zip(b),
    ops.starmap(lambda a, b: a * b)
).subscribe(print)

创建操作符中的调度器参数

create操作符的订阅函数现在接收两个参数：观察者和调度器。这使得创建操作符能够使用subscribe调用中设置的默认调度器。

Observable列表支持的移除

v3不再支持以列表形式传递多个Observable给以下操作符：

merge
zip
combine_latest

解决方案：

# 直接传递
rx.merge(obs1, obs2)

# 从列表解包
rx.merge(*obs_list)

其他重要变更

阻塞式Observable

v3移除了BlockingObservable，改用run操作符：

v1方式：

res = Observable.from_([1, 2, 3, 4]).to_blocking().last()

v3方式：

res = rx.from_([1, 2, 3, 4]).run()  # 获取最后一个值
res = rx.from_([1, 2, 3, 4]).pipe(ops.first()).run()  # 获取第一个值
res = rx.from_([1, 2, 3, 4]).pipe(ops.to_list()).run()  # 获取所有值

背压支持

v3移除了对背压和ControllableObservable的支持，建议开发者根据需要实现自定义解决方案。

时间单位变更

时间参数的单位从毫秒改为秒：

v1：ops.debounce(500)
v3：ops.debounce(0.5)

包名变更

多个包进行了重命名：

| 旧名称 | 新名称 | |-------------------------|---------------------------| | rx.concurrency | reactivex.scheduler | | rx.disposables | rx.disposable | | rx.subjects | rx.subject |

此外，rx.concurrency.mainloopscheduler被拆分为reactivex.scheduler.mainloop和reactivex.scheduler.eventloop两部分。