豫见郑大相关服务的 Python API 封装。
zzupy 面向郑州大学常用线上服务，提供统一、显式且带类型提示的 Python 客户端。当前主要覆盖：
- App 端统一认证（CAS）
- 新本科教务（EAS）
- 校园一卡通
- 校园网 Portal 认证与自助服务系统
- 对应的异步实现
Warning
当前仅适配本科教务新系统，研究生教务暂未支持。
- 账密登录与 Token 复用并存，适合脚本和长期任务
- 同步 / 异步 API 基本对齐，迁移成本低
- 使用 Pydantic 模型组织响应数据，便于补全和校验
- 提供统一异常层级，公共异常基类为
zzupy.exception.ZZUError - 保留较底层的请求行为，尽量贴近真实上游接口
pip install -U zzupy要求：
- Python
>=3.11
from zzupy.app import CASClient, UndergradEASClient
cas = CASClient("your_account", "your_password")
cas.login()
with UndergradEASClient(cas) as eas:
eas.login()
week = eas.get_teaching_week(week=1)
lesson = week.get(weekday=1, unit=1)
if lesson:
print(lesson.course.name_zh)from zzupy.web import EPortalClient, discover_portal_info
portal = discover_portal_info()
with EPortalClient(portal.portal_server_url, bind_address=portal.user_ip) as client:
result = client.auth("your_account", "your_password")
print(result.success, result.message)CASClient: App 端统一认证UndergradEASClient: 新本科教务课表与学期数据ECardClient: 校园卡余额、电费与房间相关接口
discover_portal_info: 自动探测校园网 Portal 参数EPortalClient: Portal 认证SelfServiceSystem: 自助服务系统设备管理
- 提供
app与web下主要客户端的异步版本
- 使用文档：https://illustar0.github.io/ZZU.Py/
- API 参考：https://illustar0.github.io/ZZU.Py/reference/api/
- 文档站点由
Zensical构建
项目使用 uv 管理环境和命令。
uv sync --extra develop,docs
uv run python scripts/generate_api_reference.py
uv run zensical serve
uv run zensical build
ruff format zzupy
ruff check zzupy
ty check zzupy
uv build异常处理建议优先捕获 zzupy.exception.ZZUError，再按需细分到 NetworkError、ParsingError、OperationError、InvalidArgumentError 等具体异常。
如需快速打开库内日志，推荐直接调用 logger.enable("zzupy")。
# 启用 TRACE 日志
from loguru import logger
import sys
logger.remove()
logger.add(sys.stderr, level="TRACE")
logger.enable("zzupy")本项目使用 MIT 许可证，详见 LICENSE。