Backend API: auth, projects/images/annotations, R2 presign, tracing, thumbnails, pagination, tests, docs
This commit is contained in:
parent
5c5deed2f5
commit
f8ed08b854
49 changed files with 2626 additions and 0 deletions
74
shared/r2.py
Normal file
74
shared/r2.py
Normal file
|
|
@ -0,0 +1,74 @@
|
|||
"""Thin boto3 wrapper for R2 (S3-compatible). No image bytes pass through the API."""
|
||||
from __future__ import annotations
|
||||
|
||||
from functools import lru_cache
|
||||
|
||||
from src.core.config import get_settings
|
||||
|
||||
|
||||
@lru_cache
|
||||
def _client():
|
||||
try:
|
||||
import boto3
|
||||
from botocore.config import Config
|
||||
except ImportError as e:
|
||||
raise RuntimeError("boto3 not installed: pip install -r requirements.txt") from e
|
||||
s = get_settings()
|
||||
if not s.r2_configured:
|
||||
raise RuntimeError("R2 not configured: set R2_ENDPOINT/R2_ACCESS_KEY_ID/R2_SECRET in .env")
|
||||
return boto3.client(
|
||||
"s3",
|
||||
endpoint_url=s.r2_endpoint,
|
||||
aws_access_key_id=s.r2_key_id,
|
||||
aws_secret_access_key=s.r2_secret,
|
||||
config=Config(signature_version="s3v4", s3={"addressing_style": "path"}),
|
||||
region_name="auto",
|
||||
)
|
||||
|
||||
|
||||
def presign_put(key: str, content_type: str = "application/octet-stream") -> str:
|
||||
"""Direct-upload URL: browser/app PUTs bytes straight to R2 (saves Class-A + bandwidth)."""
|
||||
s = get_settings()
|
||||
return _client().generate_presigned_url(
|
||||
"put_object",
|
||||
Params={"Bucket": s.r2_bucket, "Key": key, "ContentType": content_type},
|
||||
ExpiresIn=s.presign_put_ttl,
|
||||
)
|
||||
|
||||
|
||||
def presign_get(key: str) -> str:
|
||||
"""Short-lived read URL for preview/download. Thumbnails preferred over full images."""
|
||||
s = get_settings()
|
||||
if s.r2_public_base:
|
||||
return f"{s.r2_public_base.rstrip('/')}/{key}"
|
||||
return _client().generate_presigned_url(
|
||||
"get_object",
|
||||
Params={"Bucket": s.r2_bucket, "Key": key},
|
||||
ExpiresIn=s.presign_get_ttl,
|
||||
)
|
||||
|
||||
|
||||
def head_exists(key: str) -> bool:
|
||||
s = get_settings()
|
||||
try:
|
||||
_client().head_object(Bucket=s.r2_bucket, Key=key)
|
||||
return True
|
||||
except Exception:
|
||||
return False
|
||||
|
||||
|
||||
def get_bytes(key: str) -> bytes:
|
||||
"""Download an object into memory (for workers/thumbnails, not hot paths)."""
|
||||
s = get_settings()
|
||||
obj = _client().get_object(Bucket=s.r2_bucket, Key=key)
|
||||
return obj["Body"].read()
|
||||
|
||||
|
||||
def put_bytes(key: str, data: bytes, content_type: str = "image/jpeg",
|
||||
cache_control: str | None = None) -> None:
|
||||
s = get_settings()
|
||||
params: dict = {"Bucket": s.r2_bucket, "Key": key, "Body": data,
|
||||
"ContentType": content_type}
|
||||
if cache_control:
|
||||
params["CacheControl"] = cache_control
|
||||
_client().put_object(**params)
|
||||
Loading…
Add table
Add a link
Reference in a new issue