devpi-admin 1.0.0__tar.gz

devpi_admin-1.0.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__
+build
+*.egg-info
+*.venv
+*.whl
+.DS_Store
+.uuid
+*.pyc
+.*
+!.gitignore
+!.github
+!.gitea
+src/devpi_admin/_version.py
+*.md
+!README*.md

devpi_admin-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pavel Revak <pavelrevak@gmail.com>
+
+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.

devpi_admin-1.0.0/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: devpi-admin
+Version: 1.0.0
+Summary: Modern web UI plugin for devpi-server — drop-in replacement for devpi-web
+Author-email: Pavel Revak <pavelrevak@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: admin,devpi,pypi,ui,web
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Pyramid
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Software Distribution
+Requires-Python: >=3.9
+Requires-Dist: devpi-server>=6.0
+Description-Content-Type: text/markdown
+
+# devpi-admin
+
+A modern web UI plugin for [devpi-server](https://devpi.net/) — a drop-in replacement for
+`devpi-web`. Ships as a Python package that registers itself as a devpi-server plugin via the
+standard entry point mechanism, so a single `pip install devpi-admin` is enough.
+
+The UI itself is a bundled single-page application (pure HTML + CSS + vanilla JavaScript, no
+build step) served under `/+admin/`. All devpi REST API endpoints remain untouched — the SPA
+talks to the standard devpi JSON API directly.
+
+## Features
+
+- **Dashboard** with server info and cache metrics (`/+status`)
+- **Index browser** with visual cards color-coded by type (stage / volatile / mirror)
+- **Users** management — create, edit, delete (admin only)
+- **Index** management — create / edit / delete, configure `bases` (drag & drop priority,
+  transitive inheritance detection), `volatile`, `acl_upload` (tag picker), `mirror_url`
+- **Package browser** with client-side search and pagination, including an explicit
+  download prompt for huge mirrors (e.g. `root/pypi`'s ~780 k packages / 17 MB index)
+- **Package detail** in a PyPI-like layout: sidebar with metadata, version list, install
+  command, file downloads; main area renders the README (markdown via `marked.js`)
+- **Copy-to-clipboard `pip install`** commands with a `pip.conf` toggle
+  (short form vs. full `--index-url` / `--trusted-host`)
+- **`pip.conf` generator** — download a ready-to-use config per index
+- **Anonymous browsing** — visitors can explore public indexes without logging in; admin
+  actions appear only after authentication
+- **Dark / light / auto theme**, responsive mobile menu, ESC + outside-click dismissal of
+  dialogs
+
+## Installation
+
+```bash
+pip install devpi-admin
+```
+
+This pulls in `devpi-server` as a dependency. If you are using devpi in a dedicated venv
+(recommended), install the plugin into the same venv:
+
+```bash
+/var/lib/pypi/venv/bin/pip install devpi-admin
+systemctl --user restart devpi      # or however you run devpi-server
+```
+
+You should uninstall `devpi-web` first — `devpi-admin` provides all the web UI you need:
+
+```bash
+pip uninstall devpi-web
+```
+
+## Usage
+
+After restart, open:
+
+```
+http://<your-devpi-host>:3141/
+```
+
+Browser visits to `/` are redirected to `/+admin/`, which serves the SPA. Direct links like
+`http://<host>:3141/+admin/#packages/ci/testing` work and can be bookmarked.
+
+devpi CLI tools and other JSON clients are unaffected — they send `Accept: application/json`
+and bypass the redirect.
+
+## How it works
+
+`devpi-admin` registers a `devpi_server` entry point that hooks into `devpiserver_pyramid_configure`
+to:
+
+1. Serve the bundled static assets under `/+admin/` via a Pyramid static view.
+2. Add an explicit view at `/+admin/` that returns `index.html` (so the directory itself
+   resolves to the SPA entry point).
+3. Install a tween that redirects HTML browser requests on `/` to `/+admin/` while leaving
+   JSON requests intact.
+
+No changes are made to the devpi REST API.
+
+## Requirements
+
+- Python 3.9+
+- devpi-server 6.0+
+- A browser with ES6 support and `Promise`, `fetch`, `sessionStorage`
+
+## Routes (UI)
+
+Routing is hash-based, so any of these URLs can be bookmarked or shared:
+
+- `/+admin/#` — Status dashboard (default)
+- `/+admin/#indexes` — all indexes
+- `/+admin/#indexes/<user>` — filtered to one user
+- `/+admin/#packages/<user>/<index>` — packages in an index
+- `/+admin/#package/<user>/<index>/<name>` — package detail (latest version)
+- `/+admin/#package/<user>/<index>/<name>?version=<ver>` — specific version
+- `/+admin/#users` — users admin (requires login)
+
+## Project layout
+
+```
+devpi-admin/
+├── pyproject.toml
+├── README.md
+└── src/
+    └── devpi_admin/
+        ├── __init__.py
+        ├── main.py              — Pyramid hooks & tween
+        └── static/
+            ├── index.html       — SPA entry
+            ├── css/style.css
+            └── js/
+                ├── api.js       — devpi REST wrapper
+                ├── theme.js     — theme toggle (light/dark/auto)
+                ├── marked.min.js  — vendored markdown renderer
+                └── app.js       — routing, views, rendering
+```
+
+## Development
+
+```bash
+git clone <repo>
+cd devpi-admin
+pip install -e .
+```
+
+The static files live at `src/devpi_admin/static/` and can be edited in place — changes
+show up on the next browser reload, no restart of devpi-server required (static views
+read from disk on each request).
+
+## Author
+
+Pavel Revak <pavelrevak@gmail.com>
+
+## License
+
+MIT — see [LICENSE](LICENSE).

devpi_admin-1.0.0/README.md

@@ -0,0 +1,133 @@
+# devpi-admin
+
+A modern web UI plugin for [devpi-server](https://devpi.net/) — a drop-in replacement for
+`devpi-web`. Ships as a Python package that registers itself as a devpi-server plugin via the
+standard entry point mechanism, so a single `pip install devpi-admin` is enough.
+
+The UI itself is a bundled single-page application (pure HTML + CSS + vanilla JavaScript, no
+build step) served under `/+admin/`. All devpi REST API endpoints remain untouched — the SPA
+talks to the standard devpi JSON API directly.
+
+## Features
+
+- **Dashboard** with server info and cache metrics (`/+status`)
+- **Index browser** with visual cards color-coded by type (stage / volatile / mirror)
+- **Users** management — create, edit, delete (admin only)
+- **Index** management — create / edit / delete, configure `bases` (drag & drop priority,
+  transitive inheritance detection), `volatile`, `acl_upload` (tag picker), `mirror_url`
+- **Package browser** with client-side search and pagination, including an explicit
+  download prompt for huge mirrors (e.g. `root/pypi`'s ~780 k packages / 17 MB index)
+- **Package detail** in a PyPI-like layout: sidebar with metadata, version list, install
+  command, file downloads; main area renders the README (markdown via `marked.js`)
+- **Copy-to-clipboard `pip install`** commands with a `pip.conf` toggle
+  (short form vs. full `--index-url` / `--trusted-host`)
+- **`pip.conf` generator** — download a ready-to-use config per index
+- **Anonymous browsing** — visitors can explore public indexes without logging in; admin
+  actions appear only after authentication
+- **Dark / light / auto theme**, responsive mobile menu, ESC + outside-click dismissal of
+  dialogs
+
+## Installation
+
+```bash
+pip install devpi-admin
+```
+
+This pulls in `devpi-server` as a dependency. If you are using devpi in a dedicated venv
+(recommended), install the plugin into the same venv:
+
+```bash
+/var/lib/pypi/venv/bin/pip install devpi-admin
+systemctl --user restart devpi      # or however you run devpi-server
+```
+
+You should uninstall `devpi-web` first — `devpi-admin` provides all the web UI you need:
+
+```bash
+pip uninstall devpi-web
+```
+
+## Usage
+
+After restart, open:
+
+```
+http://<your-devpi-host>:3141/
+```
+
+Browser visits to `/` are redirected to `/+admin/`, which serves the SPA. Direct links like
+`http://<host>:3141/+admin/#packages/ci/testing` work and can be bookmarked.
+
+devpi CLI tools and other JSON clients are unaffected — they send `Accept: application/json`
+and bypass the redirect.
+
+## How it works
+
+`devpi-admin` registers a `devpi_server` entry point that hooks into `devpiserver_pyramid_configure`
+to:
+
+1. Serve the bundled static assets under `/+admin/` via a Pyramid static view.
+2. Add an explicit view at `/+admin/` that returns `index.html` (so the directory itself
+   resolves to the SPA entry point).
+3. Install a tween that redirects HTML browser requests on `/` to `/+admin/` while leaving
+   JSON requests intact.
+
+No changes are made to the devpi REST API.
+
+## Requirements
+
+- Python 3.9+
+- devpi-server 6.0+
+- A browser with ES6 support and `Promise`, `fetch`, `sessionStorage`
+
+## Routes (UI)
+
+Routing is hash-based, so any of these URLs can be bookmarked or shared:
+
+- `/+admin/#` — Status dashboard (default)
+- `/+admin/#indexes` — all indexes
+- `/+admin/#indexes/<user>` — filtered to one user
+- `/+admin/#packages/<user>/<index>` — packages in an index
+- `/+admin/#package/<user>/<index>/<name>` — package detail (latest version)
+- `/+admin/#package/<user>/<index>/<name>?version=<ver>` — specific version
+- `/+admin/#users` — users admin (requires login)
+
+## Project layout
+
+```
+devpi-admin/
+├── pyproject.toml
+├── README.md
+└── src/
+    └── devpi_admin/
+        ├── __init__.py
+        ├── main.py              — Pyramid hooks & tween
+        └── static/
+            ├── index.html       — SPA entry
+            ├── css/style.css
+            └── js/
+                ├── api.js       — devpi REST wrapper
+                ├── theme.js     — theme toggle (light/dark/auto)
+                ├── marked.min.js  — vendored markdown renderer
+                └── app.js       — routing, views, rendering
+```
+
+## Development
+
+```bash
+git clone <repo>
+cd devpi-admin
+pip install -e .
+```
+
+The static files live at `src/devpi_admin/static/` and can be edited in place — changes
+show up on the next browser reload, no restart of devpi-server required (static views
+read from disk on each request).
+
+## Author
+
+Pavel Revak <pavelrevak@gmail.com>
+
+## License
+
+MIT — see [LICENSE](LICENSE).

devpi_admin-1.0.0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[project]
+name = "devpi-admin"
+dynamic = ["version"]
+description = "Modern web UI plugin for devpi-server — drop-in replacement for devpi-web"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+    { name = "Pavel Revak", email = "pavelrevak@gmail.com" },
+]
+keywords = ["devpi", "pypi", "admin", "web", "ui"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Framework :: Pyramid",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: System :: Software Distribution",
+]
+dependencies = [
+    "devpi-server>=6.0",
+]
+
+[project.entry-points.devpi_server]
+devpi-admin = "devpi_admin.main"
+
+[tool.hatch.version]
+source = "vcs"
+fallback-version = "0.0.0"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "src/devpi_admin/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/devpi_admin"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/devpi_admin",
+    "tests",
+    "README.md",
+    "pyproject.toml",
+    "LICENSE",
+]

devpi_admin-1.0.0/src/devpi_admin/__init__.py

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

devpi_admin-1.0.0/src/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-1.0.0/src/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