swastik-codes 0.1.0__tar.gz

swastik_codes-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+/target
+**/target
+node_modules/
+dist/
+.env
+.env.*
+!.env.example
+*.log
+.DS_Store
+apps/desktop/src-tauri/gen/
+/target-*
+/deploy/downloads/

swastik_codes-0.1.0/LICENSE.md

@@ -0,0 +1,27 @@
+# Swastik Codes licence
+
+Copyright © 2026 Shwastik Tech Solutions Pvt Ltd. All rights reserved.
+
+Swastik Codes Docs (the `@swastik-codes/docs` npm package and the
+`swastik-codes` Python package) is proprietary software of Shwastik Tech
+Solutions Pvt Ltd. It is not open source.
+
+You may install it, free of charge, and use it to publish documentation and a
+request collection for your own APIs, in development and in production, under
+the Terms of service at https://swastik.codes/terms/ (section 7, "Our
+intellectual property", in particular).
+
+The pages it serves show the Swastik Codes name and logo and a "Run in Swastik
+Codes" button. You may not remove, hide, cover or change them, or make the
+pages appear to be made by anyone else.
+
+You may not copy, modify, decompile, disassemble, reverse engineer, resell,
+sublicense or redistribute the software or any part of it, except where the
+law allows it despite this restriction. Installing it through a package
+registry (npm, PyPI) or a company mirror of one, and bundling it unchanged in
+your application, is not redistribution.
+
+The software is provided "as is", without warranty of any kind, to the extent
+the law allows.
+
+Questions: https://swastik.codes/contact/

swastik_codes-0.1.0/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.5
+Name: swastik-codes
+Version: 0.1.0
+Summary: API documentation and a request collection for FastAPI, Starlette, Flask, Django and any ASGI/WSGI app, from your OpenAPI document. No dependencies.
+Project-URL: Homepage, https://swastik.codes/
+Project-URL: Support, https://swastik.codes/contact/
+Author: Shwastik Tech Solutions Pvt Ltd
+License: # Swastik Codes licence
+        
+        Copyright © 2026 Shwastik Tech Solutions Pvt Ltd. All rights reserved.
+        
+        Swastik Codes Docs (the `@swastik-codes/docs` npm package and the
+        `swastik-codes` Python package) is proprietary software of Shwastik Tech
+        Solutions Pvt Ltd. It is not open source.
+        
+        You may install it, free of charge, and use it to publish documentation and a
+        request collection for your own APIs, in development and in production, under
+        the Terms of service at https://swastik.codes/terms/ (section 7, "Our
+        intellectual property", in particular).
+        
+        The pages it serves show the Swastik Codes name and logo and a "Run in Swastik
+        Codes" button. You may not remove, hide, cover or change them, or make the
+        pages appear to be made by anyone else.
+        
+        You may not copy, modify, decompile, disassemble, reverse engineer, resell,
+        sublicense or redistribute the software or any part of it, except where the
+        law allows it despite this restriction. Installing it through a package
+        registry (npm, PyPI) or a company mirror of one, and bundling it unchanged in
+        your application, is not redistribution.
+        
+        The software is provided "as is", without warranty of any kind, to the extent
+        the law allows.
+        
+        Questions: https://swastik.codes/contact/
+License-File: LICENSE.md
+Keywords: api-docs,django,documentation,fastapi,flask,openapi,starlette,swagger,swagger-ui,swastik-codes
+Classifier: Framework :: Django
+Classifier: Framework :: FastAPI
+Classifier: Framework :: Flask
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Middleware
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# Swastik Codes Docs for Python
+
+API documentation and a request collection for your Python web app, built from
+the OpenAPI document you already have. Install it, add one line, and you get two
+pages:
+
+| URL | What it is |
+| --- | --- |
+| `/swc/docs` | Full documentation: introduction, authentication, every request with its parameters, body, responses, code samples (cURL, JavaScript, Python, Go, PHP) and example responses. Search, deep links, light and dark themes. |
+| `/swc/collection` | Every request in a collection tree. Fill in params, auth, headers and body, press **Send**, and read the response (pretty JSON, headers, status, time, size). |
+| `/swc/openapi.json` | The document both pages read, with your edits applied. |
+
+Both pages have a **Run in Swastik Codes** button that opens the API in
+[Swastik Codes](https://swastik.codes) as a collection.
+
+- **No dependencies.** Standard library only.
+- **Small.** The whole UI is one script and one stylesheet, about 22 KB over the wire, precompressed (brotli and gzip) and cached for a year.
+- **Cheap to serve.** The merged document is built once and cached until your spec or config changes. Spec responses carry an ETag, so repeat visits get `304`.
+
+## FastAPI
+
+```bash
+pip install swastik-codes
+```
+
+```python
+from fastapi import FastAPI
+from swastik_codes import mount
+
+app = FastAPI(title="My API")
+
+# ... your routes ...
+
+mount(app, config="swastik-codes.json")   # /swc/docs and /swc/collection
+```
+
+`mount()` reads FastAPI's own cached `app.openapi()`. FastAPI's `/docs` and
+`/redoc` keep working. Turn them off with `FastAPI(docs_url=None, redoc_url=None)`
+if you only want these pages. To serve them at `/docs` instead, use
+`mount(app, prefix="")` together with `docs_url=None`.
+
+Starlette works the same way. Pass `spec=` with your document, because Starlette has no `app.openapi()`.
+
+## Flask
+
+Flask has no OpenAPI generator of its own. Pass the document from the library you use (flask-smorest, apispec, flasgger) or a dict:
+
+```python
+from swastik_codes import init_flask
+
+init_flask(app, spec=lambda: api.spec.to_dict(), config="swastik-codes.json")
+```
+
+## Django
+
+Use the document from drf-spectacular (or any generator). Cache it so it is built once:
+
+```python
+# urls.py (root)
+import functools
+from drf_spectacular.generators import SchemaGenerator
+from swastik_codes import django_urls
+
+spec = functools.cache(lambda: SchemaGenerator().get_schema(request=None, public=True))
+urlpatterns += django_urls(spec=spec, config="swastik-codes.json")
+```
+
+## Any ASGI or WSGI app
+
+```python
+from swastik_codes import SwastikCodesMiddleware, SwastikCodesWSGI
+
+app = SwastikCodesMiddleware(app, spec=my_openapi_dict)        # ASGI: Litestar, Quart, ...
+wsgi_app = SwastikCodesWSGI(wsgi_app, spec=my_openapi_dict)    # WSGI: Bottle, Pyramid, ...
+```
+
+`spec` is always a dict or a function that returns one. A function is called on
+each page load, so it should be cheap or cached. The merge is only redone when it
+returns a different object.
+
+## Editing the pages: swastik-codes.json
+
+```bash
+python -m swastik_codes init      # writes a starter swastik-codes.json
+```
+
+Every field is optional. Your OpenAPI document provides the rest. The file is
+re-read when it changes, so you can edit it and reload the page.
+
+```json
+{
+  "title": "Flight OTA API",
+  "version": "2.0",
+  "description": "Markdown introduction.\n\n## Getting started\n\n1. Get a token.\n2. Send it as a bearer token.",
+  "servers": [
+    { "url": "https://sandbox.example.com", "description": "Sandbox" },
+    { "url": "https://api.example.com", "description": "Production" }
+  ],
+  "theme": { "accent": "#0d9488", "mode": "system" },
+  "tags": { "Search": { "name": "Flight search", "description": "Find flights." } },
+  "groups": [
+    { "name": "Start here", "tags": ["Authentication"] },
+    { "name": "Flights", "tags": ["Search", "Bookings"] }
+  ],
+  "operations": {
+    "GET /v2/bookings/{booking_id}": { "summary": "Read a held booking", "description": "Markdown." },
+    "deleteCache": { "hidden": true }
+  },
+  "hide": ["/internal/*", "DELETE /admin/*"],
+  "pages": [{ "title": "Errors", "body": "Markdown, tables included." }],
+  "links": [{ "label": "Support", "url": "https://example.com/support" }],
+  "languages": ["curl", "javascript", "python", "go", "php"]
+}
+```
+
+| Field | Effect |
+| --- | --- |
+| `title`, `version`, `description` | Replace `info.*`. The description is Markdown. |
+| `servers` | Base URLs readers pick from (the first is the default). Readers can also enter their own. |
+| `theme` | Accent colour, and the default theme (`system`, `light` or `dark`). |
+| `tags` | Display name and description per tag (each tag is a folder). |
+| `groups` | Sections that hold tags, in order. |
+| `operations` | Per request, keyed by `"METHOD /path"` or `operationId`: `summary`, `description`, `tags`, `deprecated`, `hidden`. |
+| `hide` | Paths to leave out. `*` matches anything. Prefix with a method to hide only that method. |
+| `pages` | Extra Markdown pages under Introduction. |
+| `links` | Links on the introduction. |
+| `languages` | Code sample languages and their order. |
+
+The Swastik Codes logo, the "Built with Swastik Codes" credit and the **Run in
+Swastik Codes** button are part of the pages. They have no setting. Keys such as
+`logo` or `hideRunButton` are ignored with a warning.
+
+## Notes
+
+- **Sending requests.** The collection page sends requests from the browser.
+  Requests to the same server always work. Requests to another server need that
+  server to allow CORS for your docs origin, the same as Swagger UI.
+- **Credentials.** Tokens you enter are kept in the tab's session storage. They
+  are never sent anywhere except with your requests.
+- **Security headers.** The pages are sent with a strict Content-Security-Policy:
+  no inline scripts, and scripts and styles from this server only. Pass
+  `csp=False` to turn it off.
+- **Run in Swastik Codes** opens `https://swastik.codes/app?import=<your openapi.json>`.
+  For an API on `localhost` it offers the file to download instead, because a
+  website can't reach your computer.
+
+## Licence
+
+Proprietary, free to use. See [LICENSE.md](LICENSE.md). © Shwastik Tech Solutions Pvt Ltd.

swastik_codes-0.1.0/README.md

@@ -0,0 +1,149 @@
+# Swastik Codes Docs for Python
+
+API documentation and a request collection for your Python web app, built from
+the OpenAPI document you already have. Install it, add one line, and you get two
+pages:
+
+| URL | What it is |
+| --- | --- |
+| `/swc/docs` | Full documentation: introduction, authentication, every request with its parameters, body, responses, code samples (cURL, JavaScript, Python, Go, PHP) and example responses. Search, deep links, light and dark themes. |
+| `/swc/collection` | Every request in a collection tree. Fill in params, auth, headers and body, press **Send**, and read the response (pretty JSON, headers, status, time, size). |
+| `/swc/openapi.json` | The document both pages read, with your edits applied. |
+
+Both pages have a **Run in Swastik Codes** button that opens the API in
+[Swastik Codes](https://swastik.codes) as a collection.
+
+- **No dependencies.** Standard library only.
+- **Small.** The whole UI is one script and one stylesheet, about 22 KB over the wire, precompressed (brotli and gzip) and cached for a year.
+- **Cheap to serve.** The merged document is built once and cached until your spec or config changes. Spec responses carry an ETag, so repeat visits get `304`.
+
+## FastAPI
+
+```bash
+pip install swastik-codes
+```
+
+```python
+from fastapi import FastAPI
+from swastik_codes import mount
+
+app = FastAPI(title="My API")
+
+# ... your routes ...
+
+mount(app, config="swastik-codes.json")   # /swc/docs and /swc/collection
+```
+
+`mount()` reads FastAPI's own cached `app.openapi()`. FastAPI's `/docs` and
+`/redoc` keep working. Turn them off with `FastAPI(docs_url=None, redoc_url=None)`
+if you only want these pages. To serve them at `/docs` instead, use
+`mount(app, prefix="")` together with `docs_url=None`.
+
+Starlette works the same way. Pass `spec=` with your document, because Starlette has no `app.openapi()`.
+
+## Flask
+
+Flask has no OpenAPI generator of its own. Pass the document from the library you use (flask-smorest, apispec, flasgger) or a dict:
+
+```python
+from swastik_codes import init_flask
+
+init_flask(app, spec=lambda: api.spec.to_dict(), config="swastik-codes.json")
+```
+
+## Django
+
+Use the document from drf-spectacular (or any generator). Cache it so it is built once:
+
+```python
+# urls.py (root)
+import functools
+from drf_spectacular.generators import SchemaGenerator
+from swastik_codes import django_urls
+
+spec = functools.cache(lambda: SchemaGenerator().get_schema(request=None, public=True))
+urlpatterns += django_urls(spec=spec, config="swastik-codes.json")
+```
+
+## Any ASGI or WSGI app
+
+```python
+from swastik_codes import SwastikCodesMiddleware, SwastikCodesWSGI
+
+app = SwastikCodesMiddleware(app, spec=my_openapi_dict)        # ASGI: Litestar, Quart, ...
+wsgi_app = SwastikCodesWSGI(wsgi_app, spec=my_openapi_dict)    # WSGI: Bottle, Pyramid, ...
+```
+
+`spec` is always a dict or a function that returns one. A function is called on
+each page load, so it should be cheap or cached. The merge is only redone when it
+returns a different object.
+
+## Editing the pages: swastik-codes.json
+
+```bash
+python -m swastik_codes init      # writes a starter swastik-codes.json
+```
+
+Every field is optional. Your OpenAPI document provides the rest. The file is
+re-read when it changes, so you can edit it and reload the page.
+
+```json
+{
+  "title": "Flight OTA API",
+  "version": "2.0",
+  "description": "Markdown introduction.\n\n## Getting started\n\n1. Get a token.\n2. Send it as a bearer token.",
+  "servers": [
+    { "url": "https://sandbox.example.com", "description": "Sandbox" },
+    { "url": "https://api.example.com", "description": "Production" }
+  ],
+  "theme": { "accent": "#0d9488", "mode": "system" },
+  "tags": { "Search": { "name": "Flight search", "description": "Find flights." } },
+  "groups": [
+    { "name": "Start here", "tags": ["Authentication"] },
+    { "name": "Flights", "tags": ["Search", "Bookings"] }
+  ],
+  "operations": {
+    "GET /v2/bookings/{booking_id}": { "summary": "Read a held booking", "description": "Markdown." },
+    "deleteCache": { "hidden": true }
+  },
+  "hide": ["/internal/*", "DELETE /admin/*"],
+  "pages": [{ "title": "Errors", "body": "Markdown, tables included." }],
+  "links": [{ "label": "Support", "url": "https://example.com/support" }],
+  "languages": ["curl", "javascript", "python", "go", "php"]
+}
+```
+
+| Field | Effect |
+| --- | --- |
+| `title`, `version`, `description` | Replace `info.*`. The description is Markdown. |
+| `servers` | Base URLs readers pick from (the first is the default). Readers can also enter their own. |
+| `theme` | Accent colour, and the default theme (`system`, `light` or `dark`). |
+| `tags` | Display name and description per tag (each tag is a folder). |
+| `groups` | Sections that hold tags, in order. |
+| `operations` | Per request, keyed by `"METHOD /path"` or `operationId`: `summary`, `description`, `tags`, `deprecated`, `hidden`. |
+| `hide` | Paths to leave out. `*` matches anything. Prefix with a method to hide only that method. |
+| `pages` | Extra Markdown pages under Introduction. |
+| `links` | Links on the introduction. |
+| `languages` | Code sample languages and their order. |
+
+The Swastik Codes logo, the "Built with Swastik Codes" credit and the **Run in
+Swastik Codes** button are part of the pages. They have no setting. Keys such as
+`logo` or `hideRunButton` are ignored with a warning.
+
+## Notes
+
+- **Sending requests.** The collection page sends requests from the browser.
+  Requests to the same server always work. Requests to another server need that
+  server to allow CORS for your docs origin, the same as Swagger UI.
+- **Credentials.** Tokens you enter are kept in the tab's session storage. They
+  are never sent anywhere except with your requests.
+- **Security headers.** The pages are sent with a strict Content-Security-Policy:
+  no inline scripts, and scripts and styles from this server only. Pass
+  `csp=False` to turn it off.
+- **Run in Swastik Codes** opens `https://swastik.codes/app?import=<your openapi.json>`.
+  For an API on `localhost` it offers the file to download instead, because a
+  website can't reach your computer.
+
+## Licence
+
+Proprietary, free to use. See [LICENSE.md](LICENSE.md). © Shwastik Tech Solutions Pvt Ltd.

swastik_codes-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["hatchling>=1.21"]
+build-backend = "hatchling.build"
+
+[project]
+name = "swastik-codes"
+version = "0.1.0"
+description = "API documentation and a request collection for FastAPI, Starlette, Flask, Django and any ASGI/WSGI app, from your OpenAPI document. No dependencies."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { file = "LICENSE.md" }
+authors = [{ name = "Shwastik Tech Solutions Pvt Ltd" }]
+keywords = ["openapi", "swagger", "swagger-ui", "api-docs", "fastapi", "flask", "django", "starlette", "documentation", "swastik-codes"]
+classifiers = [
+  "Framework :: FastAPI",
+  "Framework :: Flask",
+  "Framework :: Django",
+  "Programming Language :: Python :: 3",
+  "License :: Other/Proprietary License",
+  "Topic :: Software Development :: Documentation",
+  "Topic :: Internet :: WWW/HTTP :: WSGI :: Middleware",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://swastik.codes/"
+Support = "https://swastik.codes/contact/"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/swastik_codes"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/swastik_codes", "README.md", "LICENSE.md"]

swastik_codes-0.1.0/src/swastik_codes/__init__.py

@@ -0,0 +1,28 @@
+"""Swastik Codes docs: API documentation and a request collection for Python web apps.
+
+FastAPI::
+
+    from fastapi import FastAPI
+    from swastik_codes import mount
+
+    app = FastAPI()
+    mount(app, config="swastik-codes.json")   # /swc/docs and /swc/collection
+
+Flask, Django and any ASGI/WSGI app: see README.
+"""
+
+from .adapters import SwastikCodesMiddleware, SwastikCodesWSGI, django_urls, init_flask, mount
+from .core import Docs, Response, SwastikCodesWarning, merge_spec
+
+__all__ = [
+    "Docs",
+    "Response",
+    "SwastikCodesMiddleware",
+    "SwastikCodesWSGI",
+    "SwastikCodesWarning",
+    "django_urls",
+    "init_flask",
+    "merge_spec",
+    "mount",
+]
+__version__ = "0.1.0"

swastik_codes-0.1.0/src/swastik_codes/__main__.py

@@ -0,0 +1,33 @@
+"""python -m swastik_codes init [swastik-codes.json] — writes a starter configuration."""
+
+import json
+import sys
+from pathlib import Path
+
+STARTER = {
+    "theme": {"accent": "#0d9488", "mode": "system"},
+    "tags": {},
+    "groups": [],
+    "operations": {},
+    "hide": [],
+    "pages": [],
+    "links": [],
+    "languages": ["curl", "javascript", "python", "go"],
+}
+
+
+def main(argv: list) -> int:
+    if not argv or argv[0] != "init":
+        print("Usage: python -m swastik_codes init [swastik-codes.json]\n\nWrites a starter configuration for the docs and collection pages.")
+        return 1 if argv else 0
+    target = Path(argv[1] if len(argv) > 1 else "swastik-codes.json")
+    if target.exists():
+        print(f"{target} already exists: nothing written.", file=sys.stderr)
+        return 1
+    target.write_text(json.dumps(STARTER, indent=2) + "\n", "utf-8")
+    print(f'Wrote {target}. Pass it as config="{target}" and edit it: the pages pick up changes on the next reload.')
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main(sys.argv[1:]))

swastik_codes-0.1.0/src/swastik_codes/adapters.py

@@ -0,0 +1,169 @@
+"""Adapters: FastAPI / Starlette, any ASGI app, any WSGI app, Flask and Django."""
+
+from __future__ import annotations
+
+from typing import Any, Callable, Iterable, List, Optional
+
+from .core import DEFAULT_PREFIX, Config, Docs, Response, SpecSource
+
+
+def _route_path(scope: dict) -> str:
+    path = scope.get("path") or "/"
+    root = scope.get("root_path") or ""
+    # Newer servers keep root_path inside path; older ones strip it.
+    if root and path.startswith(root):
+        path = path[len(root):] or "/"
+    return path
+
+
+def _asgi_headers(scope: dict) -> dict:
+    return {k.decode("latin-1").lower(): v.decode("latin-1") for k, v in scope.get("headers") or []}
+
+
+async def _asgi_send(send: Callable, r: Response) -> None:
+    await send({"type": "http.response.start", "status": r.status, "headers": [(k.encode("latin-1"), v.encode("latin-1")) for k, v in r.headers]})
+    await send({"type": "http.response.body", "body": r.body})
+
+
+# ---- ASGI ----------------------------------------------------------------------
+
+
+class SwastikCodesMiddleware:
+    """ASGI middleware for any ASGI app (FastAPI, Starlette, Litestar, Quart, Django ASGI…).
+
+    app = SwastikCodesMiddleware(app, spec=..., config="swastik-codes.json")
+    """
+
+    def __init__(self, app: Any, spec: SpecSource, config: Config = None, prefix: str = DEFAULT_PREFIX, csp: bool = True):
+        self.app = app
+        self.docs = Docs(spec, config=config, prefix=prefix, csp=csp)
+
+    async def __call__(self, scope: dict, receive: Callable, send: Callable) -> None:
+        if scope.get("type") == "http":
+            path = _route_path(scope)
+            if path == self.docs.prefix or path.startswith(self.docs.prefix + "/") or self.docs.prefix == "":
+                r = self.docs.handle(scope.get("method", "GET"), path, _asgi_headers(scope), scope.get("path"))
+                if r is not None:
+                    await _asgi_send(send, r)
+                    return
+        await self.app(scope, receive, send)
+
+
+def mount(app: Any, prefix: str = DEFAULT_PREFIX, config: Config = None, spec: Optional[SpecSource] = None, csp: bool = True) -> Docs:
+    """Add the pages to a FastAPI (or Starlette) app.
+
+    from swastik_codes import mount
+    mount(app, config="swastik-codes.json")   # → /swc/docs and /swc/collection
+
+    ``spec`` defaults to ``app.openapi`` (FastAPI's own cached document).
+    """
+    if spec is None:
+        if not callable(getattr(app, "openapi", None)):
+            raise TypeError("swastik_codes.mount: this app has no .openapi(); pass spec=<your OpenAPI dict or a function>")
+        spec = app.openapi
+    docs = Docs(spec, config=config, prefix=prefix, csp=csp)
+
+    class Endpoint:  # Starlette calls an object (not a function) as a raw ASGI app
+        async def __call__(self, scope: dict, receive: Callable, send: Callable) -> None:
+            r = docs.handle(scope.get("method", "GET"), _route_path(scope), _asgi_headers(scope), scope.get("path"))
+            if r is None:
+                r = Response(404, [("content-type", "text/plain")], b"Not found")
+            await _asgi_send(send, r)
+
+    endpoint = Endpoint()
+
+    from starlette.routing import Route  # FastAPI and Starlette ship it
+
+    # Raw ASGI endpoints (no Request object), placed ahead of any catch-all routes the app has.
+    paths = [docs.prefix, docs.prefix + "/{rest:path}"] if docs.prefix else ["/docs", "/docs/", "/collection", "/collection/", "/openapi.json", "/_swc/{rest:path}"]
+    for i, p in enumerate(paths):
+        app.router.routes.insert(i, Route(p, endpoint, methods=["GET", "HEAD", "OPTIONS"], include_in_schema=False))
+    return docs
+
+
+# ---- WSGI ----------------------------------------------------------------------
+
+
+class SwastikCodesWSGI:
+    """WSGI middleware: app.wsgi_app = SwastikCodesWSGI(app.wsgi_app, spec=...)."""
+
+    def __init__(self, app: Callable, spec: SpecSource, config: Config = None, prefix: str = DEFAULT_PREFIX, csp: bool = True):
+        self.app = app
+        self.docs = Docs(spec, config=config, prefix=prefix, csp=csp)
+
+    def __call__(self, environ: dict, start_response: Callable) -> Iterable[bytes]:
+        path = environ.get("PATH_INFO") or "/"
+        r = self.docs.handle(environ.get("REQUEST_METHOD", "GET"), path, _wsgi_headers(environ), (environ.get("SCRIPT_NAME") or "") + path)
+        if r is None:
+            return self.app(environ, start_response)
+        start_response(f"{r.status} {_REASONS.get(r.status, 'OK')}", r.headers)
+        return [r.body]
+
+
+_REASONS = {200: "OK", 204: "No Content", 301: "Moved Permanently", 302: "Found", 304: "Not Modified", 404: "Not Found"}
+
+
+def _wsgi_headers(environ: dict) -> dict:
+    out = {k[5:].replace("_", "-").lower(): v for k, v in environ.items() if k.startswith("HTTP_")}
+    return out
+
+
+# ---- Flask ---------------------------------------------------------------------
+
+
+def init_flask(app: Any, spec: SpecSource, config: Config = None, prefix: str = DEFAULT_PREFIX, csp: bool = True) -> Docs:
+    """Add the pages to a Flask app.
+
+    from swastik_codes import init_flask
+    init_flask(app, spec=lambda: api.spec.to_dict(), config="swastik-codes.json")
+    """
+    from flask import Response as FlaskResponse, request
+
+    docs = Docs(spec, config=config, prefix=prefix, csp=csp)
+
+    def view(rest: str = "") -> Any:
+        r = docs.handle(request.method, request.path, {k.lower(): v for k, v in request.headers.items()}, request.full_path if request.query_string else request.path)
+        if r is None:
+            return FlaskResponse("Not found", status=404, mimetype="text/plain")
+        resp = FlaskResponse(r.body, status=r.status)
+        resp.headers.clear()
+        for k, v in r.headers:
+            resp.headers[k] = v
+        resp.direct_passthrough = True
+        return resp
+
+    opts = {"methods": ["GET", "HEAD", "OPTIONS"], "provide_automatic_options": False, "strict_slashes": False}
+    if docs.prefix:
+        app.add_url_rule(docs.prefix, "swastik_codes_root", view, **opts)
+    app.add_url_rule(f"{docs.prefix}/<path:rest>", "swastik_codes", view, **opts)
+    return docs
+
+
+# ---- Django --------------------------------------------------------------------
+
+
+def django_urls(spec: SpecSource, config: Config = None, prefix: str = DEFAULT_PREFIX, csp: bool = True) -> List[Any]:
+    """URL patterns for Django: ``urlpatterns += django_urls(spec=...)``.
+
+    Use them in the ROOT urls.py (the prefix is matched against the full path).
+    """
+    import re
+
+    from django.http import HttpResponse
+    from django.urls import re_path
+    from django.views.decorators.csrf import csrf_exempt
+
+    docs = Docs(spec, config=config, prefix=prefix, csp=csp)
+
+    @csrf_exempt
+    def view(request: Any, rest: str = "") -> Any:
+        r = docs.handle(request.method, request.path_info, {k.lower(): v for k, v in request.headers.items()}, request.path)
+        if r is None:
+            return HttpResponse("Not found", status=404, content_type="text/plain")
+        resp = HttpResponse(r.body, status=r.status)
+        for k, v in r.headers:
+            resp[k] = v
+        return resp
+
+    p = re.escape(docs.prefix.lstrip("/"))
+    return [re_path(rf"^{p}(?:/(?P<rest>.*))?$" if p else r"^(?P<rest>docs/?|collection/?|openapi\.json|_swc/[^/]+)$", view, name="swastik_codes")]

swastik_codes-0.1.0/src/swastik_codes/assets/logo.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><defs><linearGradient id="swc-g" x1="4" y1="2" x2="28" y2="30" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#34d399"/><stop offset=".55" stop-color="#0d9488"/><stop offset="1" stop-color="#0e7490"/></linearGradient></defs><rect width="32" height="32" rx="8.5" fill="url(#swc-g)"/><path d="M21.6 9H13.8a3.5 3.5 0 0 0 0 7h2.5" fill="none" stroke="#fff" stroke-width="3.2" stroke-linejoin="round"/><path d="M16 16h2.2a3.5 3.5 0 0 1 0 7h-7.8" fill="none" stroke="#a7f3d0" stroke-width="3.2" stroke-linejoin="round"/><circle cx="21.8" cy="9" r="2.35" fill="#fff"/><circle cx="10.2" cy="23" r="2.35" fill="#a7f3d0"/></svg>

swastik_codes-0.1.0/src/swastik_codes/assets/manifest.json

@@ -0,0 +1,6 @@
+{
+  "version": "0.1.0",
+  "js": "swc-docs.a102eaf1ec.js",
+  "css": "swc-docs.6b428a9eb2.css",
+  "logo": "logo.svg"
+}