Course - 北大教学网 CLI

A CLI client for PKU's Blackboard Learn teaching platform.

Architecture

• Crate location: crates/course/
• Auth flow: IAAA SSO (app_id="blackboard") → Blackboard SSO endpoint callback
• API: HTML scraping with scraper crate (no JSON API available)
• File upload: multipart form via reqwest

Key Source Files

• src/main.rs — Clap CLI with subcommands
• src/commands.rs — Command implementations
• src/api.rs — HTML scraping logic, page parsers
• src/display.rs — Terminal output formatting
• src/client.rs — reqwest client builders

CLI Commands

Auto-Login for AI Agents

# Check session status
info-auth check

# Auto-login (reads credentials from OS keyring, no password needed)
course login -p

Development Notes

• HTML parsing is the primary data extraction method — no REST API
• Assignment list supports deadline-based sorting
• Video download handles replay/recording URLs
• All user-facing strings in Chinese
• Error handling: anyhow::Result with .context("中文描述")
• Session persisted to ~/.config/info/course/
• Credentials resolved via info_common::credential (keyring → env → interactive)