goatseo-fastapi 0.1.0__py3-none-any.whl

goatseo/fastapi/__init__.py

@@ -0,0 +1,6 @@
+"""FastAPI integration for GoatSEO."""
+
+from goatseo.fastapi.integration import GoatSEO, goatseo_head, request_context
+from goatseo.seo import SEO
+
+__all__ = ["SEO", "GoatSEO", "goatseo_head", "request_context"]

goatseo/fastapi/integration.py

@@ -0,0 +1,35 @@
+"""FastAPI integration built on dependency injection and Jinja2 templates."""
+
+from starlette.requests import Request
+from starlette.templating import Jinja2Templates
+
+from goatseo.core import Metadata, SafeHtml, StaticRequestContext
+from goatseo.seo import SEO
+
+
+def request_context(request: Request) -> StaticRequestContext:
+    return StaticRequestContext(str(request.url))
+
+
+def goatseo_head(seo: SEO, request: Request) -> SafeHtml:
+    return seo.render(request_context(request))
+
+
+class GoatSEO:
+    """A dependency that gives each request a fresh :class:`SEO` built from site defaults.
+
+    ``SEODep = Annotated[SEO, Depends(GoatSEO(defaults=...))]``; FastAPI caches it per request.
+    """
+
+    __slots__ = ("defaults",)
+
+    def __init__(self, defaults: Metadata | None = None) -> None:
+        self.defaults = defaults
+
+    def __call__(self) -> SEO:
+        return SEO(defaults=self.defaults)
+
+    def install(self, templates: Jinja2Templates) -> None:
+        """Exposes ``{{ goatseo_head(seo, request) }}`` to the templates."""
+        # Jinja infers Environment.globals from its default entries, which rejects any callable.
+        templates.env.globals["goatseo_head"] = goatseo_head  # pyright: ignore[reportArgumentType]

goatseo_fastapi-0.1.0.dist-info/METADATA

@@ -0,0 +1,42 @@
+Metadata-Version: 2.4
+Name: goatseo-fastapi
+Version: 0.1.0
+Summary: FastAPI integration for GoatSEO.
+Keywords: seo,schema.org,json-ld,opengraph,twitter-cards,metadata
+Author: Louis Midson LAJEANTY
+Author-email: Louis Midson LAJEANTY <midsonlajeanty@proton.me>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Framework :: FastAPI
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Typing :: Typed
+Requires-Dist: goatseo-seo==0.1.0
+Requires-Dist: fastapi>=0.115
+Requires-Python: >=3.14
+Project-URL: Homepage, https://github.com/goatlabshq/goatseo
+Project-URL: Documentation, https://goatlabshq.github.io/goatseo/
+Project-URL: Issues, https://github.com/goatlabshq/goatseo/issues
+Description-Content-Type: text/markdown
+
+# goatseo-fastapi
+
+FastAPI integration for GoatSEO: a per-request `SEO` dependency and a Jinja2 `goatseo_head` helper.
+
+```bash
+pip install "goatseo[fastapi]"
+```
+
+```python
+from typing import Annotated
+from fastapi import Depends
+from goatseo.fastapi import SEO, GoatSEO
+
+SEODep = Annotated[SEO, Depends(GoatSEO())]
+```
+
+Part of [GoatSEO](https://github.com/goatlabshq/goatseo). See the [documentation](https://goatlabshq.github.io/goatseo/).

goatseo_fastapi-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+goatseo/fastapi/__init__.py,sha256=sFdsI0RapcQSXbM89wOKofMit1xnS7JylGsp0KVTyVI,212
+goatseo/fastapi/integration.py,sha256=QCIzkCzZAv6FfwxRXIOUmEC9Vprd4IGpfNQICPB5goQ,1238
+goatseo/fastapi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+goatseo_fastapi-0.1.0.dist-info/licenses/LICENSE,sha256=Zcs5rp01UDASfBq28ErEU7tdk14P5WTR3zNmlaZKnkA,1105
+goatseo_fastapi-0.1.0.dist-info/WHEEL,sha256=oBPtwmRtX9fzUVIGqTf2NA4uW8MUj4N1HrmGwtPkDyA,80
+goatseo_fastapi-0.1.0.dist-info/METADATA,sha256=KyyZeocyvJNPqbMOkL6y72No2s_iq7y2rEHr6bLNkeA,1432
+goatseo_fastapi-0.1.0.dist-info/RECORD,,

goatseo_fastapi-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.13.2
+Root-Is-Purelib: true
+Tag: py3-none-any

goatseo_fastapi-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Louis Midson LAJEANTY <midsonlajeanty@proton.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.