doc: rm unnecessary documentation

apps/olapi/auth.py

@@ -1,11 +1,11 @@
+from authentication import exceptions as auth_exceptions
+from authentication.keycloak import KeycloakClient
 from fastapi import Depends, HTTPException, status
 from fastapi.security import OAuth2PasswordBearer
 from sqlalchemy import select
 from sqlalchemy.exc import NoResultFound
 from sqlalchemy.orm import Session
 
-from authentication import exceptions as auth_exceptions
-from authentication.keycloak import KeycloakClient
 from database import get_session
 from models.user import UserModel
 from settings import settings

apps/olapi/dtos/auth.py

@@ -1,8 +1,7 @@
 from typing import Self
 
-from pydantic import BaseModel, EmailStr
-
 from authentication.keycloak import TokenInfo
+from pydantic import BaseModel, EmailStr
 
 
 class Credentials(BaseModel):

apps/olapi/pyproject.toml

@@ -2,7 +2,6 @@
 name = "olapi"
 version = "0.0.1"
 description = "Social Media API"
-readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
     "fastapi>=0.110",
@@ -16,9 +15,6 @@ dependencies = [
     "authentication",
 ]
 
-# Flat uv-app: no [build-system], so the app is not built or installed as a
-# package. Its modules are imported relative to this directory (see pythonpath).
-
 [tool.uv.sources]
 authentication = { workspace = true }
 
@@ -27,18 +23,3 @@ pythonpath = ["."]
 
 [tool.ruff]
 extend = "../../pyproject.toml"
-
-# The app is flat, so isort can't auto-detect its own modules; the authentication
-# workspace library is also a first-party concern. Group them together.
-[tool.ruff.lint.isort]
-known-first-party = [
-    "authentication",
-    "auth",
-    "conftest",
-    "database",
-    "dtos",
-    "main",
-    "models",
-    "routers",
-    "settings",
-]

apps/olapi/routers/auth.py

@@ -1,13 +1,13 @@
 import logging
 
+from authentication import exceptions as auth_exceptions
 from fastapi import APIRouter, Depends, HTTPException, status
 from sqlalchemy import select
 from sqlalchemy.exc import NoResultFound, SQLAlchemyError
 from sqlalchemy.orm import Session
 from ulid import ULID
 
 from auth import auth_client
-from authentication import exceptions as auth_exceptions
 from database import get_session
 from dtos.auth import Credentials, TokenResponse
 from dtos.user import User, UserCreatePayload

apps/olapi/scripts/request_api.py

@@ -1,8 +1,8 @@
 import logging
 
 import httpx2
-
 from authentication.keycloak import check_response
+
 from dtos.auth import Credentials, TokenResponse
 from dtos.user import User, UserCreatePayload
 

apps/olapi/tests/test_temporary.py

@@ -1,7 +1,7 @@
+from conftest import TEST_AUTH_ID
 from fastapi.testclient import TestClient
 from sqlalchemy.orm import Session
 
-from conftest import TEST_AUTH_ID
 from models.user import UserModel
 
 

docker/Dockerfile

@@ -11,7 +11,6 @@ RUN uv sync --frozen --no-dev
 
 ENV PATH="/app/.venv/bin:$PATH"
 
-# The olapi app is a flat uv-app; run it from its own directory so `main:app` resolves.
 WORKDIR /app/apps/olapi
 
 EXPOSE 8000

libs/authentication/pyproject.toml

@@ -2,7 +2,6 @@
 name = "authentication"
 version = "0.0.1"
 description = "Keycloak authentication client"
-readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
     "httpx2>=2.3",

pyproject.toml

@@ -10,15 +10,9 @@ dev = [
 ]
 
 [tool.pytest.ini_options]
-# Libraries are collected here; apps run in their own pytest process (see the
-# Makefile) so the flat app modules don't collide with library test discovery.
 testpaths = ["libs"]
-# importlib import mode imports each test file under a unique name, so
-# identically-named test files across members can coexist without __init__.py.
-addopts = ["--import-mode=importlib"]
+addopts = ["--import-mode=importlib"]  # avoid test name conflict between libraries
 
-# Shared lint config for the whole workspace. Members extend this via
-# `[tool.ruff] extend = "../../pyproject.toml"`.
 [tool.ruff]
 target-version = "py312"
 line-length = 100
@@ -45,8 +39,5 @@ venvPath = "."
 venv = ".venv"
 include = ["apps", "libs"]
 
-# The olapi app is a flat, non-packaged uv-app: its modules live directly under
-# apps/olapi and are imported as `from main import ...`. This execution
-# environment puts that directory on the import path for the type checker.
 [[tool.pyright.executionEnvironments]]
 root = "apps/olapi"