Bitool-core

Bitool 的 Rust 核心模块，通过 PyO3 + Maturin 将高性能 Rust 实现暴露为 Python 可调用的扩展模块。

定位

Bitool 采用 Rust + Python 混合架构，bitool-core 负责处理性能关键路径上的计算密集型任务：

安装

作为 Bitool 的一部分安装

pip install bitool

开发模式安装

cd bitool-core
maturin develop

构建发布包

cd bitool-core
maturin build -r

Python API

安装后通过 import bitool_core 即可使用所有 Rust 实现的功能：

配置管理

import bitool_core

# 全局配置
config = bitool_core.PyBitoolConfig()
config.get("key", "default_value")

# 工作区配置
ws_config = bitool_core.PyWorkspaceConfig()
ws_config.workspace_path = "/path/to/project"

文件操作

import bitool_core

ops = bitool_core.PyFileOps()

# 扫描目录
files = ops.scan_directory("/path/to/dir")

# 文件读写
content = ops.read_file("input.txt")
ops.write_file("output.txt", content)

# 文件复制/移动/删除
ops.copy_file("src.txt", "dst.txt")
ops.move_file("old.txt", "new.txt")
ops.delete_file("temp.txt")

文本处理

import bitool_core

processor = bitool_core.PyTextProcessor()

# 正则搜索
results = processor.regex_search(r"\d{4}-\d{2}-\d{2}", text)

# 文本替换
new_text = processor.regex_replace(pattern, replacement, text)

# 批量处理（利用 rayon 并行加速）
results = processor.batch_search(patterns, texts)

PDF 操作

import bitool_core

pdf = bitool_core.PyPdfOps()

# 合并 PDF
pdf.merge_pdfs(["part1.pdf", "part2.pdf"], "merged.pdf")

# 拆分 PDF
pdf.split_pdf("input.pdf", "output_dir", pages_per_split=10)

# 压缩 PDF
pdf.compress_pdf("large.pdf", "small.pdf")

# PDF 转图片
images = pdf.to_images("document.pdf", dpi=150, format="png")

加密功能

import bitool_core

# AES 加密/解密
encrypted = bitool_core.encrypt(data, key)
decrypted = bitool_core.decrypt(encrypted, key)

# SHA2 哈希
hash_value = bitool_core.sha256(data)

命令执行

import bitool_core

executor = bitool_core.PyCommandExecutor()

# 执行外部命令
result = executor.run("git status")
print(result.stdout)
print(result.return_code)

# 异步执行（基于 tokio）
result = executor.run_async("long_running_command")

性能分析

import bitool_core

profiler = bitool_core.PyPerformanceProfiler()

# 计时
profiler.start("task_name")
# ... 执行任务 ...
record = profiler.stop("task_name")

print(f"耗时: {record.elapsed_ms:.2f} ms")

# 获取所有记录
all_records = profiler.records

项目结构

bitool-core/
├── src/
│   ├── lib.rs                 # 库入口，注册所有 PyO3 模块
│   ├── core/                  # Rust 核心实现
│   │   ├── mod.rs             #   模块聚合
│   │   ├── cmd_exec.rs        #   外部命令执行（tokio 异步）
│   │   ├── config.rs          #   配置管理（serde 序列化）
│   │   ├── crypto.rs          #   加密功能（AES-256 / SHA2）
│   │   ├── file_ops.rs        #   文件操作（rayon 并行）
│   │   ├── pdf_ops.rs         #   PDF 处理（lopdf / pdfium-render）
│   │   ├── profiler.rs        #   高精度性能分析
│   │   └── text_proc.rs       #   文本处理（regex / rayon）
│   ├── plugins/               # 插件系统
│   │   ├── mod.rs             #   插件框架
│   │   ├── loader.rs          #   动态插件加载
│   │   └── registry.rs        #   插件注册表
│   └── python/                # PyO3 Python 绑定
│       ├── mod.rs             #   绑定聚合
│       ├── py_cmd_exec.rs     #   命令执行器绑定
│       ├── py_config.rs       #   配置管理绑定
│       ├── py_file_ops.rs     #   文件操作绑定
│       ├── py_pdf_ops.rs      #   PDF 操作绑定
│       ├── py_profiler.rs     #   性能分析器绑定
│       └── py_text_proc.rs    #   文本处理器绑定
├── .cargo/
│   └── libs/                  # 链接库
├── Cargo.toml                 # Rust 依赖配置
└── pyproject.toml             # Maturin 构建配置

技术栈

许可证

MIT License