HH20 PyPI Helper

Minimal helper to build and experimentally upload Python packages without twine. Use at your own risk — uploading directly to the legacy PyPI endpoint is supported but twine is still recommended for production.

Quick start

1. Install deps:

python -m pip install --upgrade build requests

2. Initialize a simple project:

python cli.py init --name mypkg --version 0.1.0 --description "My package"

3. Build and upload to TestPyPI:

python cli.py build
python cli.py upload --repo testpypi --token <TEST_PYPI_TOKEN>
# or build+publish
python cli.py publish --repo testpypi --token <TEST_PYPI_TOKEN>

Files

• cli.py: friendly command-line wrapper
• compiler.py: helper functions for building, inspecting and uploading
• main.py: earlier scaffold (kept for compatibility)

Publish to PyPI

1. Pick a unique package name (update setup.cfg or pyproject.toml name/version).
2. Install build tools and dependencies:

python -m pip install --upgrade build requests

3. Build distributions:

python -m build

4. Upload using a PyPI API token (recommended). Use TestPyPI first.

Linux / macOS

export PYPI_TOKEN="pypi-..."
python cli.py upload --repo testpypi --token "$PYPI_TOKEN"

Windows PowerShell

$env:PYPI_TOKEN = "pypi-..."
python cli.py upload --repo testpypi --token $env:PYPI_TOKEN

Replace --repo testpypi with --repo pypi to publish to the real PyPI. After a successful upload you can install with:

python -m pip install hh20-pypi-helper

Notes

• The upload command uses the legacy PyPI upload endpoint with HTTP Basic auth. When using an API token, pass username __token__ (the CLI does this automatically if you provide --token).
• Always test against TestPyPI before publishing to the real PyPI.
• Ensure your package name is unique on PyPI before publishing.