MoviePilot-Rust
MoviePilot Rust 加速模块。
- PyPI 包名：
moviepilot-rust - Python 导入名：
moviepilot_rust - 支持版本：Python 3.11+
- 构建工具：PyO3 + maturin
项目结构
src/
├── bindings/ # Python API、输入快照和输出对象转换
├── filter/ # 类型化过滤规则、表达式 AST 和执行引擎
├── indexer/ # Indexer 配置模型、HTML 选择器和字段解析
├── metainfo/ # 元信息模型、配置、正则规则和影视标题解析
├── rss/ # RSS/Atom 数据模型和流式解析器
└── support/ # 与业务无关的有界缓存等基础设施
业务模块只接收和返回纯 Rust 类型，不直接持有 Python 对象。bindings 负责 PyO3
边界转换，因此核心解析器可以独立单测，并可在转换完成后释放 Python GIL。
本地开发安装
在本仓库根目录创建 .venv，并把 Rust 扩展直接安装到这个虚拟环境：
python3 -m venv .venv
.venv/bin/python -m pip install "maturin>=1.9,<2"
.venv/bin/python -m maturin develop --release
验证扩展是否可导入：
.venv/bin/python -c "import moviepilot_rust; print(moviepilot_rust.is_available())"
输出 True 表示本地编译安装成功。
本地检查
优先使用项目目录下的 .venv，一次编译后运行 Rust 和 Python 两层测试：
cargo fmt --all -- --check
cargo clippy --all-targets -- -D warnings
.venv/bin/python -m maturin develop
cargo test --lib
.venv/bin/python -m pytest -q
本地打包
使用仓库内脚本构建当前平台 wheel 和源码包：
scripts/build_wheels.sh
产物会输出到 dist/，例如：
dist/moviepilot_rust-x.x.x-cp311-abi3-macosx_11_0_arm64.whl
dist/moviepilot_rust-x.x.x.tar.gz
脚本默认使用本仓库 .venv/bin/python。
在 MoviePilot 主项目中使用
主项目通过普通 pip 依赖使用本模块，不再从主项目源码内编译 Rust。
以下命令在 MoviePilot 主项目根目录执行。
安装 PyPI 版本：
.venv/bin/pip install moviepilot-rust
安装本地刚构建的 wheel：
.venv/bin/pip install --force-reinstall ../MoviePilot-Rust/dist/moviepilot_rust-*.whl
在 MoviePilot 主项目里验证运行时状态：
.venv/bin/python -c "from app.utils import rust_accel; print(rust_accel.status())"
available=True 表示扩展已安装可用，enabled=True 表示 MoviePilot 当前配置开关允许使用 Rust 加速。
发布
更新 Cargo.toml 中的 package version 并推送到 main 后，GitHub Actions 会自动创建对应的 v版本号 Release，构建 Linux（glibc/musl）、macOS、Windows wheel 并发布到 PyPI；发布成功后还会向 MoviePilot 的 v2 分支提交 bump requirements.in 的 PR（需配置 MOVIEPILOT_REPO_TOKEN）。
# 修改 Cargo.toml 中的 version = "x.x.x"
git push origin main
手动在 GitHub 上 Publish Release 仍会触发同一套发布流程，但 Release tag 必须与 Cargo.toml 中的 package version 一致，例如 v0.2.1。
1 maintainer
Release files for moviepilot-rust 0.2.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| moviepilot_rust-0.2.4-cp311-abi3-win_amd64.whl | CPython 3.11 | abi3 | Windows x86-64 | Details |
| moviepilot_rust-0.2.4-cp311-abi3-musllinux_1_1_x86_64.whl | CPython 3.11 | abi3 | Linux musl 1.1+ x86-64 | Details |
| moviepilot_rust-0.2.4-cp311-abi3-musllinux_1_1_aarch64.whl | CPython 3.11 | abi3 | Linux musl 1.1+ ARM64 | Details |
| moviepilot_rust-0.2.4-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.11 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| moviepilot_rust-0.2.4-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | CPython 3.11 | abi3 | Linux glibc 2.17+ ARM64 | Details |
| moviepilot_rust-0.2.4-cp311-abi3-macosx_11_0_arm64.whl | CPython 3.11 | abi3 | macOS 11.0+ ARM64 | Details |
| moviepilot_rust-0.2.4-cp311-abi3-macosx_10_12_x86_64.whl | CPython 3.11 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 17.3 MB
Release files / moviepilot_rust-0.2.4-cp311-abi3-win_amd64.whl
| Download URL | moviepilot_rust-0.2.4-cp311-abi3-win_amd64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.11 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
49d267c091f2580640ed99b7b45d0b6d0e53e6c33aee705a4d8d93c5813f4850
|
|
BLAKE2b-256 checksum How to use checksums |
11f60f9968e9551896a9de53831b8b332a5ec689133d33302d6a1c2e750d3b75
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 21, 2026.
Transparency logRelease files / moviepilot_rust-0.2.4-cp311-abi3-musllinux_1_1_x86_64.whl
| Download URL | moviepilot_rust-0.2.4-cp311-abi3-musllinux_1_1_x86_64.whl |
|---|---|
| Size | 2.8 MB |
| Tags | CPython 3.11 Linux musl 1.1+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
ad3e9a5642fbcf639590e0ddda69de67bac4f2216f26ade27c289202a56e214d
|
|
BLAKE2b-256 checksum How to use checksums |
50c3c8a09de4a9b308c00bf808d85351ec51ffd95539c9d30cdf628aa65c1730
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 21, 2026.
Transparency logRelease files / moviepilot_rust-0.2.4-cp311-abi3-musllinux_1_1_aarch64.whl
| Download URL | moviepilot_rust-0.2.4-cp311-abi3-musllinux_1_1_aarch64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.11 Linux musl 1.1+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
a6c3fee8e17cbd1973572324d77a5e01341f32c22ef77815ec8e61c1435080e8
|
|
BLAKE2b-256 checksum How to use checksums |
415659b42e421e95c026988ba13d52a6c0ecb5a75154fd406f9464bae9bc9860
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 21, 2026.
Transparency logRelease files / moviepilot_rust-0.2.4-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | moviepilot_rust-0.2.4-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 2.5 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
f0c0b08481c554bcd8fd4dc8495c37e447cf451b8fa10651a924d6c11ba0f8a3
|
|
BLAKE2b-256 checksum How to use checksums |
5eef5c39ad0e39d23f937a91e723ba7ebc3124b5f65c1609fd07405a51d43489
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 21, 2026.
Transparency logRelease files / moviepilot_rust-0.2.4-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | moviepilot_rust-0.2.4-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
da8c6b4add294b900ed2583ab70db6b7e3dc4ac3d88560080923ada70c9137e7
|
|
BLAKE2b-256 checksum How to use checksums |
52bda381c11df3632be72590876dc623e1f5749b0583dd91776d56c334d604b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 21, 2026.
Transparency logRelease files / moviepilot_rust-0.2.4-cp311-abi3-macosx_11_0_arm64.whl
| Download URL | moviepilot_rust-0.2.4-cp311-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.3 MB |
| Tags | CPython 3.11 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
6be5d2da9165fe433b3378fe0b33bcb7d0c0ce2760e7ee261d6f0b3279f56dea
|
|
BLAKE2b-256 checksum How to use checksums |
a34bebbb9519ad2af11f8fc139049bd989a9e817729dd43a93e13d51b56ac121
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 21, 2026.
Transparency logRelease files / moviepilot_rust-0.2.4-cp311-abi3-macosx_10_12_x86_64.whl
| Download URL | moviepilot_rust-0.2.4-cp311-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.11 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
68f94981717124d9b988fc00fdfab5a835fc835f822613e8e221e8279788b8d2
|
|
BLAKE2b-256 checksum How to use checksums |
ba030da143593c3acfd4daef8c45ef792c130eefae28c5a065ecb30f98e7c680
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 21, 2026.
Transparency log
