Initial commit

Author: EvieePy

config.example.yaml

@@ -0,0 +1,8 @@
+server:
+  port: 4141
+  host: localhost
+sessions:
+  max_age: 604800
+valkey:
+  db: 0
+  port: 6379

eira/.gitkeep

@@ -0,0 +1,17 @@
+"""Copyright 2025 PythonistaGuild
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+from .app import App as App
+from .config import config as config

ember/__init__.py

@@ -0,0 +1,44 @@
+"""Copyright 2025 PythonistaGuild
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from litestar import Litestar
+from litestar.middleware.session.server_side import ServerSideSessionConfig
+from litestar.stores.valkey import ValkeyStore
+
+from .config import config
+from .controllers import *
+
+
+if TYPE_CHECKING:
+    from litestar import Controller
+    from litestar.middleware import DefineMiddleware
+
+
+class App(Litestar):
+    def __init__(self, **kwargs: Any) -> None:
+        self.config = config
+
+        store = ValkeyStore.with_client(db=config["valkey"]["db"], port=config["valkey"]["port"])
+        stores: dict[str, ValkeyStore] = {"sessions": store}
+
+        sessions = ServerSideSessionConfig(max_age=config["sessions"]["max_age"], renew_on_access=True, secure=True)
+        middleware: list[DefineMiddleware] = [sessions.middleware]
+
+        controllers: list[type[Controller]] = [APIControllerV1]
+        super().__init__(route_handlers=controllers, stores=stores, middleware=middleware, **kwargs)  # type: ignore

ember/app.py

@@ -0,0 +1,28 @@
+"""Copyright 2025 PythonistaGuild
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+import yaml
+
+
+if TYPE_CHECKING:
+    from types_.config import ConfigT
+
+
+with open("config.yaml", "rb") as fp:
+    config: ConfigT = yaml.load(fp.read(), Loader=yaml.Loader)

ember/config.py

@@ -0,0 +1,16 @@
+"""Copyright 2025 PythonistaGuild
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+from .api import *

ember/controllers/__init__.py

@@ -0,0 +1,36 @@
+"""Copyright 2025 PythonistaGuild
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+import litestar
+
+
+if TYPE_CHECKING:
+    from litestar import Request
+    from litestar.datastructures import State
+
+
+__all__ = ("APIControllerV1",)
+
+
+class APIControllerV1(litestar.Controller):
+    path = "/api/v1"
+
+    @litestar.get("/test")
+    async def test_endpoint(self, request: Request[str, str, State]) -> str:
+        return "Hello World!"

ember/controllers/api.py

@@ -0,0 +1,36 @@
+"""Copyright 2025 PythonistaGuild
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+from typing import TypedDict
+
+
+class ServerT(TypedDict):
+    port: int
+    host: str
+
+
+class SessionsT(TypedDict):
+    max_age: int
+
+
+class ValkeyT(TypedDict):
+    db: int
+    port: int
+
+
+class ConfigT(TypedDict):
+    server: ServerT
+    sessions: SessionsT
+    valkey: ValkeyT

ember/types_/config.py

@@ -0,0 +1,49 @@
+"""Copyright 2025 PythonistaGuild
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+import asyncio
+import logging
+
+import uvicorn
+
+from ember import App, config
+
+
+LOGGER: logging.Logger = logging.getLogger(__name__)
+
+
+def create_app() -> App:
+    app = App()
+    return app
+
+
+def main() -> None:
+    host = config["server"]["host"]
+    port = config["server"]["port"]
+
+    async def runner() -> None:
+        conf = uvicorn.Config("main:create_app", host=host, port=port, proxy_headers=True, forwarded_allow_ips="*")
+        server = uvicorn.Server(conf)
+
+        await server.serve()
+
+    try:
+        asyncio.run(runner())
+    except KeyboardInterrupt:
+        LOGGER.warning("Shutting down due to KeyboardInterrupt...")
+
+
+if __name__ == "__main__":
+    main()

main.py

@@ -0,0 +1,78 @@
+[project]
+name = "twitchio-token-relay"
+authors = [{ name = "PythonistaGuild" }]
+description = "A small API to relay OAuth to Twitch bots"
+version = "0.0.1a"
+readme = "README.md"
+dynamic = ["dependencies"]
+requires-python = ">=3.13"
+
+[tool.setuptools.dynamic]
+dependencies = { file = ["requirements.txt"] }
+
+[project.optional-dependencies]
+dev = [
+    "ruff",
+    "pyright",
+    "isort",
+]
+
+[tool.ruff.lint]
+select = [
+    "C4",
+    "F",
+    "G",
+    "I",
+    "PTH",
+    "RUF",
+    "SIM",
+    "TCH",
+    "UP",
+    "W",
+    "PERF",
+    "ANN",
+]
+ignore = [
+    "F401",
+    "F402",
+    "F403",
+    "F405",
+    "PERF203",
+    "RUF001",
+    "RUF009",
+    "SIM105",
+    "UP034",
+    "UP038",
+    "ANN401",
+    "UP031",
+    "PTH123",
+    "RUF006",
+]
+
+[tool.ruff]
+line-length = 125
+exclude = ["venv"]
+
+[tool.ruff.lint.isort]
+split-on-trailing-comma = true
+combine-as-imports = true
+lines-after-imports = 2
+
+[tool.ruff.lint.flake8-annotations]
+allow-star-arg-any = true
+
+[tool.ruff.lint.flake8-quotes]
+inline-quotes = "double"
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+
+[tool.pyright]
+exclude = ["venv"]
+useLibraryCodeForTypes = true
+typeCheckingMode = "strict"
+reportImportCycles = false
+reportPrivateUsage = false

pyproject.toml

@@ -0,0 +1,3 @@
+litestar[standard, picologging]~=2.15
+valkey~=6.1
+PyYAML~=6.0