bitsrun

Open source

A headless login / logout script for 10.0.0.55 at BIT. 北京理工大学 10.0.0.55 校园网登录登出的 Python 实现

99 stars0 likes0 views

About

bitsrun

A headless login / logout script for 10.0.0.55 at BIT.

✨
Blazingly™ Fast Rust re-implementation of bitsrun available at spencerwooo/bitsrun, if you require or prefer a single compiled executable (or  Rust).





A Magic Bash re-implementation of bitsrun available at BITNP/bitsrun.sh, if you require or prefer a single bash script.

Install

You need at least Python 3.8. We recommend installing with pipx.

bash

python3 -m pip install --user pipx
python3 -m pipx ensurepath

After which, install bitsrun with pipx.

bash

pipx install bitsrun

Alternatively, you can download a self-contained executable from GitHub Releases if you are working from an environment that does not have internet access.

Usage

CLI

Check login status of your device.

Usage: bitsrun status [OPTIONS]

  Check current network login status.

Options:
  --json / --no-json  Output in JSON format.
  --help  Show this message and exit.

Note: this is the output of bitsrun status --help.

Usage: bitsrun login/logout [OPTIONS]

  Log into or out of the BIT network.

Options:
  -u, --username TEXT  Your username.
  -p, --password TEXT  Your password.
  -v, --verbose        Verbosely echo API response.
  --help               Show this message and exit.

Note: this is the output of bitsrun login/logout --help.

Credentials config

Create new file named bit-user.json:

json

{
    "username": "xxxx",
    "password": "xxxx"
}

This file should be put under the following directory:

Windows: %APPDATA%\bitsrun
macOS and Linux: ~/.config/bitsrun (Following the XDG spec)

On unix, set the file permission to 600, i.e., only read/writeable by the owner:

bash

chmod 600 path/to/bit-user.json

Now you can simply call:

bash

bitsrun login
bitsrun logout

Besides, a system-wide configuration file is supported, and the location also depends on your platform.

To list all possible paths for your system (including those only for backward compatibility), call:

bash

bitsrun config-paths

Raycast script (macOS)

Import the two Raycast scripts from ./scripts and setup your config file in ~/.config/bit-user.json. The script uses /usr/bin/python3 by default, so you either need to install bitsrun with this Python interpreter or setup your own Python interpreter path in the script.

Developing

Create virtual environment and install deps:

bash

python -m venv venv
source venv/bin/activate
pip install -e .

Running CLI entry:

bash

python src/bitsrun/cli.py

Build:

bash

pip install setuptools build
python -m build

Credits and related

Aloxaf/10_0_0_55_login - BIT 10.0.0.55 的登入与登出的 Python 实现 (This project's predecessor, archived)
spencerwooo/bitsrun-rs - A Rust implementation of bitsrun. (Rust)
zu1k/srun - Srun authentication system login tools. (Rust)
Mmx233/BitSrunLoginGo - 深澜校园网登录脚本 Go 语言版 (Go)
vouv/srun - An efficient client for BIT campus network. (Go)