Erich Blume a3dec7f6e2 Add doc consistency checks and update pypi proxy docs

Add orphan detection to doc-links, and three new doc tasks: doc-index
(category index coverage), doc-stale (staleness report), doc-tags (tag
inventory). Register doc-index as a pre-commit hook. Update
use-pypi-proxy to document env-var-based proxy toggle.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-05 15:57:24 -08:00

1.2 KiB

Raw Blame History

title

Use the PyPI Proxy

How to configure clients and publish packages to devpi.

Configure pip/uv

Point pip and uv at the proxy via environment variables:

export PIP_INDEX_URL="https://pypi.ops.eblu.me/root/pypi/+simple/"
export UV_INDEX_URL="https://pypi.ops.eblu.me/root/pypi/+simple/"

Unset both to fall back to public PyPI (e.g. when indri is offline).

The dotfiles repo has shell config that manages this toggle.

Upload Packages

# Build and publish with uv
cd ~/code/personal/your-package
uv build
uv publish --publish-url https://pypi.ops.eblu.me/eblume/dev/

# First time: uv will prompt for credentials

Create Users/Indices

# Login as root
uvx devpi use https://pypi.ops.eblu.me
uvx devpi login root

# Create user (prompts for password - store in 1Password)
uvx devpi user -c USERNAME email=EMAIL

# Create index inheriting from PyPI mirror
uvx devpi index -c USERNAME/dev bases=root/pypi

Verify Cache

# Check if devpi is caching
curl -s https://pypi.ops.eblu.me/+api | jq

devpi - Service reference

1.2 KiB Raw Blame History