sysu-check-in 0.1.0__tar.gz

sysu_check_in-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Xiao Li
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sysu_check_in-0.1.0/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: sysu-check-in
+Version: 0.1.0
+Summary: Command-line client for SYSU face-recognition check-in
+Keywords: sysu,check-in,face-check-in,cli
+Author: Xiao Li
+Author-email: Xiao Li <xiaoli3397@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Dist: requests>=2.34.2
+Requires-Dist: pycryptodome>=3.23.0
+Requires-Python: >=3.10
+Project-URL: Homepage, https://github.com/undefined443/sysu-check-in
+Project-URL: Issues, https://github.com/undefined443/sysu-check-in/issues
+Project-URL: Repository, https://github.com/undefined443/sysu-check-in
+Description-Content-Type: text/markdown
+
+# sysu-check-in
+
+[![CI](https://github.com/undefined443/sysu-check-in/actions/workflows/ci.yml/badge.svg)](https://github.com/undefined443/sysu-check-in/actions/workflows/ci.yml)
+
+A command-line client for completing SYSU check-in activities.
+
+## Installation
+
+Install the latest release from PyPI:
+
+```bash
+uv tool install sysu-check-in
+```
+
+## Usage
+
+Save the JPEG face image to submit as `face.jpg`, then run:
+
+```bash
+sysu-check-in <student-id>
+```
+
+You can also supply a different image path:
+
+```bash
+sysu-check-in <student-id> --image <image-path>
+```
+
+The command prints the raw response from the last required submission. It exits with a non-zero status and an error message if the image is missing, the request fails, an activity is unavailable, or the service rejects a submission.
+
+## Development
+
+Install the Git hooks once:
+
+```bash
+uv run --group dev pre-commit install
+```
+
+Run the test suite and static checks with:
+
+```bash
+uv run --group dev pytest
+uv run --group dev ruff check .
+uv run --group dev pyright
+```
+
+## License
+
+Distributed under the [MIT License](LICENSE).

sysu_check_in-0.1.0/README.md

@@ -0,0 +1,49 @@
+# sysu-check-in
+
+[![CI](https://github.com/undefined443/sysu-check-in/actions/workflows/ci.yml/badge.svg)](https://github.com/undefined443/sysu-check-in/actions/workflows/ci.yml)
+
+A command-line client for completing SYSU check-in activities.
+
+## Installation
+
+Install the latest release from PyPI:
+
+```bash
+uv tool install sysu-check-in
+```
+
+## Usage
+
+Save the JPEG face image to submit as `face.jpg`, then run:
+
+```bash
+sysu-check-in <student-id>
+```
+
+You can also supply a different image path:
+
+```bash
+sysu-check-in <student-id> --image <image-path>
+```
+
+The command prints the raw response from the last required submission. It exits with a non-zero status and an error message if the image is missing, the request fails, an activity is unavailable, or the service rejects a submission.
+
+## Development
+
+Install the Git hooks once:
+
+```bash
+uv run --group dev pre-commit install
+```
+
+Run the test suite and static checks with:
+
+```bash
+uv run --group dev pytest
+uv run --group dev ruff check .
+uv run --group dev pyright
+```
+
+## License
+
+Distributed under the [MIT License](LICENSE).

sysu_check_in-0.1.0/pyproject.toml

@@ -0,0 +1,79 @@
+[project]
+name = "sysu-check-in"
+version = "0.1.0"
+description = "Command-line client for SYSU face-recognition check-in"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "sysu",
+    "check-in",
+    "face-check-in",
+    "cli",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Utilities",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "requests>=2.34.2",
+    "pycryptodome>=3.23.0",
+]
+
+[[project.authors]]
+name = "Xiao Li"
+email = "xiaoli3397@gmail.com"
+
+[project.scripts]
+sysu-check-in = "sysu_check_in.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/undefined443/sysu-check-in"
+Issues = "https://github.com/undefined443/sysu-check-in/issues"
+Repository = "https://github.com/undefined443/sysu-check-in"
+
+[build-system]
+requires = ["uv_build>=0.12.19,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pyright>=1.1.400",
+    "pre-commit>=4.0",
+    "pytest>=8.3",
+    "ruff>=0.11",
+    "twine>=7.0.0",
+]
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+]
+
+[tool.pyright]
+include = [
+    "src",
+    "tests",
+]
+pythonVersion = "3.10"
+typeCheckingMode = "standard"
+
+[[tool.uv.index]]
+name = "pypi"
+url = "https://pypi.org/simple"
+default = true

sysu_check_in-0.1.0/pyproject.toml.orig

@@ -0,0 +1,66 @@
+[project]
+name = "sysu-check-in"
+version = "0.1.0"
+description = "Command-line client for SYSU face-recognition check-in"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["sysu", "check-in", "face-check-in", "cli"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Utilities",
+]
+authors = [
+    { name = "Xiao Li", email = "xiaoli3397@gmail.com" }
+]
+requires-python = ">=3.10"
+dependencies = [
+    "requests>=2.34.2",
+    "pycryptodome>=3.23.0",
+]
+
+[project.scripts]
+sysu-check-in = "sysu_check_in.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/undefined443/sysu-check-in"
+Issues = "https://github.com/undefined443/sysu-check-in/issues"
+Repository = "https://github.com/undefined443/sysu-check-in"
+
+[build-system]
+requires = ["uv_build>=0.12.19,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pyright>=1.1.400",
+    "pre-commit>=4.0",
+    "pytest>=8.3",
+    "ruff>=0.11",
+    "twine>=7.0.0",
+]
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]
+
+[tool.pyright]
+include = ["src", "tests"]
+pythonVersion = "3.10"
+typeCheckingMode = "standard"
+
+[[tool.uv.index]]
+name = "pypi"
+url = "https://pypi.org/simple"
+default = true

sysu_check_in-0.1.0/src/sysu_check_in/__init__.py

@@ -0,0 +1,15 @@
+"""SYSU face-recognition check-in package."""
+
+from sysu_check_in.core import (
+    DEFAULT_IMAGE_PATH,
+    CheckInRejectedError,
+    NoActiveActivityError,
+    check_in,
+)
+
+__all__ = [
+    "DEFAULT_IMAGE_PATH",
+    "CheckInRejectedError",
+    "NoActiveActivityError",
+    "check_in",
+]

sysu_check_in-0.1.0/src/sysu_check_in/__main__.py

@@ -0,0 +1,5 @@
+"""Run the sysu-check-in command as a module."""
+
+from sysu_check_in.cli import main
+
+main()

sysu_check_in-0.1.0/src/sysu_check_in/cli.py

@@ -0,0 +1,49 @@
+"""Command-line interface for sysu_check_in."""
+
+import argparse
+from importlib.metadata import version
+
+import requests
+
+from sysu_check_in import core
+
+
+def _parse_args() -> argparse.Namespace:
+    """Parse command-line arguments.
+
+    Returns:
+        Parsed command-line arguments.
+    """
+    parser = argparse.ArgumentParser(
+        prog="sysu-check-in",
+        description="Submit a face image to the SYSU check-in service.",
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"%(prog)s {version('sysu-check-in')}",
+    )
+    parser.add_argument("student_id", help="Student ID used for check-in.")
+    parser.add_argument(
+        "--image",
+        default=core.DEFAULT_IMAGE_PATH,
+        metavar="PATH",
+        help=f"Path to the JPEG face image (default: {core.DEFAULT_IMAGE_PATH}).",
+    )
+    return parser.parse_args()
+
+
+def main() -> None:
+    """Run the command-line interface."""
+    args = _parse_args()
+    try:
+        print(core.check_in(args.student_id, args.image))
+    except (
+        FileNotFoundError,
+        core.CheckInRejectedError,
+        core.NoActiveActivityError,
+        requests.RequestException,
+        ValueError,
+        KeyError,
+    ) as error:
+        raise SystemExit(f"Check-in failed: {error}") from error

sysu_check_in-0.1.0/src/sysu_check_in/core.py

@@ -0,0 +1,203 @@
+"""Client for the SYSU face-recognition check-in service."""
+
+import base64
+import time
+from dataclasses import dataclass
+
+import requests
+from Crypto.Cipher import AES
+from Crypto.Util.Padding import pad
+
+# AES-128 key shared by every request; the hex decodes to b"sh12345678901234".
+_AES_KEY = bytes.fromhex("73683132333435363738393031323334")
+
+_BASE_URL = "https://facerecog.sysu.edu.cn/sign"
+_ACTIVE_SIGN_STATUS = 2
+
+DEFAULT_IMAGE_PATH = "face.jpg"
+
+# Campus coordinates used for position submission.
+_CAMPUS_LONGITUDE = "113.9539"
+_CAMPUS_LATITUDE = "22.801604"
+
+_HEADERS = {
+    "User-Agent": (
+        "Mozilla/5.0 (Linux; Android 16; FLC-AN00 Build/HONORFLC-AN00; wv) "
+        "AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 "
+        "Chrome/138.0.7204.180 Mobile Safari/537.36 XWEB/1380347 "
+        "MMWEBSDK/20250202 MMWEBID/6351 wxwork/5.0.6.66174 "
+        "MicroMessenger/8.0.28.48(0x28001c30) MiniProgramEnv/android "
+        "Luggage/3.0.2.95ef3f83 NetType/WIFI Language/en ABI/arm64"
+    ),
+    "Accept-Encoding": "gzip,compress,br,deflate",
+    "charset": "utf-8",
+}
+
+
+class NoActiveActivityError(Exception):
+    """Raised when the service has no active check-in activity."""
+
+
+class CheckInRejectedError(Exception):
+    """Raised when the service rejects a check-in submission."""
+
+
+@dataclass(frozen=True)
+class _Activity:
+    """Details needed to submit an active check-in activity."""
+
+    activity_id: str
+    collects_gps: bool
+    requires_face: bool
+
+
+def _timestamp() -> int:
+    """Return the current Unix timestamp in seconds."""
+    return int(time.time())
+
+
+def _timestamp_milliseconds() -> int:
+    """Return the current Unix timestamp in milliseconds."""
+    return int(time.time() * 1000)
+
+
+def _encrypt(plaintext: str) -> str:
+    """Encrypt a payload with AES-128-ECB.
+
+    Args:
+        plaintext: Plain-text payload to encrypt.
+
+    Returns:
+        The encrypted payload encoded as a hexadecimal string.
+    """
+    cipher = AES.new(_AES_KEY, AES.MODE_ECB)
+    return cipher.encrypt(pad(plaintext.encode(), AES.block_size)).hex()
+
+
+def _read_image_base64(image_path: str) -> str:
+    """Read an image file and encode its content as Base64.
+
+    Args:
+        image_path: Path to the image file.
+
+    Returns:
+        The Base64-encoded image content.
+    """
+    with open(image_path, "rb") as file:
+        return base64.b64encode(file.read()).decode("utf-8")
+
+
+def _post(endpoint_path: str, form_data: dict[str, str]) -> requests.Response:
+    """Send form data to a check-in endpoint.
+
+    Args:
+        endpoint_path: Endpoint path relative to the service base URL.
+        form_data: Form data to send in the request body.
+
+    Returns:
+        The successful HTTP response.
+    """
+    response = requests.post(
+        f"{_BASE_URL}/{endpoint_path}",
+        data=form_data,
+        headers=_HEADERS,
+        timeout=15,
+    )
+    response.raise_for_status()
+    return response
+
+
+def _raise_for_rejection(response: requests.Response) -> None:
+    """Raise an error when the service reports a rejected submission.
+
+    Args:
+        response: HTTP response returned by the check-in service.
+
+    Raises:
+        CheckInRejectedError: If the service response has a non-success code.
+    """
+    payload = response.json()
+    if payload["code"] != 1:
+        raise CheckInRejectedError(payload["msg"])
+
+
+def _get_active_activity(student_id: str) -> _Activity:
+    """Fetch details for the currently active check-in activity.
+
+    Args:
+        student_id: Student ID used for check-in.
+
+    Returns:
+        Details of the active check-in activity.
+    """
+    response = _post(
+        "getActivityList", {"sKey": _encrypt(f"{student_id}##{_timestamp()}")}
+    )
+    activities = response.json()["data"]["rows"]
+    for activity in activities:
+        if activity["iSignStatus"] == _ACTIVE_SIGN_STATUS:
+            return _Activity(
+                activity_id=activity["sActId"],
+                collects_gps=activity["iCollectGPS"] == 1,
+                requires_face=activity["isNeedFace"] == 1,
+            )
+    raise NoActiveActivityError("No active check-in activity is available.")
+
+
+def _submit_gps(student_id: str, activity_id: str) -> str:
+    """Submit the campus position for an activity.
+
+    Args:
+        student_id: Student ID used for check-in.
+        activity_id: ID of the active check-in activity.
+
+    Returns:
+        The raw response returned by the check-in service.
+    """
+    plaintext = (
+        f"{student_id}##{activity_id}####{_CAMPUS_LONGITUDE}##"
+        f"{_CAMPUS_LATITUDE}##{_timestamp_milliseconds()}"
+    )
+    response = _post("submitPosition", {"sKey": _encrypt(plaintext)})
+    _raise_for_rejection(response)
+    return response.text
+
+
+def _submit_face(student_id: str, activity_id: str, image_path: str) -> str:
+    """Submit a face image to complete the check-in.
+
+    Args:
+        student_id: Student ID used for check-in.
+        activity_id: ID of the active check-in activity.
+        image_path: Path to the JPEG face image.
+
+    Returns:
+        The raw response returned by the check-in service.
+    """
+    face_image_base64 = _read_image_base64(image_path)
+    form_data = {
+        "sKey": _encrypt(f"{student_id}##{activity_id}##{_timestamp()}"),
+        "sImage": f"data:image/jpeg;base64,{face_image_base64}",
+    }
+    response = _post("submitSignFace", form_data)
+    _raise_for_rejection(response)
+    return response.text
+
+
+def check_in(student_id: str, image_path: str = DEFAULT_IMAGE_PATH) -> str:
+    """Perform all required check-in submissions for a student ID.
+
+    Args:
+        student_id: Student ID used for check-in.
+        image_path: Path to the JPEG face image.
+
+    Returns:
+        The raw response returned by the check-in service.
+    """
+    activity = _get_active_activity(student_id)
+    response = ""
+    if activity.collects_gps:
+        response = _submit_gps(student_id, activity.activity_id)
+    if activity.requires_face:
+        response = _submit_face(student_id, activity.activity_id, image_path)
+    return response