xcpcio 0.63.6__py3-none-any.whl → 0.64.0__py3-none-any.whl

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.63.6'
+__version__ = VERSION = '0.64.0'

xcpcio/ccs/api_server/dependencies.py

@@ -5,13 +5,15 @@ Dependency injection system for Contest API Server.
 """
 
 from pathlib import Path
-from typing import Annotated
+from typing import Annotated, Dict
 
 from fastapi import Depends
 
+from xcpcio.ccs.reader.base_ccs_reader import BaseCCSReader
+from xcpcio.ccs.reader.contest_package_reader import ContestPackageReader
+
 from .services.contest_service import ContestService
 
-# Global contest service instance cache
 _contest_service_instance = None
 
 
@@ -41,7 +43,10 @@ def configure_dependencies(contest_package_dir: Path) -> None:
         contest_package_dir: Path to contest package directory
     """
     global _contest_service_instance
-    _contest_service_instance = ContestService(contest_package_dir)
+    reader_dict: Dict[str, BaseCCSReader] = {}
+    contest_package_reader = ContestPackageReader(contest_package_dir)
+    reader_dict[contest_package_reader.get_contest_id()] = contest_package_reader
+    _contest_service_instance = ContestService(reader_dict)
 
 
 # Type alias for dependency injection

xcpcio/ccs/api_server/routes/__init__.py

@@ -8,6 +8,7 @@ from fastapi import APIRouter
 
 from . import (
     access,
+    accounts,
     awards,
     clarifications,
     contests,
@@ -30,6 +31,7 @@ def create_router() -> APIRouter:
 
     # Include all route modules
     router.include_router(access.router, tags=["Access"])
+    router.include_router(accounts.router, tags=["Accounts"])
     router.include_router(awards.router, tags=["Awards"])
     router.include_router(clarifications.router, tags=["Clarifications"])
     router.include_router(contests.router, tags=["Contests"])

xcpcio/ccs/api_server/routes/access.py

@@ -11,10 +11,8 @@ logger = logging.getLogger(__name__)
 
 @router.get(
     "/contests/{contest_id}/access",
-    summary="Get Access Information",
-    description="Get access capabilities and visible endpoints for current client",
+    summary="Get access information",
     response_model=Dict[str, Any],
 )
 async def get_access(contest_id: str, service: ContestServiceDep) -> Dict[str, Any]:
-    """Get access information for the current client"""
-    return service.get_access_info(contest_id)
+    return service.get_access(contest_id)

xcpcio/ccs/api_server/routes/accounts.py

@@ -0,0 +1,35 @@
+import logging
+from typing import Any, Dict, List
+
+from fastapi import APIRouter
+from fastapi import Path as FastAPIPath
+
+from ..dependencies import ContestServiceDep
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+@router.get(
+    "/contests/{contest_id}/accounts",
+    summary="Get all the accounts",
+    response_model=List[Dict[str, Any]],
+)
+async def get_accounts(
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    service: ContestServiceDep = None,
+) -> List[Dict[str, Any]]:
+    return service.get_accounts(contest_id)
+
+
+@router.get(
+    "/contests/{contest_id}/accounts/{account_id}",
+    summary="Get the given account",
+    response_model=Dict[str, Any],
+)
+async def get_account(
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    account_id: str = FastAPIPath(..., description="Account identifier"),
+    service: ContestServiceDep = None,
+) -> Dict[str, Any]:
+    return service.get_account(contest_id, account_id)

xcpcio/ccs/api_server/routes/awards.py

@@ -3,7 +3,6 @@ from typing import Any, Dict, List
 
 from fastapi import APIRouter, Path
 
-from ...model import Award, Awards
 from ..dependencies import ContestServiceDep
 
 router = APIRouter()
@@ -12,27 +11,23 @@ logger = logging.getLogger(__name__)
 
 @router.get(
     "/contests/{contest_id}/awards",
-    summary="Get Awards",
-    description="Get all awards in the contest",
-    response_model=Awards,
+    summary="Get all the awards standings for this contest",
+    response_model=List[Dict[str, Any]],
 )
 async def get_awards(
     contest_id: str = Path(..., description="Contest identifier"), service: ContestServiceDep = None
 ) -> List[Dict[str, Any]]:
-    """Get all awards"""
     return service.get_awards(contest_id)
 
 
 @router.get(
     "/contests/{contest_id}/awards/{award_id}",
-    summary="Get Award",
-    description="Get specific award information",
-    response_model=Award,
+    summary="Get the specific award for this contest",
+    response_model=Dict[str, Any],
 )
 async def get_award(
     contest_id: str = Path(..., description="Contest identifier"),
     award_id: str = Path(..., description="Award identifier"),
     service: ContestServiceDep = None,
 ) -> Dict[str, Any]:
-    """Get specific award information"""
     return service.get_award(contest_id, award_id)

xcpcio/ccs/api_server/routes/clarifications.py

@@ -1,9 +1,8 @@
 import logging
-from typing import Any, Dict, List, Optional
+from typing import Any, Dict, List
 
-from fastapi import APIRouter, Path, Query
+from fastapi import APIRouter, Path
 
-from ...model import Clarification, Clarifications
 from ..dependencies import ContestServiceDep
 
 router = APIRouter()
@@ -12,31 +11,24 @@ logger = logging.getLogger(__name__)
 
 @router.get(
     "/contests/{contest_id}/clarifications",
-    summary="Get Clarifications",
-    description="Get all clarifications, optionally filtered",
-    response_model=Clarifications,
+    summary="Get all the clarifications for this contest",
+    response_model=List[Dict[str, Any]],
 )
 async def get_clarifications(
     contest_id: str = Path(..., description="Contest identifier"),
-    from_team_id: Optional[str] = Query(None, description="Filter by sender team ID (empty string for null)"),
-    to_team_id: Optional[str] = Query(None, description="Filter by recipient team ID (empty string for null)"),
-    problem_id: Optional[str] = Query(None, description="Filter by problem ID (empty string for null)"),
     service: ContestServiceDep = None,
 ) -> List[Dict[str, Any]]:
-    """Get all clarifications, optionally filtered"""
-    return service.get_clarifications(contest_id, from_team_id, to_team_id, problem_id)
+    return service.get_clarifications(contest_id)
 
 
 @router.get(
     "/contests/{contest_id}/clarifications/{clarification_id}",
-    summary="Get Clarification",
-    description="Get specific clarification information",
-    response_model=Clarification,
+    summary="Get the given clarifications for this contest",
+    response_model=Dict[str, Any],
 )
 async def get_clarification(
     contest_id: str = Path(..., description="Contest identifier"),
     clarification_id: str = Path(..., description="Clarification identifier"),
     service: ContestServiceDep = None,
 ) -> Dict[str, Any]:
-    """Get specific clarification information"""
     return service.get_clarification(contest_id, clarification_id)

xcpcio/ccs/api_server/routes/contests.py

@@ -1,74 +1,90 @@
+import json
 import logging
-from pathlib import Path
-from typing import Any, Dict, List
+from typing import Any, Dict, List, Optional
 
-from fastapi import APIRouter, HTTPException
+from fastapi import APIRouter, Query
 from fastapi import Path as FastAPIPath
-from fastapi.responses import FileResponse
+from fastapi.responses import FileResponse, StreamingResponse
 
-from ...model import Contest, State
 from ..dependencies import ContestServiceDep
 
 router = APIRouter()
 logger = logging.getLogger(__name__)
 
 
-@router.get("/contests", summary="Get Contests", description="Get list of all contests", response_model=List[Contest])
+@router.get(
+    "/contests",
+    summary="Get all the contests",
+    response_model=List[Dict[str, Any]],
+)
 async def get_contests(service: ContestServiceDep) -> List[Dict[str, Any]]:
-    """Get all contests"""
     return service.get_contests()
 
 
 @router.get(
     "/contests/{contest_id}",
-    summary="Get Contest",
-    description="Get specific contest information",
-    response_model=Contest,
+    summary="Get the given contest",
+    response_model=Dict[str, Any],
 )
 async def get_contest(
-    contest_id: str = FastAPIPath(..., description="Contest identifier"), service: ContestServiceDep = None
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    service: ContestServiceDep = None,
 ) -> Dict[str, Any]:
-    """Get specific contest information"""
     return service.get_contest(contest_id)
 
 
 @router.get(
     "/contests/{contest_id}/state",
-    summary="Get Contest State",
-    description="Get current contest state (started, ended, frozen, etc.)",
-    response_model=State,
+    summary="Get the current contest state",
+    response_model=Dict[str, Any],
 )
 async def get_state(
-    contest_id: str = FastAPIPath(..., description="Contest identifier"), service: ContestServiceDep = None
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    service: ContestServiceDep = None,
 ) -> Dict[str, Any]:
-    """Get contest state"""
     return service.get_contest_state(contest_id)
 
 
 @router.get(
-    "/contests/{contest_id}/contest/banner",
-    summary="Get Contest Banner",
-    description="Get banner image for the contest",
+    "/contests/{contest_id}/banner",
+    summary="Get the banner for the given contest",
     response_class=FileResponse,
 )
 async def get_contest_banner(
-    contest_id: str = FastAPIPath(..., description="Contest identifier"), service: ContestServiceDep = None
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    service: ContestServiceDep = None,
 ) -> FileResponse:
-    """Get contest banner file"""
-    service.validate_contest_id(contest_id)
-
-    # Expected href pattern for this endpoint
-    expected_href = f"contests/{contest_id}/contest/banner"
-
-    try:
-        banners = service.contest_data.get("banner", [])
-        for banner in banners:
-            href = banner["href"]
-            if href == expected_href:
-                filename = banner["filename"]
-                banner_file: Path = service.contest_package_dir / "contest" / filename
-                if banner_file.exists():
-                    mime_type = banner["mime"]
-                    return FileResponse(path=banner_file, media_type=mime_type, filename=filename)
-    except Exception as e:
-        raise HTTPException(status_code=404, detail=f"Banner not found. [contest_id={contest_id}] [err={e}]")
+    file_attr = service.get_contest_banner(contest_id)
+    return FileResponse(path=file_attr.path, media_type=file_attr.media_type, filename=file_attr.name)
+
+
+@router.get(
+    "/contests/{contest_id}/problemset",
+    summary="Get the problemset document for the given contest",
+    response_class=FileResponse,
+)
+async def get_contest_problem_set(
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    service: ContestServiceDep = None,
+) -> FileResponse:
+    file_attr = service.get_contest_problemset(contest_id)
+    return FileResponse(path=file_attr.path, media_type=file_attr.media_type, filename=file_attr.name)
+
+
+@router.get(
+    "/contests/{contest_id}/event-feed",
+    summary="Get event feed for contest",
+    description="Get events for the contest in NDJSON format. Each line contains a single event object.",
+)
+async def get_event_feed(
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    stream: bool = Query(False, description="Whether to stream the output or stop immediately"),
+    since_token: Optional[str] = Query(None, description="Return events after this token"),
+    service: ContestServiceDep = None,
+) -> StreamingResponse:
+    async def generate():
+        events = service.get_event_feed(contest_id, since_token)
+        for event in events:
+            yield json.dumps(event, ensure_ascii=False, separators=(",", ":")) + "\n"
+
+    return StreamingResponse(generate(), media_type="application/x-ndjson")

xcpcio/ccs/api_server/routes/general.py

@@ -13,17 +13,18 @@ logger = logging.getLogger(__name__)
 @router.get(
     "/",
     summary="API Information",
-    description="Get API version and provider information",
     response_model=Dict[str, Any],
 )
 async def get_api_info(service: ContestServiceDep) -> Dict[str, Any]:
-    """Get API information and provider details"""
     return service.get_api_info()
 
 
-@router.get("/health", summary="Health Check", description="Check server health status", response_model=Dict[str, Any])
+@router.get(
+    "/health",
+    summary="Health Check",
+    response_model=Dict[str, Any],
+)
 async def health_check(service: ContestServiceDep) -> Dict[str, Any]:
-    """Health check endpoint"""
     return {
         "status": "healthy",
         "timestamp": datetime.now().isoformat(),

xcpcio/ccs/api_server/routes/groups.py

@@ -3,10 +3,6 @@ from typing import Any, Dict, List
 
 from fastapi import APIRouter, Path
 
-from ...model import (
-    Group,
-    Groups,
-)
 from ..dependencies import ContestServiceDep
 
 router = APIRouter()
@@ -15,27 +11,24 @@ logger = logging.getLogger(__name__)
 
 @router.get(
     "/contests/{contest_id}/groups",
-    summary="Get Groups",
-    description="Get all team groups in the contest",
-    response_model=Groups,
+    summary="Get all the groups for this contest",
+    response_model=List[Dict[str, Any]],
 )
 async def get_groups(
-    contest_id: str = Path(..., description="Contest identifier"), service: ContestServiceDep = None
+    contest_id: str = Path(..., description="Contest identifier"),
+    service: ContestServiceDep = None,
 ) -> List[Dict[str, Any]]:
-    """Get all groups"""
     return service.get_groups(contest_id)
 
 
 @router.get(
     "/contests/{contest_id}/groups/{group_id}",
-    summary="Get Group",
-    description="Get specific group information",
-    response_model=Group,
+    summary="Get the given group for this contest",
+    response_model=Dict[str, Any],
 )
 async def get_group(
     contest_id: str = Path(..., description="Contest identifier"),
     group_id: str = Path(..., description="Group identifier"),
     service: ContestServiceDep = None,
 ) -> Dict[str, Any]:
-    """Get specific group information"""
     return service.get_group(contest_id, group_id)

xcpcio/ccs/api_server/routes/judgement_types.py

@@ -3,10 +3,6 @@ from typing import Any, Dict, List
 
 from fastapi import APIRouter, Path
 
-from ...model import (
-    JudgementType,
-    JudgementTypes,
-)
 from ..dependencies import ContestServiceDep
 
 router = APIRouter()
@@ -15,27 +11,24 @@ logger = logging.getLogger(__name__)
 
 @router.get(
     "/contests/{contest_id}/judgement-types",
-    summary="Get Judgement Types",
-    description="Get all judgement types available in the contest",
-    response_model=JudgementTypes,
+    summary="Get all the judgement types for this contest",
+    response_model=List[Dict[str, Any]],
 )
 async def get_judgement_types(
-    contest_id: str = Path(..., description="Contest identifier"), service: ContestServiceDep = None
+    contest_id: str = Path(..., description="Contest identifier"),
+    service: ContestServiceDep = None,
 ) -> List[Dict[str, Any]]:
-    """Get all judgement types"""
     return service.get_judgement_types(contest_id)
 
 
 @router.get(
     "/contests/{contest_id}/judgement-types/{judgement_type_id}",
-    summary="Get Judgement Type",
-    description="Get specific judgement type information",
-    response_model=JudgementType,
+    summary="Get the given judgement type for this contest",
+    response_model=Dict[str, Any],
 )
 async def get_judgement_type(
     contest_id: str = Path(..., description="Contest identifier"),
     judgement_type_id: str = Path(..., description="Judgement type identifier"),
     service: ContestServiceDep = None,
 ) -> Dict[str, Any]:
-    """Get specific judgement type information"""
     return service.get_judgement_type(contest_id, judgement_type_id)

xcpcio/ccs/api_server/routes/judgements.py

@@ -3,7 +3,6 @@ from typing import Any, Dict, List, Optional
 
 from fastapi import APIRouter, Path, Query
 
-from ...model import Judgement, Judgements
 from ..dependencies import ContestServiceDep
 
 router = APIRouter()
@@ -12,29 +11,25 @@ logger = logging.getLogger(__name__)
 
 @router.get(
     "/contests/{contest_id}/judgements",
-    summary="Get Judgements",
-    description="Get all judgements, optionally filtered by submission",
-    response_model=Judgements,
+    summary="Get all the judgements for this contest",
+    response_model=List[Dict[str, Any]],
 )
 async def get_judgements(
     contest_id: str = Path(..., description="Contest identifier"),
     submission_id: Optional[str] = Query(None, description="Filter judgements by submission ID"),
     service: ContestServiceDep = None,
 ) -> List[Dict[str, Any]]:
-    """Get all judgements, optionally filtered by submission"""
     return service.get_judgements(contest_id, submission_id)
 
 
 @router.get(
     "/contests/{contest_id}/judgements/{judgement_id}",
-    summary="Get Judgement",
-    description="Get specific judgement information",
-    response_model=Judgement,
+    summary="Get the given judgement for this contest",
+    response_model=Dict[str, Any],
 )
 async def get_judgement(
     contest_id: str = Path(..., description="Contest identifier"),
     judgement_id: str = Path(..., description="Judgement identifier"),
     service: ContestServiceDep = None,
 ) -> Dict[str, Any]:
-    """Get specific judgement information"""
     return service.get_judgement(contest_id, judgement_id)

xcpcio/ccs/api_server/routes/languages.py

@@ -3,10 +3,6 @@ from typing import Any, Dict, List
 
 from fastapi import APIRouter, Path
 
-from ...model import (
-    Language,
-    Languages,
-)
 from ..dependencies import ContestServiceDep
 
 router = APIRouter()
@@ -15,27 +11,24 @@ logger = logging.getLogger(__name__)
 
 @router.get(
     "/contests/{contest_id}/languages",
-    summary="Get Languages",
-    description="Get all programming languages available for submission",
-    response_model=Languages,
+    summary="Get all the languages for this contest",
+    response_model=List[Dict[str, Any]],
 )
 async def get_languages(
-    contest_id: str = Path(..., description="Contest identifier"), service: ContestServiceDep = None
+    contest_id: str = Path(..., description="Contest identifier"),
+    service: ContestServiceDep = None,
 ) -> List[Dict[str, Any]]:
-    """Get all programming languages"""
     return service.get_languages(contest_id)
 
 
 @router.get(
     "/contests/{contest_id}/languages/{language_id}",
-    summary="Get Language",
-    description="Get specific language information",
-    response_model=Language,
+    summary="Get the given language for this contest",
+    response_model=Dict[str, Any],
 )
 async def get_language(
     contest_id: str = Path(..., description="Contest identifier"),
     language_id: str = Path(..., description="Language identifier"),
     service: ContestServiceDep = None,
 ) -> Dict[str, Any]:
-    """Get specific language information"""
     return service.get_language(contest_id, language_id)

xcpcio/ccs/api_server/routes/organizations.py

@@ -1,15 +1,10 @@
 import logging
-from pathlib import Path
 from typing import Any, Dict, List
 
-from fastapi import APIRouter, HTTPException
+from fastapi import APIRouter
 from fastapi import Path as FastAPIPath
 from fastapi.responses import FileResponse
 
-from ...model import (
-    Organization,
-    Organizations,
-)
 from ..dependencies import ContestServiceDep
 
 router = APIRouter()
@@ -18,36 +13,32 @@ logger = logging.getLogger(__name__)
 
 @router.get(
     "/contests/{contest_id}/organizations",
-    summary="Get Organizations",
-    description="Get all organizations in the contest",
-    response_model=Organizations,
+    summary="Get all the organizations for this contest",
+    response_model=List[Dict[str, Any]],
 )
 async def get_organizations(
-    contest_id: str = FastAPIPath(..., description="Contest identifier"), service: ContestServiceDep = None
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    service: ContestServiceDep = None,
 ) -> List[Dict[str, Any]]:
-    """Get all organizations"""
     return service.get_organizations(contest_id)
 
 
 @router.get(
     "/contests/{contest_id}/organizations/{organization_id}",
-    summary="Get Organization",
-    description="Get specific organization information",
-    response_model=Organization,
+    summary="Get the given organization for this contest",
+    response_model=Dict[str, Any],
 )
 async def get_organization(
     contest_id: str = FastAPIPath(..., description="Contest identifier"),
     organization_id: str = FastAPIPath(..., description="Organization identifier"),
     service: ContestServiceDep = None,
 ) -> Dict[str, Any]:
-    """Get specific organization information"""
     return service.get_organization(contest_id, organization_id)
 
 
 @router.get(
     "/contests/{contest_id}/organizations/{organization_id}/logo",
     summary="Get Organization Logo",
-    description="Get logo file for a specific organization",
     response_class=FileResponse,
 )
 async def get_organization_logo(
@@ -55,28 +46,5 @@ async def get_organization_logo(
     organization_id: str = FastAPIPath(..., description="Organization identifier"),
     service: ContestServiceDep = None,
 ) -> FileResponse:
-    """Get organization logo file"""
-    service.validate_contest_id(contest_id)
-
-    # Get organization from indexed data
-    org = service.organizations_by_id.get(organization_id)
-    if not org:
-        raise HTTPException(status_code=404, detail=f"Organization {organization_id} not found")
-
-    # Expected href pattern for this endpoint
-    expected_href = f"contests/{contest_id}/organizations/{organization_id}/logo"
-
-    try:
-        logos = org["logo"]
-        for logo in logos:
-            href = logo["href"]
-            if href == expected_href:
-                filename = logo["filename"]
-                logo_file: Path = service.contest_package_dir / "organizations" / organization_id / filename
-                if logo_file.exists():
-                    mime_type = logo["mime"]
-                    return FileResponse(path=logo_file, media_type=mime_type, filename=filename)
-    except Exception as e:
-        raise HTTPException(
-            status_code=404, detail=f"Logo file not found. [organization_id={organization_id}] [err={e}]"
-        )
+    file_attr = service.get_organization_logo(contest_id, organization_id)
+    return FileResponse(path=file_attr.path, media_type=file_attr.media_type, filename=file_attr.name)