xcpcio 0.63.2__tar.gz → 0.76.8__tar.gz

xcpcio-0.76.8/.gitignore

@@ -0,0 +1,10 @@
+.venv/
+.pytest_cache/
+.ruff_cache/
+__pycache__/
+ccs-specs/
+output/
+
+.env
+
+xcpcio/__version__.py

xcpcio-0.76.8/.python-version

@@ -0,0 +1 @@
+3.12.11

xcpcio-0.76.8/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: xcpcio
+Version: 0.76.8
+Summary: xcpcio python lib
+Project-URL: homepage, https://github.com/xcpcio/xcpcio
+Project-URL: documentation, https://github.com/xcpcio/xcpcio
+Project-URL: repository, https://github.com/xcpcio/xcpcio
+Author-email: Dup4 <hi@dup4.com>
+Maintainer-email: Dup4 <hi@dup4.com>, cubercsl <hi@cubercsl.site>
+License-Expression: MIT
+Keywords: xcpcio
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: aiofiles>=23.0.0
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: fastapi>=0.117.1
+Requires-Dist: pydantic>=2.11.7
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: semver>=3.0.0
+Requires-Dist: tenacity>=8.0.0
+Requires-Dist: uvicorn>=0.36.0
+Requires-Dist: zstandard>=0.25.0
+Description-Content-Type: text/markdown
+
+# xcpcio-python
+
+Python library and CLI tools for XCPCIO.
+
+## Features
+
+- **Type Definitions**: Pydantic models for contest data structures (teams, submissions, problems, etc.)
+- **Constants**: Shared constants for submission statuses, time units, and penalty calculations
+- **CCS Archiver**: CLI tool to archive CCS API data to contest package format
+- **Contest API Server**: CLI tool to serve contest packages via CCS API
+- **Cross-Language Compatibility**: Mirrors TypeScript types for data consistency
+
+## Installation
+
+```bash
+pip install xcpcio
+```
+
+Or install with [uv](https://github.com/astral-sh/uv):
+
+```bash
+uv add xcpcio
+```
+
+## Development
+
+### Setup
+
+```bash
+# Clone repository
+git clone https://github.com/xcpcio/xcpcio.git
+cd xcpcio/python
+
+# Install dependencies with uv
+uv sync
+```
+
+### Testing
+
+```bash
+# Run tests
+uv run pytest
+
+# Run specific test file
+uv run pytest tests/test_types.py
+```
+
+## Documentation
+
+For detailed documentation, visit:
+
+- [Clics Utility Guide](https://xcpcio.com/guide/clics-utility)
+
+## License
+
+[MIT](../LICENSE) License &copy; 2020 - PRESENT [XCPCIO][xcpcio]
+
+[xcpcio]: https://xcpcio.com

xcpcio-0.76.8/README.md

@@ -0,0 +1,58 @@
+# xcpcio-python
+
+Python library and CLI tools for XCPCIO.
+
+## Features
+
+- **Type Definitions**: Pydantic models for contest data structures (teams, submissions, problems, etc.)
+- **Constants**: Shared constants for submission statuses, time units, and penalty calculations
+- **CCS Archiver**: CLI tool to archive CCS API data to contest package format
+- **Contest API Server**: CLI tool to serve contest packages via CCS API
+- **Cross-Language Compatibility**: Mirrors TypeScript types for data consistency
+
+## Installation
+
+```bash
+pip install xcpcio
+```
+
+Or install with [uv](https://github.com/astral-sh/uv):
+
+```bash
+uv add xcpcio
+```
+
+## Development
+
+### Setup
+
+```bash
+# Clone repository
+git clone https://github.com/xcpcio/xcpcio.git
+cd xcpcio/python
+
+# Install dependencies with uv
+uv sync
+```
+
+### Testing
+
+```bash
+# Run tests
+uv run pytest
+
+# Run specific test file
+uv run pytest tests/test_types.py
+```
+
+## Documentation
+
+For detailed documentation, visit:
+
+- [Clics Utility Guide](https://xcpcio.com/guide/clics-utility)
+
+## License
+
+[MIT](../LICENSE) License © 2020 - PRESENT [XCPCIO][xcpcio]
+
+[xcpcio]: https://xcpcio.com

{xcpcio-0.63.2 → xcpcio-0.76.8}/pyproject.toml

@@ -1,9 +1,12 @@
 [project]
 name = "xcpcio"
-version = "0.63.2"
 description = "xcpcio python lib"
 readme = "README.md"
 authors = [ { name = "Dup4", email = "hi@dup4.com" } ]
+maintainers = [
+    { name = "Dup4", email = "hi@dup4.com" },
+    { name = "cubercsl", email = "hi@cubercsl.site" },
+]
 license = "MIT"
 keywords = [ "xcpcio" ]
 classifiers = [
@@ -15,19 +18,48 @@ classifiers = [
   "Programming Language :: Python :: 3.13",
 ]
 requires-python = ">=3.11"
-dependencies = [ "pydantic>=2.11.7", ]
+dependencies = [
+  "pydantic>=2.11.7",
+  "aiohttp>=3.8.0",
+  "aiofiles>=23.0.0",
+  "click>=8.0.0",
+  "pyyaml>=6.0.0",
+  "semver>=3.0.0",
+  "tenacity>=8.0.0",
+  "fastapi>=0.117.1",
+  "uvicorn>=0.36.0",
+  "zstandard>=0.25.0",
+]
+dynamic = ["version"]
 
 [project.urls]
 homepage = "https://github.com/xcpcio/xcpcio"
 documentation = "https://github.com/xcpcio/xcpcio"
 repository = "https://github.com/xcpcio/xcpcio"
 
+[project.scripts]
+clics-archiver = "xcpcio.app.clics_archiver:main"
+clics-server = "xcpcio.app.clics_server:main"
+clics-uploader = "xcpcio.app.clics_uploader:main"
+
 [tool.ruff]
 line-length = 120
 
+[build-system]
+requires = ["hatchling", "hatch-nodejs-version"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "nodejs"
+path = "../package.json"
+
+[tool.hatch.build.hooks.version]
+path = "xcpcio/__version__.py"
+
 [dependency-groups]
 dev = [
  "datamodel-code-generator[http]>=0.33.0",
+ "hatch>=1.14.2",
  "pytest>=8.4.2",
  "ruff>=0.4.0",
 ]

xcpcio-0.76.8/scripts/generate_ccs_models.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+
+set -euo pipefail
+
+CUR_DIR="$(dirname "$(realpath "${BASH_SOURCE[0]}")")"
+PYTHON_DIR="$(dirname "${CUR_DIR}")"
+CCS_SPECS_DIR="${PYTHON_DIR}/ccs-specs"
+CCS_MODELS_DIR="${PYTHON_DIR}/xcpcio/clics/model"
+
+BRANCH="${1:-2023-06}"
+CCS_REPO_URL="https://github.com/icpc/ccs-specs.git"
+
+MODEL_DIR_NAME="model_${BRANCH//-/_}"
+OUTPUT_DIR="${CCS_MODELS_DIR}/${MODEL_DIR_NAME}"
+
+if [[ -d "${CCS_SPECS_DIR}" ]]; then
+  echo "Please remove existing ${CCS_SPECS_DIR} directory first"
+  exit 1
+fi
+
+if [[ -d "${OUTPUT_DIR}" ]]; then
+  echo "Please remove existing ${OUTPUT_DIR} directory first"
+  exit 1
+fi
+
+echo "Generating CCS models for branch: ${BRANCH}"
+
+pushd "${PYTHON_DIR}"
+
+echo "Cloning CCS specs repository (branch: ${BRANCH})..."
+git clone --branch "${BRANCH}" --depth 1 "${CCS_REPO_URL}" ccs-specs
+
+echo "Creating output directory: ${OUTPUT_DIR}"
+mkdir -p "${OUTPUT_DIR}"
+
+ENTRY_POINT="${CCS_SPECS_DIR}/json-schema/event-feed-array.json"
+
+if [[ ! -f "${ENTRY_POINT}" ]]; then
+  echo "Error: ${ENTRY_POINT} not found in ccs-specs directory"
+  exit 2
+fi
+
+echo "Generating Python models using datamodel-codegen..."
+uv run datamodel-codegen \
+  --input "${ENTRY_POINT}" \
+  --input-file-type jsonschema \
+  --output-model-type pydantic_v2.BaseModel \
+  --target-python-version "3.11" \
+  --output "${OUTPUT_DIR}/model.py"
+
+echo "Creating __init__.py file..."
+cat >"${OUTPUT_DIR}/__init__.py" <<EOF
+"""
+CCS (Contest Control System) models for branch ${BRANCH}.
+
+Auto-generated from https://github.com/icpc/ccs-specs/tree/${BRANCH}
+"""
+
+from .model import * # noqa: F403
+EOF
+
+echo "CCS models generated successfully!"
+echo "Output directory: ${OUTPUT_DIR}"
+echo "Generated files:"
+ls -la "${OUTPUT_DIR}"
+
+echo "Done!"
+
+popd

{xcpcio-0.63.2 → xcpcio-0.76.8}/tests/test_contest.py

@@ -1,7 +1,5 @@
-
-
 from xcpcio import constants
-from xcpcio.types import Color, Contest, ContestOptions, Image
+from xcpcio.types import BalloonColor, Contest, ContestOptions, Image
 
 
 class TestContest:
@@ -10,15 +8,14 @@ class TestContest:
     def test_contest_creation_defaults(self):
         """Test Contest creation with default values"""
         contest = Contest()
-        
+
         assert contest.contest_name == ""
         assert contest.start_time == 0
         assert contest.end_time == 0
         assert contest.frozen_time == 60 * 60  # 1 hour
-        assert contest.unfrozen_time == 0x3F3F3F3F3F3F3F3F
+        assert contest.thaw_time == 0x3F3F3F3F3F3F3F3F
         assert contest.penalty == 20 * 60  # 20 minutes
-        assert contest.problem_quantity == 0
-        assert contest.problem_id == []
+        assert contest.problem_id is None
         assert contest.organization == "School"
         assert contest.medal is None
         assert contest.balloon_color is None
@@ -30,18 +27,17 @@ class TestContest:
         assert contest.tag is None
         assert contest.board_link is None
         assert contest.version is None
-        
+
         # Check default values
         assert contest.status_time_display == constants.FULL_STATUS_TIME_DISPLAY
-        assert isinstance(contest.options, ContestOptions)
+        assert contest.options is None
 
     def test_contest_creation_with_values(self):
         """Test Contest creation with provided values"""
         contest_options = ContestOptions(
-            calculation_of_penalty=constants.CALCULATION_OF_PENALTY_IN_SECONDS,
-            has_reaction_videos=True
+            calculation_of_penalty=constants.CALCULATION_OF_PENALTY_IN_SECONDS, has_reaction_videos=True
         )
-        
+
         contest = Contest(
             contest_name="ICPC World Finals 2024",
             start_time=1234567890,
@@ -52,13 +48,12 @@ class TestContest:
             problem_id=["A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L"],
             organization="ICPC",
             medal="icpc",  # Use Literal value
-            options=contest_options
+            options=contest_options,
         )
-        
+
         assert contest.contest_name == "ICPC World Finals 2024"
         assert contest.start_time == 1234567890
         assert contest.end_time == 1234567890 + 5 * 60 * 60
-        assert contest.problem_quantity == 12
         assert len(contest.problem_id) == 12
         assert contest.problem_id[0] == "A"
         assert contest.problem_id[-1] == "L"
@@ -72,18 +67,16 @@ class TestContest:
             contest_name="Test Contest",
             start_time=1000000000,
             end_time=1000000000 + 60 * 60 * 5,
-            problem_quantity=5,
             problem_id=["A", "B", "C", "D", "E"],
-            organization="Test Org"
+            organization="Test Org",
         )
-        
+
         # Test model_dump
         contest_dict = contest.model_dump()
         assert contest_dict["contest_name"] == "Test Contest"
         assert contest_dict["start_time"] == 1000000000
-        assert contest_dict["problem_quantity"] == 5
         assert contest_dict["organization"] == "Test Org"
-        
+
         # Test JSON round-trip
         contest_json = contest.model_dump_json()
         reconstructed_contest = Contest.model_validate_json(contest_json)
@@ -92,21 +85,20 @@ class TestContest:
     def test_contest_with_colors_and_images(self):
         """Test Contest with balloon colors, logo, and banner"""
         colors = [
-            Color(color="#fff", background_color="rgba(255, 0, 0, 0.7)"),
-            Color(color="#000", background_color="rgba(0, 255, 0, 0.7)")
+            BalloonColor(color="#fff", background_color="rgba(255, 0, 0, 0.7)"),
+            BalloonColor(color="#000", background_color="rgba(0, 255, 0, 0.7)"),
         ]
         logo = Image(url="https://example.com/logo.png", type="png")
         banner = Image(url="https://example.com/banner.jpg", type="jpg")
-        
+
         contest = Contest(
             contest_name="Contest with Media",
-            problem_quantity=2,
             balloon_color=colors,
             logo=logo,
             banner=banner,
-            banner_mode="ALL"  # Use correct Literal value
+            banner_mode="ALL",  # Use correct Literal value
         )
-        
+
         assert len(contest.balloon_color) == 2
         assert contest.balloon_color[0].color == "#fff"
         assert contest.balloon_color[1].background_color == "rgba(0, 255, 0, 0.7)"
@@ -117,59 +109,59 @@ class TestContest:
     def test_append_balloon_color(self):
         """Test append_balloon_color method"""
         contest = Contest()
-        
+
         # Initially no colors
         assert contest.balloon_color is None
-        
+
         # Add first color
-        red_color = Color(color="#fff", background_color="red")
+        red_color = BalloonColor(color="#fff", background_color="red")
         contest.append_balloon_color(red_color)
-        
+
         assert contest.balloon_color is not None
         assert len(contest.balloon_color) == 1
         assert contest.balloon_color[0] == red_color
-        
+
         # Add second color
-        blue_color = Color(color="#fff", background_color="blue")
+        blue_color = BalloonColor(color="#fff", background_color="blue")
         contest.append_balloon_color(blue_color)
-        
+
         assert len(contest.balloon_color) == 2
         assert contest.balloon_color[1] == blue_color
 
     def test_fill_problem_id(self):
         """Test fill_problem_id method"""
-        contest = Contest(problem_quantity=5)
-        
+        contest = Contest()
+
         # Initially empty
-        assert contest.problem_id == []
-        
+        assert contest.problem_id is None
+
         # Fill with A-E
-        contest.fill_problem_id()
-        
+        contest.fill_problem_id(5)
+
         assert len(contest.problem_id) == 5
         assert contest.problem_id == ["A", "B", "C", "D", "E"]
-        
+
         # Test with larger quantity
-        contest.problem_quantity = 10
-        contest.fill_problem_id()
-        
+        contest.fill_problem_id(10)
+
         assert len(contest.problem_id) == 10
         assert contest.problem_id == ["A", "B", "C", "D", "E", "F", "G", "H", "I", "J"]
 
     def test_fill_balloon_color(self):
         """Test fill_balloon_color method"""
-        contest = Contest(problem_quantity=3)
-        
+        contest = Contest()
+
         # Initially no colors
         assert contest.balloon_color is None
-        
-        # Fill with default colors
+
+        # Fill problem IDs first, then balloon colors
+        contest.fill_problem_id(3)
         contest.fill_balloon_color()
-        
+
         assert contest.balloon_color is not None
         assert len(contest.balloon_color) == 3
-        assert all(isinstance(color, Color) for color in contest.balloon_color)
-        
+        assert all(isinstance(color, BalloonColor) for color in contest.balloon_color)
+
         # Check first few default colors
         assert contest.balloon_color[0].background_color == "rgba(189, 14, 14, 0.7)"
         assert contest.balloon_color[0].color == "#fff"
@@ -183,22 +175,21 @@ class TestContest:
             contest_name="Complex Contest",
             start_time=1234567890,
             end_time=1234567890 + 5 * 60 * 60,
-            problem_quantity=3,
             organization="Complex Org",
-            medal="ccpc"  # Use preset instead of dict
+            medal="ccpc",  # Use preset instead of dict
         )
-        
+
         # Add problem IDs and colors
-        contest.fill_problem_id()
+        contest.fill_problem_id(3)
         contest.fill_balloon_color()
-        
+
         # Add logo
         contest.logo = Image(url="https://example.com/logo.png")
-        
+
         # Test serialization
         contest_json = contest.model_dump_json()
         reconstructed_contest = Contest.model_validate_json(contest_json)
-        
+
         # Verify all data is preserved
         assert reconstructed_contest.contest_name == contest.contest_name
         assert reconstructed_contest.start_time == contest.start_time
@@ -212,18 +203,15 @@ class TestContest:
         """Test contest with custom group and status display"""
         custom_group = {"team_a": "Team A", "team_b": "Team B"}
         custom_status = {"show_penalty": True, "show_time": False}
-        
-        contest = Contest(
-            group=custom_group,
-            status_time_display=custom_status
-        )
-        
+
+        contest = Contest(group=custom_group, status_time_display=custom_status)
+
         # Custom values should override defaults
         assert contest.group == custom_group
         assert contest.status_time_display == custom_status
-        
+
         # Test serialization preserves custom values
         contest_json = contest.model_dump_json()
         reconstructed = Contest.model_validate_json(contest_json)
         assert reconstructed.group == custom_group
-        assert reconstructed.status_time_display == custom_status
+        assert reconstructed.status_time_display == custom_status

{xcpcio-0.63.2 → xcpcio-0.76.8}/tests/test_submission.py

@@ -3,7 +3,7 @@ import json
 import pytest
 
 from xcpcio import constants
-from xcpcio.types import Reaction, Submission, Submissions
+from xcpcio.types import SubmissionReaction, Submission, Submissions
 
 
 class TestSubmission:
@@ -12,7 +12,7 @@ class TestSubmission:
     def test_submission_creation_defaults(self):
         """Test Submission creation with default values"""
         submission = Submission()
-        assert submission.id == ""
+        assert submission.id is None
         assert submission.team_id == ""
         assert submission.problem_id == 0
         assert submission.timestamp == 0
@@ -24,7 +24,7 @@ class TestSubmission:
 
     def test_submission_creation_with_values(self):
         """Test Submission creation with provided values"""
-        reaction = Reaction(url="https://reaction.com/video.mp4")
+        reaction = SubmissionReaction(url="https://reaction.com/video.mp4")
         submission = Submission(
             id="sub_001",
             status=constants.SUBMISSION_STATUS_ACCEPTED,
@@ -79,7 +79,7 @@ class TestSubmission:
 
     def test_submission_with_reaction_serialization(self):
         """Test Submission with Reaction serialization"""
-        reaction = Reaction(url="https://example.com/reaction.mp4")
+        reaction = SubmissionReaction(url="https://example.com/reaction.mp4")
         submission = Submission(
             id="sub_003",
             status=constants.SUBMISSION_STATUS_ACCEPTED,
@@ -125,7 +125,7 @@ class TestSubmissions:
                     timestamp=1234567891,
                     time=300,
                     language="C++",
-                    reaction=Reaction(url="https://reaction.com/video.mp4"),
+                    reaction=SubmissionReaction(url="https://reaction.com/video.mp4"),
                 ),
                 Submission(
                     id="sub_003",
@@ -214,7 +214,7 @@ class TestSubmissions:
                     problem_id=1,
                     timestamp=123,
                 ),
-                Submission(),  # All defaults
+                Submission(id="sub_default"),  # All other defaults
             ]
         )