Skip to main content

URP Tools

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

License PyPI Python Code style: Ruff Code style: Black

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

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

License

This project is licensed under the Apache-2.0 License.

Metadata

Release files for urp-tools 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for urp-tools 0.4.1
File Size Uploaded Provenance Actions
urp_tools-0.4.1.tar.gz 1.7 MB With provenance Details for urp_tools-0.4.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for urp-tools 0.4.1
File Interpreter ABI Platform Actions
urp_tools-0.4.1-py3-none-any.whl Python 3 none any Details for urp_tools-0.4.1-py3-none-any.whl

Total release size: 3.4 MB

Release files / urp_tools-0.4.1.tar.gz

Download URL urp_tools-0.4.1.tar.gz
Size 1.7 MB
Tags Source
SHA-256 checksum
How to use checksums
2725a6446c17415ff36ca1ef97a18af15fa501173cfc69f2a613424e99c3ff3f
BLAKE2b-256 checksum
How to use checksums
456bb42a7239f8eda66bf53c58f49ea028b8748553f710a579d07b48218de1c0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 16, 2026.

Transparency log

Release files / urp_tools-0.4.1-py3-none-any.whl

Download URL urp_tools-0.4.1-py3-none-any.whl
Size 1.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
ef446bb4ef10ef87fe11c30988bf6e24fe386831aaf002b9d992a46832c974a1
BLAKE2b-256 checksum
How to use checksums
86e885bfc2924bedd280409dcb5de1ab87c2b00df152e8078b591fcc7017b1d5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 16, 2026.

Transparency log

Security for urp-tools 0.4.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for urp_tools-0.4.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page