Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
165 changes: 52 additions & 113 deletions poetry.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 2 additions & 2 deletions pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -23,8 +23,8 @@ classifiers = [
packages = [{include = "ocp_registry", from = "src"}]

[tool.poetry.dependencies]
python = "^3.8"
fastapi = "^0.104.0"
python = "^3.10"
fastapi = "^0.129.0"
uvicorn = "^0.24.0"
pydantic = "^2.5.0"
httpx = "^0.24.0"
Expand Down
104 changes: 104 additions & 0 deletions src/ocp_registry/api.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
"""API endpoints for OCP Community Registry."""

from fastapi import APIRouter, HTTPException, Depends, Query
from sqlalchemy.orm import Session
from typing import List, Optional

from .database import get_db
from .models import (
APIEntry, APISearchResponse, CategorySummary, RegistryStats,
APICategory, APIListResponse
)
from .service import RegistryService


# Create API router
router = APIRouter(prefix="/api/v1")


# Registry endpoints
@router.get("/registry", response_model=APIListResponse)
async def list_apis(
page: int = Query(1, ge=1, description="Page number"),
per_page: int = Query(20, ge=1, le=100, description="Results per page"),
db: Session = Depends(get_db)
):
"""List all active APIs with pagination."""
service = RegistryService(db)
return service.list_apis(page=page, per_page=per_page)


@router.get("/registry/{name}", response_model=APIEntry)
async def get_api(name: str, db: Session = Depends(get_db)):
"""Get specific API configuration by name."""
service = RegistryService(db)
api_entry = service.get_api(name)
if not api_entry:
raise HTTPException(status_code=404, detail=f"API '{name}' not found")

return api_entry


# Search and discovery endpoints
@router.get("/search", response_model=APISearchResponse)
async def search_apis(
q: str = Query(..., description="Search query"),
category: Optional[APICategory] = Query(None, description="Filter by category"),
page: int = Query(1, ge=1, description="Page number"),
per_page: int = Query(20, ge=1, le=100, description="Results per page"),
db: Session = Depends(get_db)
):
"""Search APIs by name, description, or tags with optional category filter."""
service = RegistryService(db)
return service.search_apis(q, category=category, page=page, per_page=per_page)


@router.get("/categories", response_model=List[CategorySummary])
async def get_categories(db: Session = Depends(get_db)):
"""Get all available categories with API counts."""
service = RegistryService(db)
return service.get_categories()


@router.get("/categories/{category}", response_model=APIListResponse)
async def get_apis_by_category(
category: APICategory,
page: int = Query(1, ge=1, description="Page number"),
per_page: int = Query(20, ge=1, le=100, description="Results per page"),
db: Session = Depends(get_db)
):
"""Get all active APIs in a specific category with pagination."""
service = RegistryService(db)
return service.list_apis_by_category(category=category, page=page, per_page=per_page)


@router.get("/stats", response_model=RegistryStats)
async def get_registry_stats(db: Session = Depends(get_db)):
"""Get pre-calculated registry statistics."""
service = RegistryService(db)
return service.get_stats()


# API root
@router.get("/")
async def api_root():
"""API root endpoint - discovery and metadata."""
return {
"name": "OCP Community Registry",
"version": "0.3.0",
"endpoints": {
"registry": "/api/v1/registry",
"search": "/api/v1/search",
"categories": "/api/v1/categories",
"stats": "/api/v1/stats",
"health": "/api/v1/health"
},
"docs": "/docs"
}


# Health check
@router.get("/health")
async def health_check():
"""Health check endpoint for monitoring and load balancers."""
return {"status": "healthy"}
Loading