test0001 0.1.0__tar.gz

test0001-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chris <goabonga@pm.me>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights  
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell     
+copies of the Software, and to permit persons to whom the Software is         
+furnished to do so, subject to the following conditions:                       
+
+The above copyright notice and this permission notice shall be included in    
+all copies or substantial portions of the Software.                            
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR    
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,      
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE   
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER        
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN     
+THE SOFTWARE.

test0001-0.1.0/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.3
+Name: test0001
+Version: 0.1.0
+Summary: OIDC/OAuth2 authentication service.
+License: MIT
+Keywords: oidc,oauth2,authentication,authorization,identity,openid-connect,jwt,token,sso,security
+Author: Chris
+Author-email: goabonga@pm.me
+Requires-Python: >=3.10
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Internet :: WWW/HTTP :: Session
+Classifier: Topic :: Security
+Classifier: Topic :: System :: Systems Administration :: Authentication/Directory
+Classifier: Typing :: Typed
+Provides-Extra: server
+Provides-Extra: worker
+Requires-Dist: alembic ; extra == "server"
+Requires-Dist: asyncpg ; extra == "server"
+Requires-Dist: celery[redis] ; extra == "worker"
+Requires-Dist: fastapi ; extra == "server"
+Requires-Dist: jinja2 ; extra == "server"
+Requires-Dist: pydantic-settings
+Requires-Dist: sqlalchemy[asyncio] ; extra == "server"
+Requires-Dist: uvicorn[standard] ; extra == "server"
+Description-Content-Type: text/markdown
+
+# Shomer
+
+OIDC/OAuth2 authentication service.
+
+## Installation
+
+### CLI only
+
+```bash
+pip install shomer
+```
+
+### CLI + Server
+
+```bash
+pip install shomer[server]
+```
+
+### CLI + Worker
+
+```bash
+pip install shomer[worker]
+```
+
+### All components
+
+```bash
+pip install shomer[server,worker]
+```
+
+### Docker
+
+```bash
+docker pull ghcr.io/goabonga/shomer-server:latest
+docker run -p 8000:8000 ghcr.io/goabonga/shomer-server:latest
+```
+
+### Docker Compose
+
+```bash
+git clone https://github.com/goabonga/shomer.git
+cd shomer
+make docker-up
+```
+
+### Helm
+
+```bash
+helm install shomer oci://ghcr.io/goabonga/shomer-chart/shomer --version 0.1.0
+```
+
+## Development
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the full contribution guide.
+
+## License
+
+[MIT](LICENSE)
+

test0001-0.1.0/README.md

@@ -0,0 +1,58 @@
+# Shomer
+
+OIDC/OAuth2 authentication service.
+
+## Installation
+
+### CLI only
+
+```bash
+pip install shomer
+```
+
+### CLI + Server
+
+```bash
+pip install shomer[server]
+```
+
+### CLI + Worker
+
+```bash
+pip install shomer[worker]
+```
+
+### All components
+
+```bash
+pip install shomer[server,worker]
+```
+
+### Docker
+
+```bash
+docker pull ghcr.io/goabonga/shomer-server:latest
+docker run -p 8000:8000 ghcr.io/goabonga/shomer-server:latest
+```
+
+### Docker Compose
+
+```bash
+git clone https://github.com/goabonga/shomer.git
+cd shomer
+make docker-up
+```
+
+### Helm
+
+```bash
+helm install shomer oci://ghcr.io/goabonga/shomer-chart/shomer --version 0.1.0
+```
+
+## Development
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the full contribution guide.
+
+## License
+
+[MIT](LICENSE)

test0001-0.1.0/pyproject.toml

@@ -0,0 +1,188 @@
+[tool.poetry]
+name = "test0001"
+version = "0.1.0"
+description = "OIDC/OAuth2 authentication service."
+authors = ["Chris <goabonga@pm.me>"]
+license = "MIT"
+readme = "README.md"
+packages = [
+  { include = "shomer", from = "src" }
+]
+include = [
+  "src/shomer/py.typed"
+]
+exclude = [
+  "tests",
+  "scripts",
+  "docs",
+  "Makefile"
+]
+keywords = [
+  "oidc",
+  "oauth2",
+  "authentication",
+  "authorization",
+  "identity",
+  "openid-connect",
+  "jwt",
+  "token",
+  "sso",
+  "security"
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Natural Language :: English",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Security",
+  "Topic :: Internet :: WWW/HTTP :: Session",
+  "Topic :: System :: Systems Administration :: Authentication/Directory",
+  "Typing :: Typed"
+]
+
+[tool.poetry.dependencies]
+python = ">=3.10"
+pydantic-settings = "*"
+fastapi = {version = "*", optional = true}
+uvicorn = {extras = ["standard"], version = "*", optional = true}
+jinja2 = {version = "*", optional = true}
+sqlalchemy = {extras = ["asyncio"], version = "*", optional = true}
+asyncpg = {version = "*", optional = true}
+alembic = {version = "*", optional = true}
+celery = {extras = ["redis"], version = "*", optional = true}
+
+[tool.poetry.extras]
+server = ["fastapi", "uvicorn", "jinja2", "sqlalchemy", "asyncpg", "alembic"]
+worker = ["celery"]
+
+[tool.poetry.group.dev]
+optional = true
+
+[tool.poetry.group.dev.dependencies]
+commitizen = "*"
+pytest = "*"
+pytest-cov = "*"
+ruff = "*"
+isort = "*"
+mypy = "*"
+
+[tool.poetry.group.test]
+optional = true
+
+[tool.poetry.group.test.dependencies]
+behave = "*"
+playwright = "*"
+
+[tool.poetry.group.favicon]
+optional = true
+
+[tool.poetry.group.favicon.dependencies]
+cairosvg = "*"
+Pillow = "*"
+
+[tool.poetry.group.docs]
+optional = true
+
+[tool.poetry.group.docs.dependencies]
+mkdocs = "*"
+mkdocs-material = "*"
+mkdocs-gen-files = "*"
+mkdocs-autorefs = "*"
+mkdocstrings = {extras = ["python"], version = "*"}
+mkdocs-macros-plugin = "*"
+
+[tool.poetry.scripts]
+shomer = "shomer.cli:main"
+
+[tool.behave]
+paths = ["features"]
+
+[[tool.poetry-auto-export.exports]]
+output = "requirements.txt"
+without_hashes = true
+
+[[tool.poetry-auto-export.exports]]
+output = "requirements-server.txt"
+without_hashes = true
+extras = ["server"]
+
+[[tool.poetry-auto-export.exports]]
+output = "requirements-worker.txt"
+without_hashes = true
+extras = ["worker"]
+
+[[tool.poetry-auto-export.exports]]
+output = "requirements-dev.txt"
+without_hashes = true
+with = ["dev", "docs", "test"]
+extras = ["server", "worker"]
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.commitizen]
+name = "cz_conventional_commits"
+version = "0.1.0"
+tag_format = "v$version"
+update_changelog_on_bump = true
+changelog_file = "CHANGELOG.md"
+changelog_incremental = true
+major_version_zero = true
+version_files = [
+  "pyproject.toml:version",
+  "src/shomer/__init__.py",
+  "tests/test_version.py:__expected_version__",
+  "features/steps/ui_steps.py:__expected_version__",
+  "chart/shomer/Chart.yaml:version",
+  "chart/shomer/Chart.yaml:appVersion",
+  "README.md:--version",
+  "mkdocs.yml:version"
+]
+gpg_sign = true
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+addopts = "--cov=src/shomer --cov-report=term --cov-report=xml --cov-report=html --junitxml=junit.xml -o junit_family=legacy"
+testpaths = ["tests"]
+
+[tool.coverage.run]
+omit = [
+    "tests/*"
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+    "if __name__ == .__main__.:",
+    "raise NotImplementedError",
+    "pass  # abstract",
+    "\\.\\.\\.",
+    "except ImportError",
+]
+
+[tool.isort]
+profile = "black"
+src_paths = ["src", "tests"]
+
+[tool.ruff]
+line-length = 88
+src = ["src", "tests"]
+exclude = ["__pycache__"]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+files = ["src", "tests"]
+
+[[tool.mypy.overrides]]
+module = ["celery", "celery.*"]
+ignore_missing_imports = true

test0001-0.1.0/src/shomer/__init__.py

@@ -0,0 +1,9 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2025 Chris <goabonga@pm.me>
+
+__version__: str = "0.1.0"
+"""Current version of the shomer package."""
+
+__all__ = [
+    "__version__",
+]

test0001-0.1.0/src/shomer/app.py

@@ -0,0 +1,64 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2025 Chris <goabonga@pm.me>
+
+"""FastAPI application for the Shomer authentication service."""
+
+import asyncio
+from contextlib import asynccontextmanager
+from pathlib import Path
+from typing import AsyncIterator
+
+from fastapi import FastAPI
+from fastapi.staticfiles import StaticFiles
+from fastapi.templating import Jinja2Templates
+
+from . import __version__
+from .core.settings import get_settings
+
+settings = get_settings()
+
+state: dict[str, str] = {"status": "starting"}
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI) -> AsyncIterator[None]:
+    """Application lifespan handler."""
+    from shomer.core.database import engine
+
+    await asyncio.sleep(settings.startup_delay)
+    state["status"] = "ready"
+    yield
+    state["status"] = "shutting_down"
+    await engine.dispose()
+
+
+def create_app() -> FastAPI:
+    """Create and configure the FastAPI application."""
+    application = FastAPI(
+        title="Shomer",
+        description="OIDC/OAuth2 authentication service.",
+        version=__version__,
+        docs_url=None,
+        redoc_url=None,
+        lifespan=lifespan,
+    )
+
+    application.mount(
+        "/static",
+        StaticFiles(directory=str(Path(__file__).parent / "static")),
+        name="static",
+    )
+
+    from shomer.routes.docs import router as docs_router
+    from shomer.routes.health import router as health_router
+    from shomer.routes.views import router as views_router
+
+    application.include_router(health_router)
+    application.include_router(docs_router)
+    application.include_router(views_router)
+
+    return application
+
+
+templates = Jinja2Templates(directory=str(Path(__file__).parent / "templates"))
+app = create_app()

test0001-0.1.0/src/shomer/cli.py

@@ -0,0 +1,23 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2025 Chris <goabonga@pm.me>
+
+"""Command-line interface for the Shomer authentication service."""
+
+import argparse
+
+from shomer import __version__
+
+
+def main() -> None:
+    """Parse command-line arguments and execute the CLI."""
+    parser = argparse.ArgumentParser(
+        prog="shomer", description="OIDC/OAuth2 authentication service."
+    )
+    parser.add_argument(
+        "--version", action="version", version=f"%(prog)s v{__version__}"
+    )
+    parser.parse_args()
+
+
+if __name__ == "__main__":
+    main()

test0001-0.1.0/src/shomer/core/__init__.py

@@ -0,0 +1,4 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2025 Chris <goabonga@pm.me>
+
+"""Core modules."""

test0001-0.1.0/src/shomer/core/database.py

@@ -0,0 +1,26 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2025 Chris <goabonga@pm.me>
+
+"""Async SQLAlchemy database setup."""
+
+from collections.abc import AsyncIterator
+
+from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker, create_async_engine
+from sqlalchemy.orm import DeclarativeBase
+
+from shomer.core.settings import get_settings
+
+settings = get_settings()
+
+engine = create_async_engine(settings.database_url, echo=False)
+async_session = async_sessionmaker(engine, expire_on_commit=False)
+
+
+class Base(DeclarativeBase):
+    """Base class for SQLAlchemy models."""
+
+
+async def get_db() -> AsyncIterator[AsyncSession]:  # pragma: no cover
+    """Yield an async database session."""
+    async with async_session() as session:
+        yield session

test0001-0.1.0/src/shomer/core/settings.py

@@ -0,0 +1,42 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2025 Chris <goabonga@pm.me>
+
+"""Application settings using pydantic-settings."""
+
+from functools import lru_cache
+
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class Settings(BaseSettings):
+    """Application configuration loaded from environment variables."""
+
+    model_config = SettingsConfigDict(env_prefix="SHOMER_", env_file=".env")
+
+    # Server
+    host: str = "0.0.0.0"
+    port: int = 8000
+    startup_delay: float = 1.0
+
+    # Database
+    database_url: str = "postgresql+asyncpg://shomer:shomer@localhost:5432/shomer"
+
+    # Celery
+    celery_broker_url: str = "redis://localhost:6379/0"
+    celery_result_backend: str = ""
+
+    @property
+    def celery_backend(self) -> str:
+        """Return result backend, defaulting to broker URL."""
+        return self.celery_result_backend or self.celery_broker_url
+
+    @property
+    def database_url_sync(self) -> str:
+        """Return sync database URL for Alembic."""
+        return self.database_url.replace("+asyncpg", "")
+
+
+@lru_cache
+def get_settings() -> Settings:
+    """Return cached settings instance."""
+    return Settings()

test0001-0.1.0/src/shomer/routes/__init__.py

@@ -0,0 +1,4 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2025 Chris <goabonga@pm.me>
+
+"""FastAPI route modules."""

test0001-0.1.0/src/shomer/routes/docs.py

@@ -0,0 +1,32 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2025 Chris <goabonga@pm.me>
+
+"""Documentation routes."""
+
+from fastapi import APIRouter, Request
+from fastapi.openapi.docs import get_redoc_html, get_swagger_ui_html
+from fastapi.responses import HTMLResponse
+
+router = APIRouter()
+
+FAVICON_URL = "/static/favicon.ico"
+
+
+@router.get("/docs", include_in_schema=False)
+def docs(request: Request) -> HTMLResponse:
+    """Render the Swagger UI documentation."""
+    return get_swagger_ui_html(
+        openapi_url=request.app.openapi_url,
+        title=f"{request.app.title} - Docs",
+        swagger_favicon_url=FAVICON_URL,
+    )
+
+
+@router.get("/redoc", include_in_schema=False)
+def redoc(request: Request) -> HTMLResponse:
+    """Render the ReDoc documentation."""
+    return get_redoc_html(
+        openapi_url=request.app.openapi_url,
+        title=f"{request.app.title} - ReDoc",
+        redoc_favicon_url=FAVICON_URL,
+    )

test0001-0.1.0/src/shomer/routes/health.py

@@ -0,0 +1,34 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2025 Chris <goabonga@pm.me>
+
+"""Health check routes."""
+
+from fastapi import APIRouter
+from fastapi.responses import JSONResponse
+
+router = APIRouter()
+
+
+# Imported at function level to avoid circular imports
+def _get_state() -> dict[str, str]:
+    from shomer.app import state
+
+    return state
+
+
+@router.get("/liveness", include_in_schema=False)
+def liveness() -> JSONResponse:
+    """Liveness probe: is the process alive? (k8s livenessProbe / docker HEALTHCHECK)."""
+    state = _get_state()
+    if state["status"] == "shutting_down":
+        return JSONResponse({"status": state["status"]}, status_code=503)
+    return JSONResponse({"status": state["status"]}, status_code=200)
+
+
+@router.get("/readiness", include_in_schema=False)
+def readiness() -> JSONResponse:
+    """Readiness probe: is the app ready to serve traffic? (k8s readinessProbe)."""
+    state = _get_state()
+    if state["status"] != "ready":
+        return JSONResponse({"status": state["status"]}, status_code=503)
+    return JSONResponse({"status": state["status"]}, status_code=200)

test0001-0.1.0/src/shomer/routes/views.py

@@ -0,0 +1,19 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2025 Chris <goabonga@pm.me>
+
+"""HTML view routes."""
+
+from fastapi import APIRouter, Request
+from fastapi.responses import HTMLResponse
+
+from shomer import __version__
+
+router = APIRouter()
+
+
+@router.get("/", response_class=HTMLResponse, include_in_schema=False)
+def index(request: Request) -> HTMLResponse:
+    """Render the home page."""
+    from shomer.app import templates
+
+    return templates.TemplateResponse(request, "index.html", {"version": __version__})

test0001-0.1.0/src/shomer/tasks/__init__.py

@@ -0,0 +1,4 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2025 Chris <goabonga@pm.me>
+
+"""Celery tasks for the Shomer authentication service."""

test0001-0.1.0/src/shomer/templates/index.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Shomer</title>
+    <link rel="icon" href="/static/favicon.ico" type="image/x-icon">
+</head>
+<body>
+    <h1>Shomer</h1>
+    <p>OIDC/OAuth2 authentication service.</p>
+    <p>v{{ version }}</p>
+</body>
+</html>

test0001-0.1.0/src/shomer/worker.py

@@ -0,0 +1,29 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2025 Chris <goabonga@pm.me>
+
+"""Celery worker for the Shomer authentication service."""
+
+from celery import Celery
+
+from shomer.core.settings import get_settings
+
+settings = get_settings()
+
+app = Celery(
+    "shomer",
+    broker=settings.celery_broker_url,
+    backend=settings.celery_backend,
+)
+
+app.config_from_object(
+    {
+        "task_serializer": "json",
+        "result_serializer": "json",
+        "accept_content": ["json"],
+        "timezone": "UTC",
+        "enable_utc": True,
+        "beat_schedule": {},
+    }
+)
+
+app.autodiscover_tasks(["shomer.tasks"])