blues-lib
Python library writed by Blues Liu.
blues-lib | 版本：1.19.3
简介
blues-lib 是一个以 Web 自动化 为核心的 Python 库，提供浏览器操作（Selenium/WebDriver）、LLM 调用、数据预处理（DPP）、文件/数据库/消息等能力，并以 MCP 风格工具（ww_*）统一封装，通过 ww CLI 或 AbilityClient 执行自动化任务。
安装
pip install blues-lib
本地开发（推荐 uv）：
uv sync
CLI
安装后提供 ww 与 webwork 两个全局命令：
ww -v # 查看版本
ww help # 查看可用命令
ww run -m <meta_path> [-b <bizdata_path>] # 执行 meta/task/flow
ww dash <bizdata_path> # 快速执行（读取/填充模式）
ww tool list # 列出所有 ww_* 工具及 schema
ww config / mysql / sqlite / ftp / ssh / webdriver / email / ding / llm ...
详见 readme-cli.md。
示例
from blues_lib.tools.runner import AbilityClient
# 执行一个 ww_* 工具
result = AbilityClient.run({
"name": "ww_time",
"options": {"action": "sleep", "value": 0.5, "id": "t1"},
})
# 执行任务 / 流程（meta 内 name 为 ww_task / ww_flow 自动分发）
AbilityClient.run("tests/template/write/base/fillin-article.json5")
目录结构
src/blues_lib/
├── cli/ # ww / webwork CLI（run/dash/config/... 16 个命令）
├── services/
│ ├── dpp/ # 数据预处理职责链（Read/Write/Persist）
│ ├── schema/ # 工具 schema（基于 pydantic）
│ ├── webdriver/ # WebDriver 工厂与 CFT 自动下载
│ └── llm/ # LLM 客户端
├── tools/
│ ├── runner/ # AbilityClient / MetaLoader / Facade
│ └── ability/ # ww_* 工具定义（atom/sequence/task）
└── types/schemas/ # 工具入参 pydantic 模型（TOOL_ADAPTERS）
测试
uv run pytest # 全部测试
uv run pytest tests/tools/ # 指定目录
uv run pytest --cov=src/blues_lib --cov-report=term-missing # 覆盖率
相关文档
readme-cli.md— CLI 使用说明CHANGELOG.md— 版本历史src/blues_lib/services/dpp/readme.md— DPP 职责链设计src/blues_lib/services/webdriver/readme.md— WebDriver 配置与自动下载src/blues_lib/tools/readme.md— 工具机制（发现/注释/Schema/测试）src/blues_lib/tools/ability/sequence/README.md— ww_walk 三种执行模式
1 maintainer
Metadata
1 maintainer
Release files for blues-lib 1.20.23
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| blues_lib-1.20.23.tar.gz | 979.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| blues_lib-1.20.23-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.2 MB
Release files / blues_lib-1.20.23.tar.gz
| Download URL | blues_lib-1.20.23.tar.gz |
|---|---|
| Size | 979.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
619b1c256c99b7842e9c8dd1195d5ff64c976cb1e1df22f57e9557d12f7f61be
|
|
BLAKE2b-256 checksum How to use checksums |
bc7694c4dafd9ea2a7e5beb16038ec65fd6199fc694062016fcd0c841e7730f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / blues_lib-1.20.23-py3-none-any.whl
| Download URL | blues_lib-1.20.23-py3-none-any.whl |
|---|---|
| Size | 1.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6c60d7a3a66c7c712d3b4741c155c39b3209a3685d82dfcdb29f278068ac3146
|
|
BLAKE2b-256 checksum How to use checksums |
498b66a43258e721587fe53d55e5b0ac2c919ccfa01aeb40d741a4c5d3144645
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
