bms-table 0.6.1

# BMS 难度表数据获取与解析库

使用 Rust 实现的 BMS 难度表获取与解析库。支持从网页或头部 JSON 构建完整数据结构，覆盖表头、课程、奖杯与谱面条目，并提供索引列表获取能力。

## 安装

在 `Cargo.toml` 中添加依赖（默认启用 `serde`、`scraper`、`reqwest`）：

```toml
[dependencies]
bms-table = "0.6"
```

禁用默认特性并按需启用：

```toml
[dependencies]
bms-table = { version = "0.6", default-features = false, features = ["serde", "scraper"] }
```

## 功能特性

- 从 HTML `<meta name="bmstable">` 提取头部 JSON 地址（启用 `scraper`）。
- 解析表头 JSON 为 `BmsTableHeader`，未识别字段保留到 `extra`。
- 解析谱面数据为 `BmsTableData`，兼容纯数组与 `{ charts: [...] }` 两种格式。
- 将课程中的 `md5`/`sha256` 列表自动转换为 `ChartItem`，缺失 `level` 时补为 "0"。
- 一站式网络获取 API（启用 `reqwest`，隐式启用 `scraper`）。
- 获取难度表索引列表。

## 特性开关

- `serde`：类型的序列化/反序列化支持（默认启用）。
- `scraper`：HTML 解析与 bmstable 头部地址提取（默认启用；`reqwest` 隐式启用）。
- `reqwest`：网络获取实现（默认启用；需要 `tokio` 运行时）。

## 快速开始（网络获取）

```rust
use anyhow::Result;
use bms_table::fetch::reqwest::fetch_table;

#[tokio::main]
async fn main() -> Result<()> {
    let url = "https://stellabms.xyz/sl/table.html";
    let table = fetch_table(url).await?;
    println!("{}: {} charts", table.header.name, table.data.charts.len());
    Ok(())
}
```

## 无网络使用（直接解析 JSON）

```rust
use anyhow::Result;
use bms_table::{BmsTable, BmsTableHeader, BmsTableData};

fn main() -> Result<()> {
    let header_json = r#"{ "name": "Test", "symbol": "t", "data_url": "charts.json", "course": [], "level_order": [] }"#;
    let data_json = r#"{ "charts": [] }"#;
    let header: BmsTableHeader = serde_json::from_str(header_json)?;
    let data: BmsTableData = serde_json::from_str(data_json)?;
    let _table = BmsTable { header, data };
    Ok(())
}
```

## API 概览

- `BmsTable`：顶层数据结构，包含 `header` 与 `data`。
- `BmsTableHeader`：表头元数据；未识别字段保留到 `extra`。
- `BmsTableData`：谱面数据数组或 `{ charts }` 透明包装。
- `CourseInfo`：课程信息，支持 `md5`/`sha256` 列表自动转换为谱面。
- `ChartItem`：谱面条目；空字符串在反序列化时自动转换为 `None`。
- `Trophy`：奖杯要求（最大 miss 率、最低得分率）。
- `fetch::reqwest::fetch_table(url)`：从网页或头部 JSON 源拉取并解析完整表。
- `fetch::reqwest::fetch_table_full(url)`：同时返回原始头部与数据 JSON 文本。
- `fetch::reqwest::fetch_table_index(url)`：获取难度表索引列表。
- `fetch::reqwest::fetch_table_index_full(url)`：返回索引项与原始 JSON 文本。
- `fetch::get_web_header_json_value(str)`：将响应字符串解析为头部 JSON 或其 URL（`HeaderQueryContent`）。
- `fetch::extract_bmstable_url(html)`：从 HTML 中提取 bmstable 头部地址。

## 示例程序

- `examples/single_fetch_index.rs`：单次抓取索引并打印前若干条目。
- `examples/multi_fetch.rs`：并发抓取多个难度表并输出进度与结果。

## 文档与链接

- `docs.rs`：https://docs.rs/bms-table
- 仓库：https://github.com/MiyakoMeow/bms-table-rs

## 许可

本项目基于 Apache-2.0 许可证开源。