ptrain

A minimal Python package scaffold for ptrain, with no runtime dependencies. It includes an importable package, a command-line entry point, and build metadata. Training functionality is not implemented yet.

Local development

Requires Python 3.10+ and uv. Run these commands from this directory:

uv venv
uv pip install -e .
.venv/bin/ptrain --version
.venv/bin/python -m ptrain --help

import ptrain

print(ptrain.__version__)

Add application code under src/ptrain/ and commands in src/ptrain/cli.py. The version is defined in src/ptrain/__init__.py; packaging metadata reads it from that file. The initial version is 0.1.0a1 (pre-alpha).

Build and validate

uv build
uvx twine check --strict dist/ptrain-0.1.0a1-py3-none-any.whl dist/ptrain-0.1.0a1.tar.gz

The wheel and source distribution are written to dist/.

Publishing

Creating or building this template does not register or reserve the name on PyPI. Before a public release, add the intended functionality and update the description, author information, and license as appropriate. Add repository/documentation URLs once those destinations exist. Use a new version for each release.

For token-based publishing, configure an authorized PyPI token locally using UV_PUBLISH_TOKEN, without placing its value in source files, command arguments, or chat. Then upload the checked artifacts:

uv publish dist/ptrain-0.1.0a1-py3-none-any.whl dist/ptrain-0.1.0a1.tar.gz

Update the artifact filenames after changing the version. For a first upload, the credential must allow creating the new project. An absent project page does not guarantee that PyPI will accept the name.

For CI publishing without long-lived tokens, configure a PyPI Trusted Publisher.

Packaging references:

• Python Packaging User Guide
• uv building and publishing guide
• PyPI authentication and project-name guidance

License

MIT; see LICENSE.