Metadata-Version: 2.4
Name: hh20-pypi-helper
Version: 0.1.0
Summary: Helper to build and (experimentally) upload packages to PyPI without twine
Author-email: Your Name <you@example.com>
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: build
Requires-Dist: requests
Requires-Dist: pyinstaller
Dynamic: license-file

# 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:

```bash
python -m pip install --upgrade build requests
```

2. Initialize a simple project:

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

3. Build and upload to TestPyPI:

```bash
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:

```bash
python -m pip install --upgrade build requests
```

3. Build distributions:

```bash
python -m build
```

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

# Linux / macOS
```bash
export PYPI_TOKEN="pypi-..."
python cli.py upload --repo testpypi --token "$PYPI_TOKEN"
```

# Windows PowerShell
```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:

```bash
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.
