mirror of
https://github.com/ZTatman/myst.git
synced 2026-11-20 20:07:59 +00:00
101 lines
3.2 KiB
Python
101 lines
3.2 KiB
Python
from __future__ import annotations
|
|
|
|
from collections.abc import AsyncIterator
|
|
from typing import Annotated, Any
|
|
from urllib.parse import urlsplit
|
|
|
|
import httpx
|
|
from fastapi import Depends, HTTPException
|
|
|
|
from app.config import get_app_settings
|
|
from app.models.app_settings import AppSettings
|
|
|
|
|
|
def validate_base_url(value: str) -> str:
|
|
"""Keep authenticated requests on a configured, encrypted transport."""
|
|
try:
|
|
url = urlsplit(value.strip())
|
|
local = url.hostname in {"localhost", "127.0.0.1", "::1", "forgejo"} or (
|
|
url.hostname is not None and url.hostname.endswith(".localhost")
|
|
)
|
|
valid = (
|
|
bool(url.hostname)
|
|
and (url.scheme == "https" or (url.scheme == "http" and local))
|
|
and not url.username
|
|
and not url.password
|
|
and not url.query
|
|
and not url.fragment
|
|
)
|
|
_ = url.port
|
|
except ValueError:
|
|
valid = False
|
|
if not valid:
|
|
raise HTTPException(
|
|
503,
|
|
detail={
|
|
"stage": "configuration",
|
|
"message": "Configure an HTTPS Forgejo URL (HTTP is allowed for local endpoints).",
|
|
},
|
|
)
|
|
return value.strip().rstrip("/")
|
|
|
|
|
|
async def get_client(
|
|
settings: Annotated[AppSettings, Depends(get_app_settings)],
|
|
) -> AsyncIterator[httpx.AsyncClient]:
|
|
if settings is None:
|
|
raise HTTPException(503, detail={"stage": "configuration", "message": "Setup required."})
|
|
base_url = validate_base_url(settings.forgejo_base_url)
|
|
async with httpx.AsyncClient(
|
|
base_url=base_url + "/api/v1/",
|
|
timeout=10.0,
|
|
follow_redirects=False,
|
|
) as client:
|
|
yield client
|
|
|
|
|
|
async def get(
|
|
client: httpx.AsyncClient,
|
|
path: str,
|
|
pat: str,
|
|
stage: str,
|
|
*,
|
|
params: dict[str, int] | None = None,
|
|
) -> tuple[Any, httpx.Response]:
|
|
"""Return the parsed body and pagination headers without reflecting errors."""
|
|
try:
|
|
response = await client.get(
|
|
path,
|
|
params=params,
|
|
headers={"Authorization": f"token {pat}", "Accept": "application/json"},
|
|
)
|
|
except httpx.RequestError:
|
|
raise HTTPException(
|
|
502,
|
|
detail={
|
|
"stage": stage,
|
|
"message": "Cannot reach Forgejo. Check the connection settings.",
|
|
},
|
|
) from None
|
|
if response.status_code != 200:
|
|
status = 404 if response.status_code == 404 and stage in {"repository", "branch"} else 502
|
|
message = (
|
|
"Forgejo could not find the selected repository or branch."
|
|
if status == 404
|
|
else (
|
|
"Forgejo rejected the PAT. Check its validity and read:user/read:repository scopes."
|
|
if response.status_code in {401, 403}
|
|
else "Forgejo returned an unexpected response."
|
|
)
|
|
)
|
|
raise HTTPException(status, detail={"stage": stage, "message": message})
|
|
try:
|
|
return response.json(), response
|
|
except ValueError:
|
|
raise malformed(stage) from None
|
|
|
|
|
|
def malformed(stage: str) -> HTTPException:
|
|
return HTTPException(
|
|
502, detail={"stage": stage, "message": "Forgejo returned invalid JSON data."}
|
|
)
|