URP Tools

关于 URP 教务系统的抢课脚本及工具

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

urp_tools-0.4.1.tar.gz (1.7 MB view details)

Uploaded Aug 16, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

urp_tools-0.4.1-py3-none-any.whl (1.7 MB view details)

Uploaded Aug 16, 2026 Python 3

File details

Details for the file urp_tools-0.4.1.tar.gz.

File metadata

Download URL: urp_tools-0.4.1.tar.gz
Upload date: Aug 16, 2026
Size: 1.7 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for urp_tools-0.4.1.tar.gz
Algorithm	Hash digest
SHA256	`2725a6446c17415ff36ca1ef97a18af15fa501173cfc69f2a613424e99c3ff3f`
MD5	`7c50932b16d7a533f8b61cdfb3d4b50f`
BLAKE2b-256	`456bb42a7239f8eda66bf53c58f49ea028b8748553f710a579d07b48218de1c0`

See more details on using hashes here.

Provenance

The following attestation bundles were made for urp_tools-0.4.1.tar.gz:

Publisher: release.yml on Reversedeer/urp-academic-affairs-tools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: urp_tools-0.4.1.tar.gz
- Subject digest: 2725a6446c17415ff36ca1ef97a18af15fa501173cfc69f2a613424e99c3ff3f
- Sigstore transparency entry: 2484334638
- Sigstore integration time: Aug 16, 2026
Source repository:
- Permalink: Reversedeer/urp-academic-affairs-tools@58134280b7a2e892dd145b92586932eee4b5821e
- Branch / Tag: refs/tags/v0.4.1
- Owner: https://github.com/Reversedeer
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@58134280b7a2e892dd145b92586932eee4b5821e
- Trigger Event: push