urp-tools 0.2.3.3__py3-none-any.whl

urp_academic_affairs_tools/client/__init__.py

@@ -0,0 +1,4 @@
+from .api import fetch_tasks, get_this_semester_timetable
+from .session import AsyncJWSSession
+
+__all__ = ["AsyncJWSSession", "fetch_tasks", "get_this_semester_timetable"]

urp_academic_affairs_tools/client/api.py

@@ -0,0 +1,19 @@
+"""api"""
+
+from .session import AsyncJWSSession
+
+
+async def get_this_semester_timetable(jws: AsyncJWSSession) -> dict:
+    """获取本学期课表"""
+    return await jws.request_json(
+        "GET",
+        "/student/courseSelect/thisSemesterCurriculum/callback",
+    )
+
+
+async def fetch_tasks(jws: AsyncJWSSession) -> dict:
+    """获取评教列表"""
+    return await jws.request_json(
+        "GET",
+        "/student/teachingEvaluation/teachingEvaluation/search",
+    )

urp_academic_affairs_tools/client/session.py

@@ -0,0 +1,451 @@
+"""登录会话"""
+
+import asyncio
+import hashlib
+import json
+import logging
+import random
+import re
+from collections import Counter
+from dataclasses import dataclass
+from io import BytesIO
+from types import TracebackType
+
+import aiohttp
+import ddddocr
+from PIL import Image, ImageSequence
+
+BASE_URL = "https://jws.qgxy.cn"
+LOGIN_PAGE = f"{BASE_URL}/login"
+LOGIN_URL = f"{BASE_URL}/j_spring_security_check"
+CAPTCHA_URL = f"{BASE_URL}/img/captcha.jpg"
+INDEX_URL = f"{BASE_URL}/index.jsp"
+
+CODE_LEN = 4
+HTTP_STATUS_OK = 200
+MAX_RETRY = 100
+ASCII_CODE_RE = re.compile(r"^[A-Za-z0-9]{4}$")
+TOKEN_RE = re.compile(r'name="tokenValue"\s+value="([^"]+)"', re.IGNORECASE)
+
+log = logging.getLogger(__name__)
+
+
+@dataclass
+class RetryPolicy:
+    max_retry: int = 10
+    base_sleep: float = 0.15
+    max_sleep: float = 1.2
+    jitter: float = 0.2
+
+
+class AuthError(Exception): ...
+
+
+class ServiceError(Exception): ...
+
+
+class SessionExpiredError(Exception): ...
+
+
+class AsyncJWSSession:
+    def __init__(
+        self,
+        timeout_total: float = 6.0,
+        timeout_connect: float = 2.0,
+        connector_limit: int = 50,
+        retry: RetryPolicy = RetryPolicy(),
+        jitter_range: tuple[float, float] = (0.0, 0.15),
+    ) -> None:
+        self._timeout = aiohttp.ClientTimeout(
+            total=timeout_total,
+            connect=timeout_connect,
+        )
+        self._connector = aiohttp.TCPConnector(limit=connector_limit, ttl_dns_cache=300)
+        self._session: aiohttp.ClientSession | None = None
+
+        self.headers = {
+            "User-Agent": (
+                "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) "
+                "AppleWebKit/537.36 (KHTML, like Gecko) Chrome/73.0.3683.75 Safari/537.36"
+            ),
+            "Referer": LOGIN_PAGE,
+        }
+        self.retry = retry
+        self.jitter_range = jitter_range
+
+        self._username = None
+        self._password = None
+        self._ocr = ddddocr.DdddOcr(show_ad=False, beta=True)
+
+    async def __aenter__(self) -> "AsyncJWSSession":  # noqa: PYI034
+        self._session = aiohttp.ClientSession(
+            timeout=self._timeout,
+            connector=self._connector,
+            headers=self.headers,
+            raise_for_status=False,
+        )
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc: BaseException | None,
+        tb: TracebackType | None,
+    ) -> None:
+        if self._session is not None:
+            await self._session.close()
+            self._session = None
+
+    @staticmethod
+    def _md5(text: str) -> str:
+        """明文密码 MD5 加密"""
+        return hashlib.md5(text.encode("utf-8")).hexdigest()
+
+    @staticmethod
+    def _extract_token(html: str) -> str:
+        """获取tokenValue"""
+        m: re.Match[str] | None = TOKEN_RE.search(html or "")
+        if not m:
+            msg = "tokenValue not found"
+            raise AuthError(msg)
+        return m.group(1)
+
+    async def _sleep_jitter(self) -> None:
+        """随机等待，防止请求过快"""
+        lo, hi = self.jitter_range
+        if hi > 0:
+            await asyncio.sleep(random.uniform(lo, hi))  # noqa: S311
+
+    def check_login_page(self, text: str) -> bool:
+        """检查是否为登录页面"""
+        t: str = (text or "").lower()
+        return (
+            ("tokenvalue" in t and "j_spring_security_check" in t)
+            or ("gotologin" in t)
+            or ("/login" in t)
+        )
+
+    async def is_logged_in(self) -> bool:
+        """检查是否已登录"""
+        if not self._session:
+            log.error("session not started")
+            msg = "session not started "
+            raise RuntimeError(msg)
+
+        try:
+            async with self._session.get(INDEX_URL, allow_redirects=False) as r:
+                if r.status == HTTP_STATUS_OK:
+                    txt = await r.text(errors="ignore")
+                    return not self.check_login_page(txt)
+                if r.status in (301, 302, 303, 307, 308):
+                    loc = (r.headers.get("Location") or "").lower()
+                    return not ("gotologin" in loc or "/login" in loc)
+                return False
+        except (aiohttp.ClientError, asyncio.TimeoutError):
+            return False
+
+    async def login(self, username: str, password: str) -> None:
+        """登录教务系统，保存会话状态"""
+        if not self._session:
+            msg = "session not started"
+            raise RuntimeError(msg)
+
+        self._username = username
+        self._password = password
+
+        for i in range(MAX_RETRY):
+            log.info("✨ 第 %d 次尝试登录:", i + 1)
+            try:
+                async with self._session.get(LOGIN_PAGE) as r:
+                    if r.status != HTTP_STATUS_OK:
+                        await self._sleep_jitter()
+                        continue
+                    html = await r.text(errors="ignore")
+                token = self._extract_token(html)
+                log.info("tokenValue: %s", token)
+            except (aiohttp.ClientError, asyncio.TimeoutError, AuthError):
+                log.exception("获取登录页异常，请检查账号密码是否正确")
+                await self._sleep_jitter()
+                continue
+
+            # 验证码
+            try:
+                img_bytes = await self._fetch_captcha_image(max_retry=5)
+            except Exception:
+                log.exception("获取验证码异常")
+                await self._sleep_jitter()
+                continue
+
+            # OCR
+            captcha = await self.parse_captcha(img_bytes)
+            if not captcha or not ASCII_CODE_RE.fullmatch(captcha):
+                await self._sleep_jitter()
+                continue
+
+            data = {
+                "tokenValue": token,
+                "j_username": username,
+                "j_password": self._md5(password),
+                "j_captcha": captcha,
+            }
+            try:
+                async with self._session.post(
+                    LOGIN_URL,
+                    data=data,
+                    allow_redirects=True,
+                ) as _:
+                    pass
+            except (aiohttp.ClientError, asyncio.TimeoutError):
+                log.exception("登录提交失败")
+                await self._sleep_jitter()
+                continue
+
+            if await self.is_logged_in():
+                log.info("✅ 登录成功")
+                return
+            log.warning("❌ 登录失败，重试中...")
+            await self._sleep_jitter()
+        log.error("❌ 登录失败，达到最大重试次数")
+        msg = "login failed"
+        raise AuthError(msg)
+
+    async def _ensure_login(self) -> None:
+        """确保已登录，未登录则自动重登"""
+        if await self.is_logged_in():
+            return
+        if not self._username or not self._password:
+            log.error("未登录且未保存账号密码，无法自动重登")
+            msg = "not logged in and no saved credentials"
+            raise SessionExpiredError(msg)
+        log.info("session已过期，自动重登…")
+        await self.login(self._username, self._password)
+
+    async def _fetch_captcha_image(self, max_retry: int = 5) -> bytes:
+        """获取验证码图片"""
+        if not self._session:
+            log.error("验证码未正常加载")
+            msg = "session not started"
+            raise RuntimeError(msg)
+
+        for _ in range(max_retry):
+            try:
+                async with self._session.get(CAPTCHA_URL, allow_redirects=True) as r:
+                    if r.status != HTTP_STATUS_OK:
+                        await self._sleep_jitter()
+                        continue
+
+                    ct = (r.headers.get("Content-Type") or "").lower()
+                    content = await r.read()
+
+                if "image" not in ct:
+                    # 疑似被踢回登录：刷新一次登录页
+                    try:
+                        async with self._session.get(LOGIN_PAGE) as _:
+                            pass
+                    except Exception:
+                        log.exception("刷新登录页出错")
+                    await self._sleep_jitter()
+                    continue
+
+                ok = await self._verify_image(content)
+                if ok:
+                    return content
+
+            except (aiohttp.ClientError, asyncio.TimeoutError):
+                log.exception("获取验证码请求异常")
+                await self._sleep_jitter()
+        log.error("验证码获取失败")
+        msg = "captcha fetch failed"
+        raise AuthError(msg)
+
+    async def _verify_image(self, img_bytes: bytes) -> bool:
+        """校验验证码合法性"""
+        loop = asyncio.get_running_loop()
+
+        def _verify() -> bool:
+            try:
+                img = Image.open(BytesIO(img_bytes))
+                img.verify()
+            except Exception:
+                log.exception("验证码图片校验失败")
+                return False
+            else:
+                return True
+
+        return await loop.run_in_executor(None, _verify)
+
+    async def parse_captcha(self, img_bytes: bytes) -> str:
+        loop = asyncio.get_running_loop()
+        return await loop.run_in_executor(None, self._parse_captcha, img_bytes)
+
+    def _parse_captcha(self, img_bytes: bytes) -> str:  # noqa: C901
+        """
+        验证码解析策略：
+        - full OCR
+        - split OCR
+        - full 和 split 都是 4 位 → 优先 full
+        - 否则 → 优先 split
+        """
+
+        def normalize(s: str) -> str:
+            if not s:
+                return ""
+            s = s.strip().replace(" ", "")
+            s = s.replace("y", "7").replace("9", "r").replace("E", "F")
+            s = "".join(
+                ch
+                for ch in s
+                if ("0" <= ch <= "9") or ("A" <= ch <= "Z") or ("a" <= ch <= "z")
+            )
+            return s.lower()
+
+        def ocr_img(pil_img: Image.Image) -> str:
+            pil_img = pil_img.resize(
+                (pil_img.width * 2, pil_img.height * 2),
+                Image.NEAREST,
+            )
+            buf = BytesIO()
+            pil_img.save(buf, format="PNG")
+            return self._ocr.classification(buf.getvalue())
+
+        img = Image.open(BytesIO(img_bytes))
+        frames = [f.convert("L") for f in ImageSequence.Iterator(img)]
+        if not frames:
+            return ""
+
+        base = frames[0]
+        norm_full = normalize(ocr_img(base))
+        log.info("Full OCR result: '%s'", norm_full)
+
+        if sum(1 for ch in norm_full if ch.isalnum()) < 3:  # noqa: PLR2004
+            log.warning("Full OCR 非4位ASCII字母数字/非数字答案，重试中...")
+            return ""
+
+        w, h = base.size
+        char_w = w // 4
+        split_chars = []
+        for i in range(4):
+            crop = base.crop((i * char_w, 0, (i + 1) * char_w, h))
+            norm = normalize(ocr_img(crop))
+            split_chars.append(norm[:1] if norm else "")
+
+        if not split_chars[0]:
+            candidates = []
+            for frame in frames[:3]:
+                w2, h2 = frame.size
+                for ratio in (4, 3):
+                    crop = frame.crop((0, 0, w2 // ratio, h2))
+                    norm = normalize(ocr_img(crop))
+                    if norm:
+                        candidates.append(norm[0])
+            if candidates:
+                split_chars[0] = Counter(candidates).most_common(1)[0][0]
+            log.info("尝试补全首字符 '%s'->'%s'", candidates, split_chars[0])
+
+        split_code = "".join(split_chars)
+        log.info("split_chars -> split_code: '%s' -> '%s'", split_chars, split_code)
+
+        full_ok = len(norm_full) == CODE_LEN and ASCII_CODE_RE.fullmatch(norm_full)
+        split_ok = len(split_code) == CODE_LEN and ASCII_CODE_RE.fullmatch(split_code)
+
+        if full_ok and split_ok:
+            log.info("使用 full='%s'", norm_full)
+            return norm_full
+        if split_ok:
+            log.info("使用 split='%s'", split_code)
+            return split_code
+        if full_ok:
+            log.info("使用 full='%s'", norm_full)
+            return norm_full
+        return ""
+
+    async def request_text(  # noqa: C901, PLR0913
+        self,
+        method: str,
+        path: str,
+        *,
+        params: dict | None = None,
+        data: dict | None = None,
+        json: dict | None = None,
+        allow_redirects: bool = True,
+        retry: RetryPolicy | None = None,
+    ) -> str:
+        """自动处理重试和登录过期"""
+
+        def _raise_session_expired() -> None:
+            msg = "looks like login page"
+            raise SessionExpiredError(msg)
+
+        def _raise_retryable_service_error(status: int) -> None:
+            msg = f"retryable status {status}"
+            raise ServiceError(msg)
+
+        def _raise_service_error(status: int) -> None:
+            msg = f"status {status}"
+            raise ServiceError(msg)
+
+        await self._ensure_login()
+        if not self._session:
+            log.error("session not started")
+            msg = "session not started"
+            raise RuntimeError(msg)
+
+        url = (
+            path
+            if path.startswith("http")
+            else (BASE_URL + (path if path.startswith("/") else f"/{path}"))
+        )
+        pol = retry or self.retry
+
+        for attempt in range(1, pol.max_retry + 1):
+            try:
+                async with self._session.request(
+                    method,
+                    url,
+                    params=params,
+                    data=data,
+                    json=json,
+                    allow_redirects=allow_redirects,
+                ) as r:
+                    txt = await r.text(errors="ignore")
+
+                    if self.check_login_page(txt):
+                        log.info("looks like login page")
+                        _raise_session_expired()
+
+                    if r.status in (429, 502, 503, 504):
+                        log.warning("retryable status %d", r.status)
+                        _raise_retryable_service_error(r.status)
+
+                    if r.status >= 400:  # noqa: PLR2004
+                        log.error("non-retryable status %d", r.status)
+                        _raise_service_error(r.status)
+
+                    return txt
+
+            except SessionExpiredError:  # noqa: PERF203
+                if self._username and self._password:
+                    await self.login(self._username, self._password)
+                else:
+                    raise
+            except (aiohttp.ClientError, asyncio.TimeoutError, ServiceError):
+                if attempt == pol.max_retry:
+                    log.exception("达到最大重试次数, 已放弃请求登录")
+                    raise
+                sleep = min(
+                    pol.max_sleep,
+                    pol.base_sleep * (2 ** (attempt - 1)),
+                ) + random.uniform(0, pol.jitter)  # noqa: S311
+                await asyncio.sleep(sleep)
+
+        msg = "unreachable"
+        raise ServiceError(msg)
+
+    async def request_json(self, method: str, path: str, **kwargs) -> dict:  # noqa: ANN003
+        """发送请求并解析 JSON 响应"""
+        txt = await self.request_text(method, path, **kwargs)
+        try:
+            return json.loads(txt)
+        except ValueError:
+            msg = "response is not json"
+            raise ServiceError(msg) from None

urp_academic_affairs_tools/config.py

@@ -0,0 +1,10 @@
+"""配置文件"""
+
+# 此处填入学号
+USERNAME = ""
+# 此处填入密码
+PASSWORD = ""
+# True = 仅测试  False = 提交
+DRY_RUN = True
+# 默认满分
+DEFAULT_CHOICE = "A"

urp_academic_affairs_tools/export/__init__.py

@@ -0,0 +1,3 @@
+from .excel import export_timetable_excel
+
+__all__ = ["export_timetable_excel"]

urp_academic_affairs_tools/export/excel.py

@@ -0,0 +1,75 @@
+"""导出课表到 Excel 文件"""
+
+import asyncio
+from typing import Any
+
+from openpyxl import Workbook
+from openpyxl.styles import Alignment, Font
+from openpyxl.utils import get_column_letter
+
+
+def _export_xlsx(courses: list[dict[str, Any]], filename: str) -> None:
+    wb = Workbook()
+    ws = wb.active
+    ws = wb.active
+    if ws is None:
+        return
+    ws.title = "本学期课表"
+
+    headers = ["课程名称", "任课教师", "学分", "星期", "节次", "周次", "教学楼", "教室"]
+    ws.append(headers)
+
+    header_style = Font(bold=True)
+    align_center = Alignment(horizontal="center", vertical="center", wrap_text=True)
+
+    for col in range(1, len(headers) + 1):
+        cell = ws.cell(row=1, column=col)
+        cell.font = header_style
+        cell.alignment = align_center
+        ws.column_dimensions[get_column_letter(col)].width = 16
+
+    weekday = {
+        1: "周一",
+        2: "周二",
+        3: "周三",
+        4: "周四",
+        5: "周五",
+        6: "周六",
+        7: "周日",
+    }
+
+    for item in courses:
+        day_raw = item.get("day")
+        day = weekday.get(day_raw, "") if isinstance(day_raw, int) else ""
+
+        start = item.get("start_session")
+        duration = item.get("duration")
+        section = (
+            f"{start}-{start + duration - 1}节"
+            if isinstance(start, int) and isinstance(duration, int)
+            else ""
+        )
+
+        ws.append(
+            [
+                item.get("course_name", ""),
+                (item.get("teacher") or "").replace("*", "").strip(),
+                item.get("credit", ""),
+                day,
+                section,
+                item.get("week_desc") or item.get("weeks") or "",
+                item.get("building") or item.get("teachingBuildingName") or "",
+                item.get("classroom") or item.get("classroomName") or "",
+            ],
+        )
+
+    for row in ws.iter_rows(min_row=2):
+        for cell in row:
+            cell.alignment = align_center
+
+    wb.save(filename)
+
+
+async def export_timetable_excel(courses: list[dict[str, Any]], filename: str) -> None:
+    """导出课表到 Excel"""
+    await asyncio.to_thread(_export_xlsx, courses, filename)

urp_academic_affairs_tools/main.py

@@ -0,0 +1,74 @@
+"""入口文件 main"""
+
+import asyncio
+import logging
+
+import aioconsole
+
+from client import AsyncJWSSession, fetch_tasks, get_this_semester_timetable
+from config import PASSWORD, USERNAME
+from export import export_timetable_excel
+from parser import TeachingEvaluationClient, parse_timetable
+
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s | %(levelname)-7s | %(name)s | %(message)s",
+    datefmt="%Y-%m-%d %H:%M:%S",
+    force=True,
+)
+log = logging.getLogger(__name__)
+
+
+def menu() -> None:
+    log.info("========================")
+    log.info("欢迎使用教务系统工具")
+    log.info("1. 抢课(开发中)")
+    log.info("2. 导出课表")
+    log.info("3. 教学评估")
+    log.info("0. 退出")
+    log.info("========================\n")
+
+
+async def handle_view_timetable(jws: AsyncJWSSession) -> None:
+    raw = await get_this_semester_timetable(jws)
+    courses = parse_timetable(raw)
+    if not courses:
+        log.warning("未查询到任何课程")
+        return
+    out = "本学期课表.xlsx"
+    await export_timetable_excel(courses, out)
+    log.info(f"本学期课表已导出：{out}")
+
+
+async def handle_teaching_evaluation(jws: AsyncJWSSession) -> None:
+    data = await fetch_tasks(jws)
+    await TeachingEvaluationClient().run(jws, data)
+    log.info("评教结束")
+
+
+async def main() -> None:
+    async with AsyncJWSSession() as jws:
+        await jws.login(USERNAME, PASSWORD)
+
+        while True:
+            menu()
+            choice = (await aioconsole.ainput("请输入选项：")).strip()
+
+            if choice == "1":
+                log.warning("抢课功能尚未实现")
+
+            elif choice == "2":
+                await handle_view_timetable(jws)
+
+            elif choice == "3":
+                await handle_teaching_evaluation(jws)
+
+            elif choice == "0":
+                break
+
+            else:
+                log.warning("无效选项")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

urp_academic_affairs_tools/parser/__init__.py

@@ -0,0 +1,4 @@
+from .evaluation import TeachingEvaluationClient
+from .timetable import parse_timetable
+
+__all__ = ["TeachingEvaluationClient", "parse_timetable"]

urp_academic_affairs_tools/parser/evaluation.py

@@ -0,0 +1,138 @@
+"""教学评估"""
+
+import logging
+import re
+
+from client.session import AsyncJWSSession
+from config import DEFAULT_CHOICE, DRY_RUN
+
+BASE_USL = "https://jws.qgxy.cn/student/teachingEvaluation"
+SUBMIT_URL = f"{BASE_USL}/teachingEvaluation/assessment"
+EVA_INDEX_URL = f"{BASE_USL}/evaluation/index"
+EVA_PAGE_URL = f"{BASE_USL}/evaluationPage"
+
+TOKEN_RE = re.compile(r'name="tokenValue"\s+value="([^"]+)"', re.IGNORECASE)
+CONFIRM_PHRASE = "我确认提交评教不可撤销"
+
+SCORE_MAP_A: dict[str, str] = {
+    "A": "10_1",
+    "B": "10_0.8",
+    "C": "10_0.6",
+    "D": "10_0.4",
+    "E": "10_0.2",
+}
+
+SCORE_MAP_B: dict[str, str] = {
+    "A": "10_1",
+    "B": "10_0.6",
+    "C": "10_0.5",
+    "D": "10_0.2",
+    "E": "10_0",
+}
+
+log = logging.getLogger(__name__)
+
+
+class TeachingEvaluationClient:
+    @staticmethod
+    def extract_token(html: str) -> str:
+        """获取toeknValue"""
+        m = TOKEN_RE.search(html or "")
+        if not m:
+            msg = "tokenValue not found"
+            raise RuntimeError(msg)
+        return m.group(1)
+
+    def open_evaluation_page(self, task: dict, token: str) -> dict[str, str]:
+        return {
+            "evaluatedPeople": task["evaluatedPeople"],
+            "evaluatedPeopleNumber": task["id"]["evaluatedPeople"],
+            "questionnaireCode": task["id"]["questionnaireCoding"],
+            "questionnaireName": task["questionnaire"]["questionnaireName"],
+            "coureSequenceNumber": task["id"]["coureSequenceNumber"],
+            "evaluationContentNumber": task["id"]["evaluationContentNumber"],
+            "evaluationContentContent": task["evaluationContent"],
+            "tokenValue": token,
+        }
+
+    def build_assessment_payload(
+        self,
+        task: dict,
+        token: str,
+        answers: dict[str, str],
+    ) -> dict[str, str]:
+        """构造assessment payload"""
+        payload: dict[str, str] = {
+            "optType": "submit",
+            "tokenValue": token,
+            "questionnaireCode": task["id"]["questionnaireCoding"],
+            "evaluationContent": task["id"]["evaluationContentNumber"],
+            "evaluatedPeopleNumber": task["id"]["evaluatedPeople"],
+            "count": "",
+        }
+        for qid, choice in answers.items():
+            payload[qid] = SCORE_MAP_A[choice]
+        payload["zgpj"] = "老师教学认真课程收获较大"
+        return payload
+
+    def final_confirm(self, tasks: list[dict], not_finished_num: int) -> None:
+        """最终确认"""
+        log.info(f"🚨 共 {not_finished_num} 门课程，一旦提交无法修改。\n")
+        log.info("你将评教以下课程：")
+        for t in tasks:
+            log.info(f" - {t['evaluatedPeople']} ｜ {t['evaluationContent']}")
+
+        log.info("\n如果你确认继续，请完整输入下面这句话：")
+        log.info(f"⌈{CONFIRM_PHRASE}⌋")
+
+        user_input: str = input("\n请输入确认语句：").strip()
+        if user_input != CONFIRM_PHRASE:
+            log.error("\n❌ 验证错误，已中止提交。")
+            raise SystemExit(1)
+        log.info("\n✅ 验证通过，开始提交评教。\n")
+
+    async def run(self, jws: AsyncJWSSession, data: dict) -> None:
+        """获取评教任务并执行评教"""
+        tasks_list: list[dict] = data.get("data", [])
+        not_finished_num: int = data["notFinishedNum"]
+        log.info(f"共有 {not_finished_num} 门课程待评教。\n")
+        if not_finished_num == 0:
+            log.info("✅ 无待评教任务，退出评教流程")
+        pending = [t for t in tasks_list if t.get("isEvaluated") == "否"]
+        if not pending:
+            return
+
+        answers = {
+            "0000000014": DEFAULT_CHOICE,
+            "0000000016": DEFAULT_CHOICE,
+            "0000000018": DEFAULT_CHOICE,
+            "0000000015": DEFAULT_CHOICE,
+            "0000000017": DEFAULT_CHOICE,
+            "0000000044": DEFAULT_CHOICE,
+            "0000000048": DEFAULT_CHOICE,
+            "0000000053": DEFAULT_CHOICE,
+            "0000000042": DEFAULT_CHOICE,
+            "0000000049": DEFAULT_CHOICE,
+        }
+
+        for task in pending:
+            html = await jws.request_text("GET", EVA_INDEX_URL)
+            token: str = self.extract_token(html)
+
+            page_form = self.open_evaluation_page(task, token)
+            await jws.request_text(
+                "POST",
+                EVA_PAGE_URL,
+                data=page_form,
+                allow_redirects=True,
+            )
+
+            payload = self.build_assessment_payload(task, token, answers)
+            if not DRY_RUN:
+                self.final_confirm(tasks_list, not_finished_num)
+                await jws.request_text(
+                    "POST",
+                    SUBMIT_URL,
+                    data=payload,
+                    allow_redirects=True,
+                )

urp_academic_affairs_tools/parser/timetable.py

@@ -0,0 +1,46 @@
+"""获取并解析课表数据的模块"""
+
+from typing import Any
+
+
+def parse_timetable(data: dict[str, Any]) -> list[dict[str, Any]]:
+    """
+    从教务系统返回的 JSON中解析出课表明细
+    """
+    result: list[dict[str, Any]] = []
+
+    xkxx_list = data.get("xkxx", [])
+    if not xkxx_list:
+        return result
+
+    for course_map in xkxx_list:
+        if not isinstance(course_map, dict):
+            continue
+
+        for course in course_map.values():
+            course_name = course.get("courseName", "")
+            teacher = course.get("attendClassTeacher", "").strip()
+            credit = course.get("unit", 0)
+
+            time_list = course.get("timeAndPlaceList", [])
+            if not time_list:
+                continue
+
+            result.extend(
+                {
+                    "course_name": course_name,
+                    "teacher": teacher,
+                    "day": t.get("classDay"),
+                    "start_session": t.get("classSessions"),
+                    "duration": t.get("continuingSession"),
+                    "weeks": t.get("classWeek"),
+                    "week_desc": t.get("weekDescription"),
+                    "campus": t.get("campusName"),
+                    "building": t.get("teachingBuildingName"),
+                    "classroom": t.get("classroomName"),
+                    "credit": credit,
+                }
+                for t in time_list
+            )
+
+    return result

urp_tools-0.2.3.3.dist-info/METADATA

@@ -0,0 +1,228 @@
+Metadata-Version: 2.4
+Name: urp-tools
+Version: 0.2.3.3
+Summary: URP Academic Affairs System Course Snatching Tool
+License: Apache License
+                                    Version 2.0, January 2004
+                                 http://www.apache.org/licenses/
+         
+            TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+         
+            1. Definitions.
+         
+               "License" shall mean the terms and conditions for use, reproduction,
+               and distribution as defined by Sections 1 through 9 of this document.
+         
+               "Licensor" shall mean the copyright owner or entity authorized by
+               the copyright owner that is granting the License.
+         
+               "Legal Entity" shall mean the union of the acting entity and all
+               other entities that control, are controlled by, or are under common
+               control with that entity. For the purposes of this definition,
+               "control" means (i) the power, direct or indirect, to cause the
+               direction or management of such entity, whether by contract or
+               otherwise, or (ii) ownership of fifty percent (50%) or more of the
+               outstanding shares, or (iii) beneficial ownership of such entity.
+         
+               "You" (or "Your") shall mean an individual or Legal Entity
+               exercising permissions granted by this License.
+         
+               "Source" form shall mean the preferred form for making modifications,
+               including but not limited to software source code, documentation
+               source, and configuration files.
+         
+               "Object" form shall mean any form resulting from mechanical
+               transformation or translation of a Source form, including but
+               not limited to compiled object code, generated documentation,
+               and conversions to other media types.
+         
+               "Work" shall mean the work of authorship, whether in Source or
+               Object form, made available under the License, as indicated by a
+               copyright notice that is included in or attached to the work
+               (an example is provided in the Appendix below).
+         
+               "Derivative Works" shall mean any work, whether in Source or Object
+               form, that is based on (or derived from) the Work and for which the
+               editorial revisions, annotations, elaborations, or other modifications
+               represent, as a whole, an original work of authorship. For the purposes
+               of this License, Derivative Works shall not include works that remain
+               separable from, or merely link (or bind by name) to the interfaces of,
+               the Work and Derivative Works thereof.
+         
+               "Contribution" shall mean any work of authorship, including
+               the original version of the Work and any modifications or additions
+               to that Work or Derivative Works thereof, that is intentionally
+               submitted to Licensor for inclusion in the Work by the copyright owner
+               or by an individual or Legal Entity authorized to submit on behalf of
+               the copyright owner. For the purposes of this definition, "submitted"
+               means any form of electronic, verbal, or written communication sent
+               to the Licensor or its representatives, including but not limited to
+               communication on electronic mailing lists, source code control systems,
+               and issue tracking systems that are managed by, or on behalf of, the
+               Licensor for the purpose of discussing and improving the Work, but
+               excluding communication that is conspicuously marked or otherwise
+               designated in writing by the copyright owner as "Not a Contribution."
+         
+               "Contributor" shall mean Licensor and any individual or Legal Entity
+               on behalf of whom a Contribution has been received by Licensor and
+               subsequently incorporated within the Work.
+         
+            2. Grant of Copyright License. Subject to the terms and conditions of
+               this License, each Contributor hereby grants to You a perpetual,
+               worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+               copyright license to reproduce, prepare Derivative Works of,
+               publicly display, publicly perform, sublicense, and distribute the
+               Work and such Derivative Works in Source or Object form.
+         
+            3. Grant of Patent License. Subject to the terms and conditions of
+               this License, each Contributor hereby grants to You a perpetual,
+               worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+               (except as stated in this section) patent license to make, have made,
+               use, offer to sell, sell, import, and otherwise transfer the Work,
+               where such license applies only to those patent claims licensable
+               by such Contributor that are necessarily infringed by their
+               Contribution(s) alone or by combination of their Contribution(s)
+               with the Work to which such Contribution(s) was submitted. If You
+               institute patent litigation against any entity (including a
+               cross-claim or counterclaim in a lawsuit) alleging that the Work
+               or a Contribution incorporated within the Work constitutes direct
+               or contributory patent infringement, then any patent licenses
+               granted to You under this License for that Work shall terminate
+               as of the date such litigation is filed.
+         
+            4. Redistribution. You may reproduce and distribute copies of the
+               Work or Derivative Works thereof in any medium, with or without
+               modifications, and in Source or Object form, provided that You
+               meet the following conditions:
+         
+               (a) You must give any other recipients of the Work or
+                   Derivative Works a copy of this License; and
+         
+               (b) You must cause any modified files to carry prominent notices
+                   stating that You changed the files; and
+         
+               (c) You must retain, in the Source form of any Derivative Works
+                   that You distribute, all copyright, patent, trademark, and
+                   attribution notices from the Source form of the Work,
+                   excluding those notices that do not pertain to any part of
+                   the Derivative Works; and
+         
+               (d) If the Work includes a "NOTICE" text file as part of its
+                   distribution, then any Derivative Works that You distribute must
+                   include a readable copy of the attribution notices contained
+                   within such NOTICE file, excluding those notices that do not
+                   pertain to any part of the Derivative Works, in at least one
+                   of the following places: within a NOTICE text file distributed
+                   as part of the Derivative Works; within the Source form or
+                   documentation, if provided along with the Derivative Works; or,
+                   within a display generated by the Derivative Works, if and
+                   wherever such third-party notices normally appear. The contents
+                   of the NOTICE file are for informational purposes only and
+                   do not modify the License. You may add Your own attribution
+                   notices within Derivative Works that You distribute, alongside
+                   or as an addendum to the NOTICE text from the Work, provided
+                   that such additional attribution notices cannot be construed
+                   as modifying the License.
+         
+               You may add Your own copyright statement to Your modifications and
+               may provide additional or different license terms and conditions
+               for use, reproduction, or distribution of Your modifications, or
+               for any such Derivative Works as a whole, provided Your use,
+               reproduction, and distribution of the Work otherwise complies with
+               the conditions stated in this License.
+         
+            5. Submission of Contributions. Unless You explicitly state otherwise,
+               any Contribution intentionally submitted for inclusion in the Work
+               by You to the Licensor shall be under the terms and conditions of
+               this License, without any additional terms or conditions.
+               Notwithstanding the above, nothing herein shall supersede or modify
+               the terms of any separate license agreement you may have executed
+               with Licensor regarding such Contributions.
+         
+            6. Trademarks. This License does not grant permission to use the trade
+               names, trademarks, service marks, or product names of the Licensor,
+               except as required for reasonable and customary use in describing the
+               origin of the Work and reproducing the content of the NOTICE file.
+         
+            7. Disclaimer of Warranty. Unless required by applicable law or
+               agreed to in writing, Licensor provides the Work (and each
+               Contributor provides its Contributions) on an "AS IS" BASIS,
+               WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+               implied, including, without limitation, any warranties or conditions
+               of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+               PARTICULAR PURPOSE. You are solely responsible for determining the
+               appropriateness of using or redistributing the Work and assume any
+               risks associated with Your exercise of permissions under this License.
+         
+            8. Limitation of Liability. In no event and under no legal theory,
+               whether in tort (including negligence), contract, or otherwise,
+               unless required by applicable law (such as deliberate and grossly
+               negligent acts) or agreed to in writing, shall any Contributor be
+               liable to You for damages, including any direct, indirect, special,
+               incidental, or consequential damages of any character arising as a
+               result of this License or out of the use or inability to use the
+               Work (including but not limited to damages for loss of goodwill,
+               work stoppage, computer failure or malfunction, or any and all
+               other commercial damages or losses), even if such Contributor
+               has been advised of the possibility of such damages.
+         
+            9. Accepting Warranty or Additional Liability. While redistributing
+               the Work or Derivative Works thereof, You may choose to offer,
+               and charge a fee for, acceptance of support, warranty, indemnity,
+               or other liability obligations and/or rights consistent with this
+               License. However, in accepting such obligations, You may act only
+               on Your own behalf and on Your sole responsibility, not on behalf
+               of any other Contributor, and only if You agree to indemnify,
+               defend, and hold each Contributor harmless for any liability
+               incurred by, or claims asserted against, such Contributor by reason
+               of your accepting any such warranty or additional liability.
+         
+            END OF TERMS AND CONDITIONS
+         
+            APPENDIX: How to apply the Apache License to your work.
+         
+               To apply the Apache License to your work, attach the following
+               boilerplate notice, with the fields enclosed by brackets "[]"
+               replaced with your own identifying information. (Don't include
+               the brackets!)  The text should be enclosed in the appropriate
+               comment syntax for the file format. We also recommend that a
+               file or class name and description of purpose be included on the
+               same "printed page" as the copyright notice for easier
+               identification within third-party archives.
+         
+            Copyright 2026 Reversedeer
+         
+            Licensed under the Apache License, Version 2.0 (the "License");
+            you may not use this file except in compliance with the License.
+            You may obtain a copy of the License at
+         
+                http://www.apache.org/licenses/LICENSE-2.0
+         
+            Unless required by applicable law or agreed to in writing, software
+            distributed under the License is distributed on an "AS IS" BASIS,
+            WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+            See the License for the specific language governing permissions and
+            limitations under the License.
+License-File: LICENSE
+Author: Reversedeer
+Author-email: ysjvillmark@gmail.com
+Requires-Python: >=3.10,<3.11
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Requires-Dist: aioconsole (>=0.8.2,<0.9.0)
+Requires-Dist: aiofiles (>=25.1.0,<26.0.0)
+Requires-Dist: aiohttp (>=3.13.3,<4.0.0)
+Requires-Dist: ddddocr (==1.4.7)
+Requires-Dist: onnxruntime (==1.23.2)
+Requires-Dist: openpyxl (>=3.1.5,<4.0.0)
+Requires-Dist: pillow (==9.5.0)
+Project-URL: Homepage, https://github.com/Reversedeer/urp-academic-affairs-tools
+Project-URL: Issues, https://github.com/Reversedeer/urp-academic-affairs-tools/issues
+Project-URL: Repository, https://github.com/Reversedeer/urp-academic-affairs-tools.git
+Description-Content-Type: text/markdown
+
+# URP综合教务管理系统
+
+version 4.1.0
+

urp_tools-0.2.3.3.dist-info/RECORD

@@ -0,0 +1,15 @@
+urp_academic_affairs_tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+urp_academic_affairs_tools/client/__init__.py,sha256=FFwC8Romq0Qc91JeSE8YZ30nDn7BtzQjtF5eUftvt5A,172
+urp_academic_affairs_tools/client/api.py,sha256=MOk390FrB3ZAxq7D7e7mfg5ubnZUxgoYapJyICoY5b0,477
+urp_academic_affairs_tools/client/session.py,sha256=778po8z7X1HgClVaglLbG-sVkiN_pTttrk-8MjJ8aKI,15485
+urp_academic_affairs_tools/config.py,sha256=A18K8WEP_ck7Rlhr_Fz_6ulORf-v2D-i_2OniCiDT5U,176
+urp_academic_affairs_tools/export/__init__.py,sha256=vpLcfBcPxGMpGFQAUXsDNIgHaAnCWEBRRhw5H_cvT5U,80
+urp_academic_affairs_tools/export/excel.py,sha256=8itCLJm156p6D5CKHVaCTKoDlMqznLn51yXkhLWLL0Q,2218
+urp_academic_affairs_tools/main.py,sha256=1Z4Y6DXMyP6Ey7UFl48BlhwsoWfvTPBGKOKNIZdQ6xE,1977
+urp_academic_affairs_tools/parser/__init__.py,sha256=AZBwwuT93pBNLrPLrfBiK7fgAnBKj3QvS71jiTGFwEA,147
+urp_academic_affairs_tools/parser/evaluation.py,sha256=TO2Wfs-OZ5RXDH3XH72s4UknOOTFFk5l1hFMgvSqMRY,4839
+urp_academic_affairs_tools/parser/timetable.py,sha256=TiEQLW7uslzd80bqeQRLg8mPhcvhb-H_fviwHi2O_ak,1458
+urp_tools-0.2.3.3.dist-info/METADATA,sha256=p0AonvQXyh9_pcbeJ7Ay0WEPocIGF7P4TmixqRaSMCE,14099
+urp_tools-0.2.3.3.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
+urp_tools-0.2.3.3.dist-info/licenses/LICENSE,sha256=0WXPTAQsBJfkLUU4c2U1_BGRd4mxyOznKL5b7woPmCc,11341
+urp_tools-0.2.3.3.dist-info/RECORD,,

urp_tools-0.2.3.3.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.3.1
+Root-Is-Purelib: true
+Tag: py3-none-any

urp_tools-0.2.3.3.dist-info/licenses/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Reversedeer
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.