urp-tools 0.4.0

URP Academic Affairs System Course Snatching Tool

URP Tools

Features

• Async login with captcha recognition and retry support
• Timetable export to Excel
• Teaching evaluation preview, selection, confirmation, and submission
• Course list preview, course-number filtering, course selection
• Continuous course-snatching mode

Requirements

• Python >=3.10,<3.11
• Poetry 2.x for development

[!CAUTION]

The current goal of this project is to be used on jws.qgxy.cn

Installation

PyPI

pip install urp-tools

Install from source code

git clone https://github.com/Reversedeer/urp-academic-affairs-tools.git
cd urp-academic-affairs-tools
poetry install

Configuration

Create a .env file in the project root:

cp .env.example .env

Environment

Variable	Description	Must	Default
URP_BASE_URL	URP base URL	Yes	https://jws.qgxy.cn
URP_USERNAME	Login username	Yes	null
URP_PASSWORD	Login password	Yes	null
URP_DEFAULT_CHOICE	Default evaluation choice	No	A
URP_DEFAULT_COMMENT	Default evaluation comment	No	老师教学认真课程收获较大
URP_EVALUATION_WAIT_SECONDS	Wait time before evaluation submission	No	120
URP_EVALUATION_LIMIT	Optional submission limit for evaluation	No	null
URP_EVALUATION_CONCURRENCY	Evaluation open/submit concurrency	No	3
URP_COURSE_SNATCHING_ATTEMPTS	Maximum snatching attempts; 0 means continuous mode	No	0
URP_COURSE_SNATCHING_CONCURRENCY	Concurrent requests in snatching mode	No	10
URP_COURSE_SNATCHING_RETRY_INTERVAL	Delay between snatching rounds in seconds	No	0.2

Usage

Run with Poetry

#Run with Poetry
poetry run urp-tools
#Run the PySide6 desktop interface
poetry run urp-tools-gui
#Run as a module
poetry run python -m urp_academic_affairs_tools.main
#Run the GUI as a module
poetry run python -m urp_academic_affairs_tools.gui

[!NOTE]

• Due to server limitations, teaching evaluations require a 120-second submission wait.

• Course selection displays a preview when the selection period is closed; the server still validates every submission.

• Continuous course snatching stops after a successful response or a non-retryable course error.

License

This project is licensed under the Apache-2.0 License.