[#27] improve(ci): replace testpypi with dev/rc pre-release publishing to PyPI (#28)

### What changes were proposed in this pull request?

Remove the `testpypi` environment from the `publish.yml` workflow and
replace it with native PyPI pre-release versioning. The workflow now
accepts an optional `version` input: if it ends with `.devN` or `.rcN`,
the version is patched via `uv version` before building and publishing
to PyPI; otherwise the version in `pyproject.toml` is used directly for
a production release.

### Why are the changes needed?

- TestPyPI requires a separate trusted publisher configuration and has
storage limits that need manual cleanup
- Pre-release packages on PyPI (`.dev`, `.rc`) are already hidden from
default installs (`pip install` won't pick them up without `--pre`),
making TestPyPI unnecessary
- Reduces workflow complexity: one target registry, one publish command

### Does this PR introduce _any_ user-facing change?

- The `environment` input (testpypi / pypi) is removed from the `Publish
to PyPI` workflow dispatch
- A pre-release can now be published by providing a version like
`0.1.0.dev1` or `0.1.0.rc1` in the `version` input

### How was this patch tested?

Workflow logic change only — no code changes. Validated by reviewing the
updated YAML and confirming the bash version check regex (`\.devN` /
`.rcN`) matches expected inputs.

Fix: #27

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: mchades

.github/workflows/publish.yml

@@ -18,17 +18,9 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: "Version to publish (required for testpypi, e.g. 0.1.0.dev1). Ignored for pypi."
+        description: "Optional pre-release version to publish (e.g. 0.1.0.dev1 or 0.1.0.rc1). Must end with .devN or .rcN. Leave blank to publish the version from pyproject.toml as a production release."
         required: false
         type: string
-      environment:
-        description: "Target PyPI environment"
-        required: true
-        type: choice
-        default: "pypi"
-        options:
-          - "pypi"
-          - "testpypi"
       ref:
         description: "Branch or tag to publish from (e.g. main, v0.1.0). Defaults to the branch selected above."
         required: false
@@ -38,8 +30,8 @@ jobs:
   publish:
     runs-on: ubuntu-latest
     environment:
-      name: ${{ github.event.inputs.environment }}
-      url: ${{ github.event.inputs.environment == 'pypi' && 'https://pypi.org/project/adp-sdk/' || 'https://test.pypi.org/project/adp-sdk/' }}
+      name: pypi
+      url: https://pypi.org/project/adp-sdk/
     permissions:
       id-token: write
       contents: read
@@ -57,17 +49,17 @@ jobs:
 
       - name: Resolve version
         run: |
-          if [ "${{ github.event.inputs.environment }}" = "testpypi" ]; then
-            VERSION="${{ github.event.inputs.version }}"
-            if [ -z "${VERSION}" ]; then
-              echo "Error: version input is required when publishing to testpypi"
+          VERSION="${{ github.event.inputs.version }}"
+          if [ -n "${VERSION}" ]; then
+            if [[ ! "${VERSION}" =~ ^[0-9]+\.[0-9]+\.[0-9]+\.(dev|rc)[0-9]+$ ]]; then
+              echo "Error: version must follow the format X.Y.Z.devN or X.Y.Z.rcN (e.g. 0.1.0.dev1, 0.1.0.rc1)"
               exit 1
             fi
-            echo "Patching pyproject.toml with version: ${VERSION}"
-            sed -i "s/^version = \".*\"/version = \"${VERSION}\"/" pyproject.toml
+            echo "Patching pyproject.toml with pre-release version: ${VERSION}"
+            uv version "${VERSION}"
           else
             VERSION=$(uv run python -c "import tomllib; f=open('pyproject.toml','rb'); d=tomllib.load(f); print(d['project']['version'])")
-            echo "Publishing version from pyproject.toml: ${VERSION}"
+            echo "Publishing production version from pyproject.toml: ${VERSION}"
           fi
 
       - name: Build
@@ -77,9 +69,4 @@ jobs:
         run: uv run --isolated --no-project --with "$(ls dist/*.whl)" -- python -c "import adp_sdk; print(adp_sdk.__version__)"
 
       - name: Publish
-        run: |
-          if [ "${{ github.event.inputs.environment }}" = "testpypi" ]; then
-            uv publish --index testpypi
-          else
-            uv publish
-          fi
+        run: uv publish