xcpcio 0.64.2__tar.gz → 0.82.0__tar.gz

{xcpcio-0.64.2 → xcpcio-0.82.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xcpcio
-Version: 0.64.2
+Version: 0.82.0
 Summary: xcpcio python lib
 Project-URL: homepage, https://github.com/xcpcio/xcpcio
 Project-URL: documentation, https://github.com/xcpcio/xcpcio
@@ -79,8 +79,10 @@ uv run pytest tests/test_types.py
 
 For detailed documentation, visit:
 
-- [CCS Utility Guide](https://xcpcio.com/guide/ccs-utility)
+- [Clics Utility Guide](https://xcpcio.com/guide/clics-utility)
 
 ## License
 
-MIT License © 2020-PRESENT [Dup4](https://github.com/Dup4)
+[MIT](../LICENSE) License © 2020 - PRESENT [XCPCIO][xcpcio]
+
+[xcpcio]: https://xcpcio.com

{xcpcio-0.64.2 → xcpcio-0.82.0}/README.md

@@ -49,8 +49,10 @@ uv run pytest tests/test_types.py
 
 For detailed documentation, visit:
 
-- [CCS Utility Guide](https://xcpcio.com/guide/ccs-utility)
+- [Clics Utility Guide](https://xcpcio.com/guide/clics-utility)
 
 ## License
 
-MIT License © 2020-PRESENT [Dup4](https://github.com/Dup4)
+[MIT](../LICENSE) License © 2020 - PRESENT [XCPCIO][xcpcio]
+
+[xcpcio]: https://xcpcio.com

{xcpcio-0.64.2 → xcpcio-0.82.0}/pyproject.toml

@@ -38,7 +38,9 @@ documentation = "https://github.com/xcpcio/xcpcio"
 repository = "https://github.com/xcpcio/xcpcio"
 
 [project.scripts]
-ccs-archiver = "cli.ccs_archiver_cli:main"
+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

{xcpcio-0.64.2 → xcpcio-0.82.0}/scripts/generate_ccs_models.sh

@@ -5,7 +5,7 @@ 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/ccs/model"
+CCS_MODELS_DIR="${PYTHON_DIR}/xcpcio/clics/model"
 
 BRANCH="${1:-2023-06}"
 CCS_REPO_URL="https://github.com/icpc/ccs-specs.git"

{xcpcio-0.64.2 → xcpcio-0.82.0}/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,38 +8,34 @@ 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.organization == "School"
+        assert contest.problem_id is None
         assert contest.medal is None
         assert contest.balloon_color is None
         assert contest.logo is None
         assert contest.banner is None
         assert contest.banner_mode is None
-        assert contest.badge is None
         assert contest.group is None
         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,
@@ -50,19 +44,16 @@ class TestContest:
             penalty=20 * 60,  # 20 minutes
             problem_quantity=12,
             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"
-        assert contest.organization == "ICPC"
         assert contest.medal == "icpc"
         assert contest.options == contest_options
 
@@ -72,18 +63,14 @@ 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"
         )
-        
+
         # 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 +79,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 +103,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 +169,20 @@ 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 +196,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.64.2 → xcpcio-0.82.0}/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
             ]
         )
 

{xcpcio-0.64.2 → xcpcio-0.82.0}/tests/test_team.py

@@ -13,9 +13,9 @@ class TestTeam:
         team = Team()
         assert team.id == ""
         assert team.name == ""
-        assert team.organization == ""
+        assert team.organization is None
         assert team.members is None
-        assert team.coach is None
+        assert team.coaches is None
         assert team.location is None
         assert team.group == []
         assert team.extra == {}
@@ -27,7 +27,7 @@ class TestTeam:
             name="Test Team",
             organization="Test University",
             members=["Alice", "Bob", "Charlie"],
-            coach="Dr. Smith",
+            coaches="Dr. Smith",
             location="Building A",
         )
 
@@ -35,7 +35,7 @@ class TestTeam:
         assert team.name == "Test Team"
         assert team.organization == "Test University"
         assert team.members == ["Alice", "Bob", "Charlie"]
-        assert team.coach == "Dr. Smith"
+        assert team.coaches == "Dr. Smith"
         assert team.location == "Building A"
 
     def test_group_management(self):
@@ -75,7 +75,7 @@ class TestTeamSerialization:
             name="Alpha Team",
             organization="University A",
             members=["Alice", "Bob", "Charlie"],
-            coach="Dr. Smith",
+            coaches="Dr. Smith",
             location="Building A",
             group=["undergraduate", "local"],
             extra={"room": "101", "contact": "alice@test.edu"},
@@ -90,17 +90,24 @@ class TestTeamSerialization:
         assert team_dict["name"] == "Alpha Team"
         assert team_dict["organization"] == "University A"
         assert team_dict["members"] == ["Alice", "Bob", "Charlie"]
-        assert team_dict["coach"] == "Dr. Smith"
+        assert team_dict["coaches"] == "Dr. Smith"
         assert team_dict["location"] == "Building A"
         assert team_dict["group"] == ["undergraduate", "local"]
-        assert team_dict["extra"] == {"room": "101", "contact": "alice@test.edu"}
+        assert "extra" not in team_dict  # extra field is excluded from serialization
 
     def test_model_validate(self, sample_team: Team):
         """Test Team model_validate method"""
         team_dict = sample_team.model_dump()
         reconstructed_team = Team.model_validate(team_dict)
 
-        assert reconstructed_team == sample_team
+        assert reconstructed_team.id == sample_team.id
+        assert reconstructed_team.name == sample_team.name
+        assert reconstructed_team.organization == sample_team.organization
+        assert reconstructed_team.members == sample_team.members
+        assert reconstructed_team.coaches == sample_team.coaches
+        assert reconstructed_team.location == sample_team.location
+        assert reconstructed_team.group == sample_team.group
+        assert reconstructed_team.extra == {}  # extra is not serialized
 
     def test_model_dump_json(self, sample_team: Team):
         """Test Team model_dump_json method"""
@@ -117,21 +124,42 @@ class TestTeamSerialization:
         team_json = sample_team.model_dump_json()
         reconstructed_team = Team.model_validate_json(team_json)
 
-        assert reconstructed_team == sample_team
+        assert reconstructed_team.id == sample_team.id
+        assert reconstructed_team.name == sample_team.name
+        assert reconstructed_team.organization == sample_team.organization
+        assert reconstructed_team.members == sample_team.members
+        assert reconstructed_team.coaches == sample_team.coaches
+        assert reconstructed_team.location == sample_team.location
+        assert reconstructed_team.group == sample_team.group
+        assert reconstructed_team.extra == {}  # extra is not serialized
 
     def test_round_trip_dict(self, sample_team: Team):
         """Test complete round-trip through dict serialization"""
         team_dict = sample_team.model_dump()
         reconstructed_team = Team.model_validate(team_dict)
 
-        assert reconstructed_team == sample_team
+        assert reconstructed_team.id == sample_team.id
+        assert reconstructed_team.name == sample_team.name
+        assert reconstructed_team.organization == sample_team.organization
+        assert reconstructed_team.members == sample_team.members
+        assert reconstructed_team.coaches == sample_team.coaches
+        assert reconstructed_team.location == sample_team.location
+        assert reconstructed_team.group == sample_team.group
+        assert reconstructed_team.extra == {}  # extra is excluded and won't round-trip
 
     def test_round_trip_json(self, sample_team: Team):
         """Test complete round-trip through JSON serialization"""
         team_json = sample_team.model_dump_json()
         reconstructed_team = Team.model_validate_json(team_json)
 
-        assert reconstructed_team == sample_team
+        assert reconstructed_team.id == sample_team.id
+        assert reconstructed_team.name == sample_team.name
+        assert reconstructed_team.organization == sample_team.organization
+        assert reconstructed_team.members == sample_team.members
+        assert reconstructed_team.coaches == sample_team.coaches
+        assert reconstructed_team.location == sample_team.location
+        assert reconstructed_team.group == sample_team.group
+        assert reconstructed_team.extra == {}  # extra is excluded and won't round-trip
 
     def test_minimal_team_serialization(self):
         """Test serialization of team with default/minimal values"""
@@ -161,7 +189,7 @@ class TestTeamList:
                     name="Alpha Team",
                     organization="University A",
                     members=["Alice", "Bob"],
-                    coach="Coach A",
+                    coaches="Coach A",
                 ),
                 Team(
                     id="team002",

{xcpcio-0.64.2 → xcpcio-0.82.0}/tests/test_types.py

@@ -1,5 +1,5 @@
 from xcpcio import constants
-from xcpcio.types import Color, ContestOptions, Image, Reaction
+from xcpcio.types import BalloonColor, ContestOptions, Image, SubmissionReaction
 
 
 class TestImage:
@@ -35,18 +35,18 @@ class TestImage:
         assert reconstructed_image == image
 
 
-class TestColor:
-    """Test cases for Color Pydantic model"""
+class TestBalloonColor:
+    """Test cases for BalloonColor Pydantic model"""
 
     def test_color_creation(self):
-        """Test Color creation"""
-        color = Color(color="#ffffff", background_color="#000000")
+        """Test BalloonColor creation"""
+        color = BalloonColor(color="#ffffff", background_color="#000000")
         assert color.color == "#ffffff"
         assert color.background_color == "#000000"
 
     def test_color_serialization(self):
-        """Test Color serialization and deserialization"""
-        color = Color(color="red", background_color="blue")
+        """Test BalloonColor serialization and deserialization"""
+        color = BalloonColor(color="red", background_color="blue")
 
         # Test model_dump
         color_dict = color.model_dump()
@@ -55,7 +55,7 @@ class TestColor:
 
         # Test JSON round-trip
         color_json = color.model_dump_json()
-        reconstructed_color = Color.model_validate_json(color_json)
+        reconstructed_color = BalloonColor.model_validate_json(color_json)
         assert reconstructed_color == color
 
 
@@ -96,22 +96,22 @@ class TestContestOptions:
         assert reconstructed_options == options
 
 
-class TestReaction:
-    """Test cases for Reaction Pydantic model"""
+class TestSubmissionReaction:
+    """Test cases for SubmissionReaction Pydantic model"""
 
     def test_reaction_empty(self):
-        """Test Reaction with default values"""
-        reaction = Reaction()
-        assert reaction.url is None
+        """Test SubmissionReaction with default values"""
+        reaction = SubmissionReaction(url="")
+        assert reaction.url == ""
 
     def test_reaction_with_url(self):
-        """Test Reaction with URL"""
-        reaction = Reaction(url="https://reaction.com/video.mp4")
+        """Test SubmissionReaction with URL"""
+        reaction = SubmissionReaction(url="https://reaction.com/video.mp4")
         assert reaction.url == "https://reaction.com/video.mp4"
 
     def test_reaction_serialization(self):
-        """Test Reaction serialization"""
-        reaction = Reaction(url="https://test.com/reaction.mp4")
+        """Test SubmissionReaction serialization"""
+        reaction = SubmissionReaction(url="https://test.com/reaction.mp4")
 
         # Test model_dump
         reaction_dict = reaction.model_dump()
@@ -119,17 +119,17 @@ class TestReaction:
 
         # Test JSON round-trip
         reaction_json = reaction.model_dump_json()
-        reconstructed_reaction = Reaction.model_validate_json(reaction_json)
+        reconstructed_reaction = SubmissionReaction.model_validate_json(reaction_json)
         assert reconstructed_reaction == reaction
 
     def test_reaction_no_url_serialization(self):
-        """Test Reaction serialization with no URL"""
-        reaction = Reaction()
+        """Test SubmissionReaction serialization with no URL"""
+        reaction = SubmissionReaction(url="")
 
         reaction_dict = reaction.model_dump()
-        assert reaction_dict["url"] is None
+        assert reaction_dict["url"] == ""
 
         # Test JSON round-trip
         reaction_json = reaction.model_dump_json()
-        reconstructed_reaction = Reaction.model_validate_json(reaction_json)
+        reconstructed_reaction = SubmissionReaction.model_validate_json(reaction_json)
         assert reconstructed_reaction == reaction

xcpcio-0.82.0/xcpcio/__init__.py

@@ -0,0 +1,4 @@
+from . import clics, constants, types
+from .__version__ import __version__
+
+__all__ = [constants, types, clics, __version__]

{xcpcio-0.64.2 → xcpcio-0.82.0}/xcpcio/__version__.py

@@ -1,4 +1,4 @@
 # This file is auto-generated by Hatchling. As such, do not:
 #   - modify
 #   - track in version control e.g. be sure to add to .gitignore
-__version__ = VERSION = '0.64.2'
+__version__ = VERSION = '0.82.0'

xcpcio-0.82.0/xcpcio/api/__init__.py

@@ -0,0 +1,17 @@
+from .client import ApiClient
+from .models import (
+    FileData,
+    HTTPValidationError,
+    UploadBoardDataReq,
+    UploadBoardDataResp,
+    ValidationError,
+)
+
+__all__ = [
+    ApiClient,
+    FileData,
+    HTTPValidationError,
+    UploadBoardDataReq,
+    UploadBoardDataResp,
+    ValidationError,
+]