Hatchling packaging and UV Release workflow

[teocns]

Changes

• Switch from setuptools/hatch to UV for building and publishing packages
• Add manual testing capabilities through GitHub Actions UI or CLI
• Implement safer publishing workflow with environment protections

Important Note About Releases ⚠️

The automatic publishing on GitHub releases remains unchanged:

1. Create a new release in GitHub UI
2. Publish it (not draft)
3. Workflow automatically triggers
4. Package publishes to PyPI after a 10-second safety delay

Testing Required

Before merging, please:

1. Set up required secrets:

   • TEST_PYPI_API_TOKEN: Create a token at https://test.pypi.org/
   • Keep existing PYPI_API_TOKEN for production releases

2. Test the workflow:

   # Test just building (safest)
   gh workflow run "Upload Python Package" --ref <this-branch> --field test_mode=build-only
   
   # Test with dry-run (simulates publish)
   gh workflow run "Upload Python Package" --ref <this-branch> --field test_mode=dry-run
   
   # Optional: Test publish to TestPyPI (requires TEST_PYPI_API_TOKEN)
   gh workflow run "Upload Python Package" --ref <this-branch> --field test_mode=testpypi

What's Changed

• Build System: Using UV instead of setuptools for more modern and consistent tooling
• Safety: Added multiple safeguards:
  • Manual runs default to dry-run mode
  • 10-second warning delay before PyPI publish
  • Environment-specific configurations
• Testing: New options to test the publishing process without affecting PyPI
• Security: Using OIDC-based trusted publishing
• Documentation: Added GitHub CLI examples in workflow comments

After Merging

Your existing release process stays exactly the same:

1. Create and publish a release in GitHub UI
2. Workflow automatically triggers
3. Package builds and publishes to PyPI (after 10s delay)
4. No manual steps needed

The only visible difference will be a 10-second delay with a warning message before publishing, giving you a chance to cancel if needed.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Flag	Coverage Δ
unittests	37.41% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

[areibman]

Great fix Teo!