40670c094b
New API to maintain sessions and devices:
- GET /api/private/admin/sessions
- DELETE /api/private/admin/sessions/{session_id}
- GET /api/private/admin/trusted-devices
- DELETE /api/private/admin/trusted-devices/{device_id}
Auth:
web clients request `/oauth/token` and `/api/v2/session/verify` with `X-UUID` header to save the client as trusted device.
---------
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
280 lines
7.9 KiB
Python
280 lines
7.9 KiB
Python
from __future__ import annotations
|
||
|
||
import asyncio
|
||
from collections.abc import Awaitable, Callable, Sequence
|
||
from datetime import UTC, datetime
|
||
import functools
|
||
import inspect
|
||
from io import BytesIO
|
||
import re
|
||
from typing import TYPE_CHECKING, Any, ParamSpec, TypeVar
|
||
|
||
from fastapi import HTTPException
|
||
from PIL import Image
|
||
|
||
if TYPE_CHECKING:
|
||
from app.models.model import UserAgentInfo
|
||
|
||
|
||
def unix_timestamp_to_windows(timestamp: int) -> int:
|
||
"""Convert a Unix timestamp to a Windows timestamp."""
|
||
return (timestamp + 62135596800) * 10_000_000
|
||
|
||
|
||
def camel_to_snake(name: str) -> str:
|
||
"""Convert a camelCase string to snake_case."""
|
||
result = []
|
||
last_chr = ""
|
||
for char in name:
|
||
if char.isupper():
|
||
if not last_chr.isupper() and result:
|
||
result.append("_")
|
||
result.append(char.lower())
|
||
else:
|
||
result.append(char)
|
||
last_chr = char
|
||
return "".join(result)
|
||
|
||
|
||
def snake_to_camel(name: str, use_abbr: bool = True) -> str:
|
||
"""Convert a snake_case string to camelCase."""
|
||
if not name:
|
||
return name
|
||
|
||
parts = name.split("_")
|
||
if not parts:
|
||
return name
|
||
|
||
# 常见缩写词列表
|
||
abbreviations = {
|
||
"id",
|
||
"url",
|
||
"api",
|
||
"http",
|
||
"https",
|
||
"xml",
|
||
"json",
|
||
"css",
|
||
"html",
|
||
"sql",
|
||
"db",
|
||
}
|
||
|
||
result = []
|
||
for part in parts:
|
||
if part.lower() in abbreviations and use_abbr:
|
||
result.append(part.upper())
|
||
else:
|
||
if result:
|
||
result.append(part.capitalize())
|
||
else:
|
||
result.append(part.lower())
|
||
|
||
return "".join(result)
|
||
|
||
|
||
def snake_to_pascal(name: str, use_abbr: bool = True) -> str:
|
||
"""Convert a snake_case string to PascalCase."""
|
||
if not name:
|
||
return name
|
||
|
||
parts = name.split("_")
|
||
if not parts:
|
||
return name
|
||
|
||
# 常见缩写词列表
|
||
abbreviations = {
|
||
"id",
|
||
"url",
|
||
"api",
|
||
"http",
|
||
"https",
|
||
"xml",
|
||
"json",
|
||
"css",
|
||
"html",
|
||
"sql",
|
||
"db",
|
||
}
|
||
|
||
result = []
|
||
for part in parts:
|
||
if part.lower() in abbreviations and use_abbr:
|
||
result.append(part.upper())
|
||
else:
|
||
result.append(part.capitalize())
|
||
|
||
return "".join(result)
|
||
|
||
|
||
def are_adjacent_weeks(dt1: datetime, dt2: datetime) -> bool:
|
||
y1, w1, _ = dt1.isocalendar()
|
||
y2, w2, _ = dt2.isocalendar()
|
||
|
||
# 按 (年, 周) 排序，保证 dt1 <= dt2
|
||
if (y1, w1) > (y2, w2):
|
||
y1, w1, y2, w2 = y2, w2, y1, w1
|
||
|
||
# 同一年，周数相邻
|
||
if y1 == y2 and w2 - w1 == 1:
|
||
return True
|
||
|
||
# 跨年，判断 y2 是否是下一年，且 w2 == 1，并且 w1 是 y1 的最后一周
|
||
if y2 == y1 + 1 and w2 == 1:
|
||
# 判断 y1 的最后一周是多少
|
||
last_week_y1 = datetime(y1, 12, 28).isocalendar()[1] # 12-28 保证在最后一周
|
||
if w1 == last_week_y1:
|
||
return True
|
||
|
||
return False
|
||
|
||
|
||
def are_same_weeks(dt1: datetime, dt2: datetime) -> bool:
|
||
return dt1.isocalendar()[:2] == dt2.isocalendar()[:2]
|
||
|
||
|
||
def truncate(text: str, limit: int = 100, ellipsis: str = "...") -> str:
|
||
if len(text) > limit:
|
||
return text[:limit] + ellipsis
|
||
return text
|
||
|
||
|
||
def check_image(content: bytes, size: int, width: int, height: int) -> str:
|
||
if len(content) > size: # 10MB limit
|
||
raise HTTPException(status_code=400, detail="File size exceeds 10MB limit")
|
||
elif len(content) == 0:
|
||
raise HTTPException(status_code=400, detail="File cannot be empty")
|
||
try:
|
||
with Image.open(BytesIO(content)) as img:
|
||
if img.format not in ["PNG", "JPEG", "GIF"]:
|
||
raise HTTPException(status_code=400, detail="Invalid image format")
|
||
if img.size[0] > width or img.size[1] > height:
|
||
raise HTTPException(
|
||
status_code=400,
|
||
detail=f"Image size exceeds {width}x{height} pixels",
|
||
)
|
||
return img.format.lower()
|
||
except Exception as e:
|
||
raise HTTPException(status_code=400, detail=f"Error processing image: {e}")
|
||
|
||
|
||
def extract_user_agent(user_agent: str | None) -> "UserAgentInfo":
|
||
from app.models.model import UserAgentInfo
|
||
|
||
raw_ua = user_agent or ""
|
||
ua = raw_ua.strip()
|
||
lower_ua = ua.lower()
|
||
|
||
info = UserAgentInfo(raw_ua=raw_ua)
|
||
|
||
if not ua:
|
||
return info
|
||
|
||
client_identifiers = ("osu!", "osu!lazer", "osu-framework")
|
||
if any(identifier in lower_ua for identifier in client_identifiers):
|
||
info.browser = "osu!"
|
||
info.is_client = True
|
||
return info
|
||
|
||
browser_patterns: tuple[tuple[re.Pattern[str], str], ...] = (
|
||
(re.compile(r"OPR/(\d+(?:\.\d+)*)"), "Opera"),
|
||
(re.compile(r"Edg/(\d+(?:\.\d+)*)"), "Edge"),
|
||
(re.compile(r"Chrome/(\d+(?:\.\d+)*)"), "Chrome"),
|
||
(re.compile(r"Firefox/(\d+(?:\.\d+)*)"), "Firefox"),
|
||
(re.compile(r"Version/(\d+(?:\.\d+)*).*Safari"), "Safari"),
|
||
(re.compile(r"Safari/(\d+(?:\.\d+)*)"), "Safari"),
|
||
(re.compile(r"MSIE (\d+(?:\.\d+)*)"), "Internet Explorer"),
|
||
(re.compile(r"Trident/.*rv:(\d+(?:\.\d+)*)"), "Internet Explorer"),
|
||
)
|
||
|
||
for pattern, name in browser_patterns:
|
||
match = pattern.search(ua)
|
||
if match:
|
||
info.browser = name
|
||
info.version = match.group(1)
|
||
break
|
||
|
||
os_patterns: tuple[tuple[re.Pattern[str], str], ...] = (
|
||
(re.compile(r"windows nt 10"), "Windows 10"),
|
||
(re.compile(r"windows nt 6\.3"), "Windows 8.1"),
|
||
(re.compile(r"windows nt 6\.2"), "Windows 8"),
|
||
(re.compile(r"windows nt 6\.1"), "Windows 7"),
|
||
(re.compile(r"windows nt 6\.0"), "Windows Vista"),
|
||
(re.compile(r"windows nt 5\.1"), "Windows XP"),
|
||
(re.compile(r"mac os x"), "macOS"),
|
||
(re.compile(r"iphone os"), "iOS"),
|
||
(re.compile(r"ipad;"), "iPadOS"),
|
||
(re.compile(r"android"), "Android"),
|
||
(re.compile(r"linux"), "Linux"),
|
||
)
|
||
|
||
for pattern, name in os_patterns:
|
||
if pattern.search(lower_ua):
|
||
info.os = name
|
||
break
|
||
|
||
info.is_mobile = any(keyword in lower_ua for keyword in ("mobile", "iphone", "android", "ipod"))
|
||
info.is_tablet = any(keyword in lower_ua for keyword in ("ipad", "tablet"))
|
||
# Only classify as PC if not mobile or tablet
|
||
if (
|
||
not info.is_mobile
|
||
and not info.is_tablet
|
||
and any(keyword in lower_ua for keyword in ("windows", "macintosh", "linux", "x11"))
|
||
):
|
||
info.is_pc = True
|
||
|
||
if info.is_tablet:
|
||
info.platform = "tablet"
|
||
elif info.is_mobile:
|
||
info.platform = "mobile"
|
||
elif info.is_pc:
|
||
info.platform = "pc"
|
||
|
||
return info
|
||
|
||
|
||
# https://github.com/encode/starlette/blob/master/starlette/_utils.py
|
||
T = TypeVar("T")
|
||
AwaitableCallable = Callable[..., Awaitable[T]]
|
||
|
||
|
||
def is_async_callable(obj: Any) -> bool:
|
||
while isinstance(obj, functools.partial):
|
||
obj = obj.func
|
||
|
||
return inspect.iscoroutinefunction(obj)
|
||
|
||
|
||
P = ParamSpec("P")
|
||
|
||
|
||
async def run_in_threadpool(func: Callable[P, T], *args: P.args, **kwargs: P.kwargs) -> T:
|
||
func = functools.partial(func, *args, **kwargs)
|
||
return await asyncio.get_event_loop().run_in_executor(None, func)
|
||
|
||
|
||
class BackgroundTasks:
|
||
def __init__(self, tasks: Sequence[asyncio.Task] | None = None):
|
||
self.tasks = set(tasks) if tasks else set()
|
||
|
||
def add_task(self, func: Callable[P, Any], *args: P.args, **kwargs: P.kwargs) -> None:
|
||
if is_async_callable(func):
|
||
coro = func(*args, **kwargs)
|
||
else:
|
||
coro = run_in_threadpool(func, *args, **kwargs)
|
||
task = asyncio.create_task(coro)
|
||
self.tasks.add(task)
|
||
task.add_done_callback(self.tasks.discard)
|
||
|
||
def stop(self) -> None:
|
||
for task in self.tasks:
|
||
task.cancel()
|
||
self.tasks.clear()
|
||
|
||
|
||
bg_tasks = BackgroundTasks()
|
||
|
||
|
||
def utcnow() -> datetime:
|
||
return datetime.now(tz=UTC)
|