devpi-admin 1.0.0__py3-none-any.whl

devpi_admin/__init__.py

@@ -0,0 +1,4 @@
+try:
+    from devpi_admin._version import __version__
+except ImportError:
+    __version__ = "0.0.0"

devpi_admin/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '1.0.0'
+__version_tuple__ = version_tuple = (1, 0, 0)
+
+__commit_id__ = commit_id = None

devpi_admin/main.py

@@ -0,0 +1,70 @@
+"""devpi-admin: web UI plugin for devpi-server.
+
+Installs a single-page application that replaces devpi-web. The SPA is served
+under ``/+admin/`` and browser requests to ``/`` are redirected there. All
+existing devpi REST API endpoints are left untouched — the JS app talks to
+the standard devpi JSON API (``/+login``, ``/<user>/<index>``, ...).
+"""
+from pathlib import Path
+
+from pyramid.httpexceptions import HTTPFound
+from pyramid.response import FileResponse
+
+
+STATIC_DIR = Path(__file__).parent / "static"
+
+
+def devpiserver_get_features():
+    # Advertise the plugin to devpi-server
+    return {"devpi-admin"}
+
+
+def devpiserver_pyramid_configure(config, pyramid_config):
+    # Serve bundled static assets (index.html, css/, js/) under /+admin/.
+    pyramid_config.add_static_view(
+        name="+admin", path="devpi_admin:static")
+
+    # Serve index.html on /+admin/ (with trailing slash). add_static_view
+    # does not auto-resolve directory index files.
+    pyramid_config.add_route("devpi_admin_spa", "/+admin/")
+    pyramid_config.add_view(_serve_index, route_name="devpi_admin_spa")
+
+    # Bare /+admin (no slash) → redirect so relative asset URLs resolve.
+    pyramid_config.add_route("devpi_admin_spa_noslash", "/+admin")
+    pyramid_config.add_view(
+        lambda request: HTTPFound("/+admin/"),
+        route_name="devpi_admin_spa_noslash")
+
+    # Redirect browser visits to "/" to the SPA. Other routes (JSON API
+    # calls, CLI requests) pass through untouched because they send
+    # Accept: application/json.
+    pyramid_config.add_tween(
+        "devpi_admin.main.devpi_admin_tween_factory")
+
+
+def _serve_index(request):
+    return FileResponse(
+        str(STATIC_DIR / "index.html"),
+        request=request,
+        content_type="text/html")
+
+
+def devpi_admin_tween_factory(handler, registry):
+    def tween(request):
+        if (request.method == "GET"
+                and request.path == "/"
+                and _wants_html(request)):
+            return HTTPFound("/+admin/")
+        return handler(request)
+    return tween
+
+
+def _wants_html(request):
+    accept = request.headers.get("Accept") or ""
+    if not accept:
+        return False
+    # Browsers send "text/html,application/xhtml+xml,...". JSON clients
+    # (our SPA, devpi CLI) send "application/json".
+    if "application/json" in accept and "text/html" not in accept:
+        return False
+    return "text/html" in accept or "*/*" in accept