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.26
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.26.tar.gz | 980.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| blues_lib-1.20.26-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.2 MB
Release files / blues_lib-1.20.26.tar.gz
| Download URL | blues_lib-1.20.26.tar.gz |
|---|---|
| Size | 980.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6887a4a98f9e9e4e7b6f0581a9150ecc29654016b9e548e1cdc14dd1b04fceba
|
|
BLAKE2b-256 checksum How to use checksums |
f40786bf9a5aa699f8543038d27250ea9f4cfb42ff4f4d033d604ba8035ff8e0
|
| 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.26-py3-none-any.whl
| Download URL | blues_lib-1.20.26-py3-none-any.whl |
|---|---|
| Size | 1.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5a0f9a7b4478237b77bc1e1e16181ae12f5233243610264a8442d2474be6b00c
|
|
BLAKE2b-256 checksum How to use checksums |
6878ba289f66130ee6a8fb3b4e35d363b3811c5881f5fff877ab7851e2f28e25
|
| 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}
|
