xcpcio 0.63.5__py3-none-any.whl → 0.63.7__py3-none-any.whl

xcpcio/__version__.py

@@ -1 +1,4 @@
-__version__ = "0.63.5"
+# 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.7'

xcpcio/ccs/__init__.py

@@ -1,3 +1,3 @@
-from . import contest_archiver, model
+from . import api_server, contest_archiver, model
 
-__all__ = [model, contest_archiver]
+__all__ = [model, contest_archiver, api_server]

xcpcio/ccs/api_server/__init__.py

@@ -0,0 +1,9 @@
+"""
+Contest API Server Package
+
+Modern FastAPI-based implementation of the Contest API specification.
+"""
+
+from .server import ContestAPIServer
+
+__all__ = [ContestAPIServer]

xcpcio/ccs/api_server/dependencies.py

@@ -0,0 +1,48 @@
+"""
+FastAPI Dependencies
+
+Dependency injection system for Contest API Server.
+"""
+
+from pathlib import Path
+from typing import Annotated
+
+from fastapi import Depends
+
+from .services.contest_service import ContestService
+
+# Global contest service instance cache
+_contest_service_instance = None
+
+
+def get_contest_service() -> ContestService:
+    """
+    Dependency that provides ContestService instance.
+
+    This is configured by the main server class and cached globally.
+
+    Returns:
+        ContestService instance
+
+    Raises:
+        RuntimeError: If service not configured
+    """
+    global _contest_service_instance
+    if _contest_service_instance is None:
+        raise RuntimeError("ContestService not configured. Call configure_dependencies() first.")
+    return _contest_service_instance
+
+
+def configure_dependencies(contest_package_dir: Path) -> None:
+    """
+    Configure the dependency injection system.
+
+    Args:
+        contest_package_dir: Path to contest package directory
+    """
+    global _contest_service_instance
+    _contest_service_instance = ContestService(contest_package_dir)
+
+
+# Type alias for dependency injection
+ContestServiceDep = Annotated[ContestService, Depends(get_contest_service)]

xcpcio/ccs/api_server/routes/__init__.py

@@ -0,0 +1,52 @@
+"""
+Routes package for Contest API Server
+
+Contains all API route definitions organized by functionality.
+"""
+
+from fastapi import APIRouter
+
+from . import (
+    access,
+    accounts,
+    awards,
+    clarifications,
+    contests,
+    general,
+    groups,
+    judgement_types,
+    judgements,
+    languages,
+    organizations,
+    problems,
+    runs,
+    submissions,
+    teams,
+)
+
+
+def create_router() -> APIRouter:
+    """Create and configure the main API router"""
+    router = APIRouter(prefix="/api")
+
+    # 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"])
+    router.include_router(general.router, tags=["General"])
+    router.include_router(groups.router, tags=["Groups"])
+    router.include_router(judgements.router, tags=["Judgements"])
+    router.include_router(judgement_types.router, tags=["Judgement types"])
+    router.include_router(languages.router, tags=["Languages"])
+    router.include_router(organizations.router, tags=["Organizations"])
+    router.include_router(problems.router, tags=["Problems"])
+    router.include_router(runs.router, tags=["Runs"])
+    router.include_router(submissions.router, tags=["Submissions"])
+    router.include_router(teams.router, tags=["Teams"])
+
+    return router
+
+
+__all__ = ["create_router"]

xcpcio/ccs/api_server/routes/access.py

@@ -0,0 +1,18 @@
+import logging
+from typing import Any, Dict
+
+from fastapi import APIRouter
+
+from ..dependencies import ContestServiceDep
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+@router.get(
+    "/contests/{contest_id}/access",
+    summary="Get access information",
+    response_model=Dict[str, Any],
+)
+async def get_access(contest_id: str, service: ContestServiceDep) -> Dict[str, Any]:
+    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

@@ -0,0 +1,33 @@
+import logging
+from typing import Any, Dict, List
+
+from fastapi import APIRouter, Path
+
+from ..dependencies import ContestServiceDep
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+@router.get(
+    "/contests/{contest_id}/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]]:
+    return service.get_awards(contest_id)
+
+
+@router.get(
+    "/contests/{contest_id}/awards/{award_id}",
+    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]:
+    return service.get_award(contest_id, award_id)

xcpcio/ccs/api_server/routes/clarifications.py

@@ -0,0 +1,34 @@
+import logging
+from typing import Any, Dict, List
+
+from fastapi import APIRouter, Path
+
+from ..dependencies import ContestServiceDep
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+@router.get(
+    "/contests/{contest_id}/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"),
+    service: ContestServiceDep = None,
+) -> List[Dict[str, Any]]:
+    return service.get_clarifications(contest_id)
+
+
+@router.get(
+    "/contests/{contest_id}/clarifications/{clarification_id}",
+    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]:
+    return service.get_clarification(contest_id, clarification_id)

xcpcio/ccs/api_server/routes/contests.py

@@ -0,0 +1,119 @@
+import json
+import logging
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+from fastapi import APIRouter, HTTPException, Query
+from fastapi import Path as FastAPIPath
+from fastapi.responses import FileResponse, StreamingResponse
+
+from ..dependencies import ContestServiceDep
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+@router.get(
+    "/contests",
+    summary="Get all the contests",
+    response_model=List[Dict[str, Any]],
+)
+async def get_contests(service: ContestServiceDep) -> List[Dict[str, Any]]:
+    return service.get_contests()
+
+
+@router.get(
+    "/contests/{contest_id}",
+    summary="Get the given contest",
+    response_model=Dict[str, Any],
+)
+async def get_contest(
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    service: ContestServiceDep = None,
+) -> Dict[str, Any]:
+    return service.get_contest(contest_id)
+
+
+@router.get(
+    "/contests/{contest_id}/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,
+) -> Dict[str, Any]:
+    return service.get_contest_state(contest_id)
+
+
+@router.get(
+    "/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,
+) -> FileResponse:
+    service.validate_contest_id(contest_id)
+
+    expected_href = f"contests/{contest_id}/banner"
+
+    try:
+        banners = service.contest.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}]")
+
+
+@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:
+    service.validate_contest_id(contest_id)
+
+    expected_href = f"contests/{contest_id}/problemset"
+
+    try:
+        problem_set_list = service.contest.get("problemset", [])
+        for problem_set in problem_set_list:
+            href = problem_set["href"]
+            if href == expected_href:
+                filename = problem_set["filename"]
+                problem_set_file: Path = service.contest_package_dir / "contest" / filename
+                if problem_set_file.exists():
+                    mime_type = problem_set["mime"]
+                    return FileResponse(path=problem_set_file, media_type=mime_type, filename=filename)
+    except Exception as e:
+        raise HTTPException(status_code=404, detail=f"Problem set not found. [contest_id={contest_id}] [err={e}]")
+
+
+@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

@@ -0,0 +1,33 @@
+import logging
+from datetime import datetime
+from typing import Any, Dict
+
+from fastapi import APIRouter
+
+from ..dependencies import ContestServiceDep
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+@router.get(
+    "/",
+    summary="API Information",
+    response_model=Dict[str, Any],
+)
+async def get_api_info(service: ContestServiceDep) -> Dict[str, Any]:
+    return service.get_api_info()
+
+
+@router.get(
+    "/health",
+    summary="Health Check",
+    response_model=Dict[str, Any],
+)
+async def health_check(service: ContestServiceDep) -> Dict[str, Any]:
+    return {
+        "status": "healthy",
+        "timestamp": datetime.now().isoformat(),
+        "contest_package": str(service.contest_package_dir),
+        "api_version": "2023-06",
+    }

xcpcio/ccs/api_server/routes/groups.py

@@ -0,0 +1,34 @@
+import logging
+from typing import Any, Dict, List
+
+from fastapi import APIRouter, Path
+
+from ..dependencies import ContestServiceDep
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+@router.get(
+    "/contests/{contest_id}/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,
+) -> List[Dict[str, Any]]:
+    return service.get_groups(contest_id)
+
+
+@router.get(
+    "/contests/{contest_id}/groups/{group_id}",
+    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]:
+    return service.get_group(contest_id, group_id)

xcpcio/ccs/api_server/routes/judgement_types.py

@@ -0,0 +1,34 @@
+import logging
+from typing import Any, Dict, List
+
+from fastapi import APIRouter, Path
+
+from ..dependencies import ContestServiceDep
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+@router.get(
+    "/contests/{contest_id}/judgement-types",
+    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,
+) -> List[Dict[str, Any]]:
+    return service.get_judgement_types(contest_id)
+
+
+@router.get(
+    "/contests/{contest_id}/judgement-types/{judgement_type_id}",
+    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]:
+    return service.get_judgement_type(contest_id, judgement_type_id)

xcpcio/ccs/api_server/routes/judgements.py

@@ -0,0 +1,35 @@
+import logging
+from typing import Any, Dict, List, Optional
+
+from fastapi import APIRouter, Path, Query
+
+from ..dependencies import ContestServiceDep
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+@router.get(
+    "/contests/{contest_id}/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]]:
+    return service.get_judgements(contest_id, submission_id)
+
+
+@router.get(
+    "/contests/{contest_id}/judgements/{judgement_id}",
+    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]:
+    return service.get_judgement(contest_id, judgement_id)

xcpcio/ccs/api_server/routes/languages.py

@@ -0,0 +1,34 @@
+import logging
+from typing import Any, Dict, List
+
+from fastapi import APIRouter, Path
+
+from ..dependencies import ContestServiceDep
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+@router.get(
+    "/contests/{contest_id}/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,
+) -> List[Dict[str, Any]]:
+    return service.get_languages(contest_id)
+
+
+@router.get(
+    "/contests/{contest_id}/languages/{language_id}",
+    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]:
+    return service.get_language(contest_id, language_id)

xcpcio/ccs/api_server/routes/organizations.py

@@ -0,0 +1,71 @@
+import logging
+from pathlib import Path
+from typing import Any, Dict, List
+
+from fastapi import APIRouter, HTTPException
+from fastapi import Path as FastAPIPath
+from fastapi.responses import FileResponse
+
+from ..dependencies import ContestServiceDep
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+@router.get(
+    "/contests/{contest_id}/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,
+) -> List[Dict[str, Any]]:
+    return service.get_organizations(contest_id)
+
+
+@router.get(
+    "/contests/{contest_id}/organizations/{organization_id}",
+    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]:
+    return service.get_organization(contest_id, organization_id)
+
+
+@router.get(
+    "/contests/{contest_id}/organizations/{organization_id}/logo",
+    summary="Get Organization Logo",
+    response_class=FileResponse,
+)
+async def get_organization_logo(
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    organization_id: str = FastAPIPath(..., description="Organization identifier"),
+    service: ContestServiceDep = None,
+) -> FileResponse:
+    service.validate_contest_id(contest_id)
+
+    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 = 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}]"
+        )

xcpcio/ccs/api_server/routes/problems.py

@@ -0,0 +1,69 @@
+import logging
+from pathlib import Path
+from typing import Any, Dict, List
+
+from fastapi import APIRouter, HTTPException
+from fastapi import Path as FastAPIPath
+from fastapi.responses import FileResponse
+
+from ..dependencies import ContestServiceDep
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+@router.get(
+    "/contests/{contest_id}/problems",
+    summary="Get all the problems for this contest",
+    response_model=List[Dict[str, Any]],
+)
+async def get_problems(
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    service: ContestServiceDep = None,
+) -> List[Dict[str, Any]]:
+    return service.get_problems(contest_id)
+
+
+@router.get(
+    "/contests/{contest_id}/problems/{problem_id}",
+    summary="Get the given problem for this contest",
+    response_model=Dict[str, Any],
+)
+async def get_problem(
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    problem_id: str = FastAPIPath(..., description="Problem identifier"),
+    service: ContestServiceDep = None,
+) -> Dict[str, Any]:
+    return service.get_problem(contest_id, problem_id)
+
+
+@router.get(
+    "/contests/{contest_id}/problems/{problem_id}/statement",
+    summary="Get Problem Statement",
+    response_class=FileResponse,
+)
+async def get_problem_statement(
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    problem_id: str = FastAPIPath(..., description="Problem identifier"),
+    service: ContestServiceDep = None,
+) -> FileResponse:
+    service.validate_contest_id(contest_id)
+
+    problem: Dict = service.problems_by_id.get(problem_id)
+    if not problem:
+        raise HTTPException(status_code=404, detail=f"Problem {problem_id} not found")
+
+    expected_href = f"contests/{contest_id}/problems/{problem_id}/statement"
+
+    try:
+        statements = problem.get("statement", [])
+        for statement in statements:
+            href = statement["href"]
+            filename = statement["filename"]
+            if href == expected_href and filename:
+                statement_file: Path = service.contest_package_dir / "problems" / problem_id / filename
+                if statement_file.exists():
+                    mime_type = statement["mime"]
+                    return FileResponse(path=statement_file, media_type=mime_type, filename=filename)
+    except Exception as e:
+        raise HTTPException(status_code=404, detail=f"Statement not found. [problem_id={problem_id}] [err={e}]")