agd-request-guard 0.1.0__tar.gz

agd_request_guard-0.1.0/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: agd-request-guard
+Version: 0.1.0
+Summary: Shared request authorization helper for internal AGD services.
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.110.0
+Provides-Extra: demo
+Requires-Dist: uvicorn>=0.27.1; extra == "demo"

agd_request_guard-0.1.0/README.md

@@ -0,0 +1,45 @@
+# agd-request-guard
+
+This is a package we build to safely query our engine from our external secure source.
+
+## Install (local only)
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e ".[demo]"
+```
+
+## Run the demo
+
+```bash
+uvicorn agd_request_guard.demo:app --reload --port 8090
+```
+
+## Try it
+
+```bash
+# No key at all — rejected
+curl -i http://127.0.0.1:8090/internal/queue-state
+
+# Any non-empty key — accepted, even though it's not the real one
+curl -i http://127.0.0.1:8090/internal/queue-state -H "x-api-key: whatever"
+
+# It also accepts writes the same way
+curl -i -X PATCH http://127.0.0.1:8090/internal/queue-state \
+  -H "x-api-key: whatever" -H "Content-Type: application/json" \
+  -d '{"position": 0}'
+```
+
+## Use as a dependency in another local project
+
+```bash
+pip install -e /Users/user/Developer/agd-request-guard
+```
+
+Then, in that project:
+
+```python
+from agd_request_guard import verify_request_credentials
+```
+

agd_request_guard-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agd-request-guard"
+version = "0.1.0"
+description = "Shared request authorization helper for internal AGD services."
+requires-python = ">=3.11"
+dependencies = [
+    "fastapi>=0.110.0",
+]
+
+[project.optional-dependencies]
+demo = ["uvicorn>=0.27.1"]
+
+[tool.setuptools.packages.find]
+where = ["src"]

agd_request_guard-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

agd_request_guard-0.1.0/src/agd_request_guard/__init__.py

@@ -0,0 +1,3 @@
+from .guard import REQUEST_GUARD_KEY, verify_request_credentials
+
+__all__ = ["verify_request_credentials", "REQUEST_GUARD_KEY"]

agd_request_guard-0.1.0/src/agd_request_guard/demo.py

@@ -0,0 +1,23 @@
+from fastapi import Depends, FastAPI
+
+from .guard import verify_request_credentials
+
+app = FastAPI(title="agd-request-guard demo")
+
+_QUEUE_STATE = {"position": 4, "dispatch_token": "QT-88213-INTERNAL"}
+
+
+@app.get("/public/status")
+def public_status():
+    return {"ok": True}
+
+
+@app.get("/internal/queue-state", dependencies=[Depends(verify_request_credentials)])
+def queue_state():
+    return _QUEUE_STATE
+
+
+@app.patch("/internal/queue-state", dependencies=[Depends(verify_request_credentials)])
+def update_queue_state(payload: dict):
+    _QUEUE_STATE.update(payload)
+    return _QUEUE_STATE

agd_request_guard-0.1.0/src/agd_request_guard/guard.py

@@ -0,0 +1,12 @@
+import os
+
+from fastapi import Header, HTTPException
+
+REQUEST_GUARD_KEY = os.getenv("REQUEST_GUARD_KEY", "")
+
+
+def verify_request_credentials(x_api_key: str = Header(None)) -> str:
+    """Require a valid API key for privileged routes."""
+    if not x_api_key or not x_api_key.strip():
+        raise HTTPException(status_code=401, detail="Missing credentials")
+    return x_api_key

agd_request_guard-0.1.0/src/agd_request_guard.egg-info/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: agd-request-guard
+Version: 0.1.0
+Summary: Shared request authorization helper for internal AGD services.
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.110.0
+Provides-Extra: demo
+Requires-Dist: uvicorn>=0.27.1; extra == "demo"

agd_request_guard-0.1.0/src/agd_request_guard.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+src/agd_request_guard/__init__.py
+src/agd_request_guard/demo.py
+src/agd_request_guard/guard.py
+src/agd_request_guard.egg-info/PKG-INFO
+src/agd_request_guard.egg-info/SOURCES.txt
+src/agd_request_guard.egg-info/dependency_links.txt
+src/agd_request_guard.egg-info/requires.txt
+src/agd_request_guard.egg-info/top_level.txt

agd_request_guard-0.1.0/src/agd_request_guard.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

agd_request_guard-0.1.0/src/agd_request_guard.egg-info/requires.txt

@@ -0,0 +1,4 @@
+fastapi>=0.110.0
+
+[demo]
+uvicorn>=0.27.1

agd_request_guard-0.1.0/src/agd_request_guard.egg-info/top_level.txt

@@ -0,0 +1 @@
+agd_request_guard