hh20-pypi-helper 0.1.0

Helper to build and (experimentally) upload packages to PyPI without twine

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.