dummy-versioning-demo 0.2.0

Dummy package for testing Python versioning and PyPI publishing

dummy-versioning-demo

Repository: test-python-repo URL: https://github.com/neerajmythink/test-python-repo

Dummy Python package repo to test:

• Python runtime compatibility across versions
• Git-tag based package versioning
• Build + publish flow to PyPI

What this repo includes

• src/ layout package: dummy_versioning_demo
• setuptools-scm versioning from Git tags
• CI matrix tests on Python 3.9 - 3.12
• Release workflow that publishes to PyPI

Local quickstart

1. Create/activate a virtual environment.
2. Install package + test/build tools.
3. Run tests and build.

Typical flow:

• install editable package: pip install -e .
• install tooling: pip install pytest build twine
• run tests: pytest -q
• build artifacts: python -m build

Artifacts are created in dist/ (.whl + .tar.gz).

Versioning model

Version is generated from Git tags using setuptools-scm.

Examples:

• tag v0.1.0 -> package version 0.1.0
• commits after tag produce a dev version automatically

To cut a release version:

1. Commit changes to main.
2. Create and push a tag like v0.1.0.
3. Create a GitHub Release from that tag.

The publish workflow triggers on release publication.

PyPI publishing

Recommended (CI / trusted publishing)

This repo includes .github/workflows/publish.yml using pypa/gh-action-pypi-publish with OIDC (id-token: write).

To enable it:

1. In PyPI, configure a Trusted Publisher for neerajmythink/test-python-repo.
2. Create a GitHub environment named pypi (optional protections).
3. Publish a GitHub release.

Optional local upload (token-based)

Use values in .env (TEST_PYPI_API_TOKEN, PYPI_API_TOKEN) for local twine upload testing.

TestPyPI (recommended first)

Before production PyPI, upload once to TestPyPI and verify install:

• upload to TestPyPI
• install from TestPyPI in a fresh venv
• validate dummy_versioning_demo.__version__

Notes

• Keep fetch-depth: 0 in CI/release workflows so tag-based versioning can resolve correctly.
• If no Git tag exists, setuptools-scm falls back to a dev-style version.