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

xcpcio/ccs/api_server/routes/runs.py

@@ -0,0 +1,40 @@
+import logging
+from typing import Any, Dict, List, Optional
+
+from fastapi import APIRouter, Path, Query
+
+from ...model import Run, Runs
+from ..dependencies import ContestServiceDep
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+@router.get(
+    "/contests/{contest_id}/runs",
+    summary="Get Runs",
+    description="Get all test case runs, optionally filtered by judgement",
+    response_model=Runs,
+)
+async def get_runs(
+    contest_id: str = Path(..., description="Contest identifier"),
+    judgement_id: Optional[str] = Query(None, description="Filter runs by judgement ID"),
+    service: ContestServiceDep = None,
+) -> List[Dict[str, Any]]:
+    """Get all test case runs, optionally filtered by judgement"""
+    return service.get_runs(contest_id, judgement_id)
+
+
+@router.get(
+    "/contests/{contest_id}/runs/{run_id}",
+    summary="Get Run",
+    description="Get specific test case run information",
+    response_model=Run,
+)
+async def get_run(
+    contest_id: str = Path(..., description="Contest identifier"),
+    run_id: str = Path(..., description="Run identifier"),
+    service: ContestServiceDep = None,
+) -> Dict[str, Any]:
+    """Get specific test case run information"""
+    return service.get_run(contest_id, run_id)

xcpcio/ccs/api_server/routes/submissions.py

@@ -0,0 +1,82 @@
+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
+
+from ...model import Submission, Submissions
+from ..dependencies import ContestServiceDep
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+@router.get(
+    "/contests/{contest_id}/submissions",
+    summary="Get Submissions",
+    description="Get all submissions, optionally filtered by team or problem",
+    response_model=Submissions,
+)
+async def get_submissions(
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    team_id: Optional[str] = Query(None, description="Filter submissions by team ID"),
+    problem_id: Optional[str] = Query(None, description="Filter submissions by problem ID"),
+    service: ContestServiceDep = None,
+) -> List[Dict[str, Any]]:
+    """Get all submissions, optionally filtered by team or problem"""
+    return service.get_submissions(contest_id, team_id, problem_id)
+
+
+@router.get(
+    "/contests/{contest_id}/submissions/{submission_id}",
+    summary="Get Submission",
+    description="Get specific submission information",
+    response_model=Submission,
+)
+async def get_submission(
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    submission_id: str = FastAPIPath(..., description="Submission identifier"),
+    service: ContestServiceDep = None,
+) -> Dict[str, Any]:
+    """Get specific submission information"""
+    return service.get_submission(contest_id, submission_id)
+
+
+@router.get(
+    "/contests/{contest_id}/submissions/{submission_id}/files",
+    summary="Get Submission Files",
+    description="Get files for a specific submission",
+    response_class=FileResponse,
+)
+async def get_submission_files(
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    submission_id: str = FastAPIPath(..., description="Submission identifier"),
+    service: ContestServiceDep = None,
+) -> FileResponse:
+    """Get submission files"""
+    service.validate_contest_id(contest_id)
+
+    # Get submission from indexed data
+    submission = service.submissions_by_id.get(submission_id)
+    if not submission:
+        raise HTTPException(status_code=404, detail=f"Submission {submission_id} not found")
+
+    # Expected href pattern for this endpoint
+    expected_href = f"contests/{contest_id}/submissions/{submission_id}/files"
+
+    try:
+        files: List[Dict] = submission["files"]
+        for file_info in files:
+            href = file_info["href"]
+            if href == expected_href:
+                filename = file_info["filename"]
+                submission_file: Path = service.contest_package_dir / "submissions" / submission_id / filename
+                if submission_file.exists():
+                    mime_type = file_info["mime"]
+                    return FileResponse(path=submission_file, media_type=mime_type, filename=filename)
+    except Exception as e:
+        raise HTTPException(
+            status_code=404, detail=f"Submission files not found. [submission_id={submission_id}] [err={e}]"
+        )

xcpcio/ccs/api_server/routes/teams.py

@@ -0,0 +1,82 @@
+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
+
+from ...model import (
+    Team,
+    Teams,
+)
+from ..dependencies import ContestServiceDep
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+@router.get(
+    "/contests/{contest_id}/teams",
+    summary="Get Teams",
+    description="Get all teams, optionally filtered by group",
+    response_model=Teams,
+)
+async def get_teams(
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    group_id: Optional[str] = Query(None, description="Filter teams by group ID"),
+    service: ContestServiceDep = None,
+) -> List[Dict[str, Any]]:
+    """Get all teams, optionally filtered by group"""
+    return service.get_teams(contest_id, group_id)
+
+
+@router.get(
+    "/contests/{contest_id}/teams/{team_id}",
+    summary="Get Team",
+    description="Get specific team information",
+    response_model=Team,
+)
+async def get_team(
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    team_id: str = FastAPIPath(..., description="Team identifier"),
+    service: ContestServiceDep = None,
+) -> Dict[str, Any]:
+    """Get specific team information"""
+    return service.get_team(contest_id, team_id)
+
+
+@router.get(
+    "/contests/{contest_id}/teams/{team_id}/photo",
+    summary="Get Team Photo",
+    description="Get photo file for a specific team",
+    response_class=FileResponse,
+)
+async def get_team_photo(
+    contest_id: str = FastAPIPath(..., description="Contest identifier"),
+    team_id: str = FastAPIPath(..., description="Team identifier"),
+    service: ContestServiceDep = None,
+) -> FileResponse:
+    """Get team photo file"""
+    service.validate_contest_id(contest_id)
+
+    # Get team from indexed data
+    team = service.teams_by_id.get(team_id)
+    if not team:
+        raise HTTPException(status_code=404, detail=f"Team {team_id} not found")
+
+    # Expected href pattern for this endpoint
+    expected_href = f"contests/{contest_id}/teams/{team_id}/photo"
+
+    try:
+        photos = team["photo"]
+        for photo in photos:
+            href = photo["href"]
+            if href == expected_href:
+                filename = ["filename"]
+                photo_file: Path = service.contest_package_dir / "teams" / team_id / filename
+                if photo_file.exists():
+                    mime_type = photo["mime"]
+                    return FileResponse(path=photo_file, media_type=mime_type, filename=filename)
+    except Exception as e:
+        raise HTTPException(status_code=404, detail=f"Photo not found. [team_id={team_id}] [err={e}]")

xcpcio/ccs/api_server/server.py

@@ -0,0 +1,83 @@
+"""
+Contest API Server
+
+Main server class implementing the Contest API specification using modern FastAPI architecture.
+"""
+
+import logging
+from pathlib import Path
+
+import uvicorn
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+
+from xcpcio.__version__ import __version__
+
+from .dependencies import configure_dependencies
+from .routes import create_router
+
+logger = logging.getLogger(__name__)
+
+
+class ContestAPIServer:
+    """
+    Contest API Server implementing the Contest API specification.
+
+    This server provides REST API endpoints for contest data based on
+    the Contest Package format and Contest API specification.
+    """
+
+    def __init__(self, contest_package_dir: Path):
+        """
+        Initialize the Contest API Server.
+
+        Args:
+            contest_packages: Dictionary mapping contest_id to contest package directory
+        """
+        self.contest_package_dir = contest_package_dir
+
+        # Configure dependency injection for multi-contest mode
+        # This might need adjustment based on how dependencies work
+        configure_dependencies(contest_package_dir)
+
+        # Create FastAPI application
+        self.app = FastAPI(
+            title="Contest API Server",
+            description="REST API for Contest Control System specifications",
+            version=__version__,
+            docs_url="/docs",
+            redoc_url="/redoc",
+            openapi_url="/openapi.json",
+        )
+
+        # Add CORS middleware
+        self.app.add_middleware(
+            CORSMiddleware,
+            allow_origins=["*"],
+            allow_credentials=True,
+            allow_methods=["*"],
+            allow_headers=["*"],
+        )
+
+        # Include all routes
+        router = create_router()
+        self.app.include_router(router)
+
+    def run(self, host: str = "0.0.0.0", port: int = 8000, reload: bool = True, log_level: str = "info"):
+        """
+        Run the contest API server.
+
+        Args:
+            host: Host to bind to
+            port: Port to bind to
+            reload: Enable auto-reload for development
+            log_level: Log level (debug, info, warning, error, critical)
+        """
+
+        logger.info("Starting Contest API Server...")
+        logger.info(f"Contest package dir: {self.contest_package_dir}")
+        logger.info(f"API will be available at: http://{host}:{port}")
+        logger.info(f"Interactive docs at: http://{host}:{port}/docs")
+        logger.info(f"ReDoc at: http://{host}:{port}/redoc")
+
+        uvicorn.run(self.app, host=host, port=port, reload=reload, log_level=log_level)

xcpcio/ccs/api_server/services/__init__.py

@@ -0,0 +1,9 @@
+"""
+Services package for Contest API Server
+
+Contains business logic and data access layers.
+"""
+
+from .contest_service import ContestService
+
+__all__ = ["ContestService"]