Metadata-Version: 2.4
Name: byzh-core
Version: 0.0.10.10
Summary: byzh-core是byzh系列的核心库，包含了一些常用的工具函数和类。
Author: byzh_rc
License: MIT
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: wcwidth
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary

# byzh-core

> byzh 系列工具的核心库，包含了一些常用的工具函数和类。

`pip install byzh-core` → 导入名 `byzh_core`

## CLI 工具

| 命令 | 说明 |
|------|------|
| `b_zip <dir_path>` | 使用黑/白名单过滤将目录压缩为 ZIP |
| `b_dirtree <dir_path>` | 打印目录树 |

## 模块一览

所有模块以 `B` 开头（包），类以 `B_` 开头，函数以 `b_` 开头。

| 模块 | 说明 |
|------|------|
| **Barchive** | ZIP / 7z 归档压缩，支持黑/白名单过滤和分卷压缩 |
| **Bdownloader** | HTTP 文件下载，支持多线程分段下载及单线程回退 |
| **Bgrid** | 实验数据记录到 CSV 或 SQLite（1D 行式 / 2D 网格） |
| **Brecorder** | 基于 pandas 的 1D / 2D CSV 记录器 |
| **Btable** | 2D 表格格式化渲染，支持 CJK 对齐、INI 导入/导出、转置 |
| **Bterminal** | 终端彩色打印、Shell 命令执行（超时终止）、Python 脚本运行 |
| **Btqdm** | 两种风格的进度条（经典填充条 / 现代多列条） |
| **Butils** | 通用工具：颜色枚举、计时器、参数验证装饰器、ML 项目脚手架 |
| **Bwriter** | 双通道日志写入器（终端 + 文件），支持颜色和时间戳 |
| **B_argv** | 运行时操作 `sys.argv`，方便测试和自动化 |
| **B_os** | 跨平台文件/目录操作、黑名单过滤的递归遍历、目录树显示 |

## 依赖

- `wcwidth` — 表格中日韩字符宽度计算
- `pandas`（Bgrid / Brecorder）
- `requests`（Bdownloader）

## License

[MIT](LICENSE)
