Home

欢迎使用 bitroom！

🆕 首次使用

安装

bitroom 目前为纯 Python 包，跨平台。要求 Python 版本高于 3.10。

$ pipx install bitroom

若不想用 pipx，直接用 pip 也可以，如下。

$ python -m pip install bitroom
# Windows: py -m pip install bitroom

然后验证安装。

$ bitroom --help
Usage: bitroom [OPTIONS] COMMAND [ARGS]...

  BIT 场地预约查询接口

Options:
  --version  ……

Commands:
  config-paths  ……

配置

现在设置“统一身份认证”学号、密码。

有以下命令列出配置文件路径。

$ bitroom config-paths

Note: 也可用环境变量$BITROOM_CONFIG_PATH指定位置。

任选一处，创建config.toml，内容如下。

username = "1120771210"  # 学号
password = "cyberpunk"  # 密码

🔍 fzf 使用示例

需先安装 fzf。

# macOS or Linux
$ brew install fzf

# Windows
> scoop install fzf

首先查询一次，保存数据备用。

$ bitroom show --json > ./bookings.json

然后查询。

$ cat .\bookings.json | bitroom show | fzf

键入以下内容可列出5月8日精工书院社区所有能预约的时空区间。

'05-08 精工

下面是另一些例子，也可参考 fzf 手册。

搜索	意义
'05-08 '08:00–	5月8日，8:00开始
'05-08 '–13:20	5月8日，13:20结束
求是 D103 D107 '05-09	5月9日，求是社区，D103或D107。
!睿信 !体育 '05-08	5月8日，不考虑睿信社区、体育馆

找到所需信息后，按Escape退出。可访问场地预约系统实际预约。