Spaces:
Sleeping
Sleeping
File size: 2,698 Bytes
6ca8e48 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 | """Pydantic models for DocForge API request/response schemas."""
from datetime import date
from enum import Enum
from typing import Any
from uuid import UUID
from pydantic import BaseModel, Field
class InputType(str, Enum):
npm = "npm"
pypi = "pypi"
url = "url"
github = "github"
paste = "paste"
crates = "crates"
rubygems = "rubygems"
pubdev = "pubdev"
nuget = "nuget"
maven = "maven"
hex = "hex"
cran = "cran"
class OutputFormat(str, Enum):
context_md = "context_md"
json = "json"
mcp = "mcp"
class JobStatus(str, Enum):
queued = "queued"
processing = "processing"
complete = "complete"
failed = "failed"
class ContextRequest(BaseModel):
input: str = Field(..., description="Package name, URL, or GitHub repo")
input_type: InputType = Field(InputType.npm, description="Type of input")
components: list[str] | None = Field(None, description="Specific components to extract")
output_format: OutputFormat = Field(OutputFormat.context_md, description="Output format")
content: str | None = Field(None, description="Raw content for paste input type")
# Client-supplied API keys (used when no Bearer token is present)
gemini_key: str | None = Field(None, description="Gemini API key (CLI local-key mode)")
groq_key: str | None = Field(None, description="Groq API key (CLI local-key mode)")
class JobCreatedResponse(BaseModel):
job_id: str
status: JobStatus = JobStatus.queued
class PropSchema(BaseModel):
name: str
type: str
required: bool = False
default: str | None = None
class ComponentSchema(BaseModel):
name: str
import_path: str | None = None
install_command: str | None = None
props: list[PropSchema] = Field(default_factory=list)
gotchas: list[str] = Field(default_factory=list)
peer_dependencies: list[str] = Field(default_factory=list)
usage_example: str | None = None
last_verified: str = Field(default_factory=lambda: date.today().isoformat())
class StructuredLibrary(BaseModel):
library: str
version: str
description: str | None = None
components: list[ComponentSchema] = Field(default_factory=list)
class ContextJobResult(BaseModel):
status: JobStatus
job_id: str
library: str | None = None
version: str | None = None
output: str | None = None
components: list[dict[str, Any]] = Field(default_factory=list)
error: str | None = None
class SearchResult(BaseModel):
name: str
version: str
cached_at: str
class SearchResponse(BaseModel):
results: list[SearchResult]
class VersionsResponse(BaseModel):
package: str
versions: list[str] |