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#

CommandAliasFunctionlogin / logout / statusIAAA → Blackboard authcoursesList enrolled courses (supports --all for all semesters)infoCourse detailscontentBrowse course content treeassignmentsList assignments with deadlinesassignmentView single assignmentbrowseInteractive course content browserassignment-download``adlDownload assignment attachmentsdownloadDownload course filesvideo-download``vdlDownload course recordingsvideos``vlsList available videossubmitUpload homework filesotpTOTP 2FA management

Auto-Login for AI Agents#

bash

# 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)