Adds a minimal release workflow and migrated to uv.

Author: semohr

.github/workflows/build.yml

@@ -23,42 +23,41 @@ jobs:
 
     steps:
       - uses: actions/checkout@v5
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+      - name: Install uv and set the Python version
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: ${{ matrix.python-version }}
+          enable-cache: true
       - name: Install dependencies
         run: |
-          python -m pip install --upgrade pip
-          pip install .[dev]
-
-      - name: Run tests
+          uv sync --frozen --all-extras --dev
+      - name: Run tests with coverage
         run: |
-          pytest -v --cov=mediafile --cov=mediafile --cov-report=xml --cov-report=html test/
+          uv run poe test-with-coverage -v
       - name: Upload coverage reports
         if: matrix.os == 'ubuntu-24.04' && matrix.python-version == env.MAIN_PYTHON_VERSION
         uses: actions/upload-artifact@v4
         with:
           name: coverage-${{ github.run_id }}
-          path: htmlcov/
+          path: reports
           retention-days: 30
 
   style:
     name: Style
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
-      - name: Set up Python ${{ env.MAIN_PYTHON_VERSION }}
-        uses: actions/setup-python@v5
+      - name: Install uv and set the Python version
+        uses: astral-sh/setup-uv@v6
         with:
           python-version: ${{ env.MAIN_PYTHON_VERSION }}
+          enable-cache: true
       - name: Install dependencies
         run: |
-          python -m pip install --upgrade pip
-          pip install .[dev]
+          uv sync --frozen --group dev
       - name: Check style with Ruff
         run: |
-          ruff check --output-format=github .
+          uv run ruff check --output-format=github .
       - name: Check format with Ruff
         run: |
-          ruff format --check .
+          uv run ruff format --check .

.github/workflows/make_release.yaml

@@ -0,0 +1,73 @@
+name: Publish Python Package
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version of the new release, just as a number with no prepended "v"'
+        required: true
+
+env:
+  PYTHON_VERSION: "3.12"
+  NEW_VERSION: ${{ inputs.version }}
+  NEW_TAG: v${{ inputs.version }}
+
+jobs:
+  increment-version:
+    name: Bump version, commit and create tag
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - name: Install uv and set the Python version
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+          enable-cache: true
+      - name: Bump project version
+        run: uv version "${{ env.NEW_VERSION }}"
+
+      - uses: EndBug/add-and-commit@v9
+        id: commit_and_tag
+        name: Commit the changes and create tag
+        with:
+          message: "Increment version to ${{ env.NEW_VERSION }}"
+          tag: "${{ env.NEW_TAG }} --force"
+
+  build:
+    name: Build the distribution package
+    runs-on: ubuntu-latest
+    needs: increment-version
+    steps:
+      - uses: actions/checkout@v5
+      - name: Install uv and set the Python version
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+          enable-cache: true
+
+      - name: Build a binary wheel and a source tarball
+        run: uv build
+
+      - name: Store the package
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish-to-pypi:
+    name: Publish distribution 📦 to PyPI
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: pypi
+      url: https://pypi.org/p/mediafile
+    permissions:
+      id-token: write
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v5
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish
+        run: uv publish

CONTRIBUTING.md

@@ -11,16 +11,22 @@ Please follow these guidelines to ensure a smooth contribution process.
 
 ## Setup the Development Environment
 
-We recommend using a virtual environment to manage dependencies. You can use `venv`, `conda`, or any other tool of your choice.
-
 1. Fork/Clone the repository on GitHub
 ```bash
 git clone <your-fork-url>
 cd mediafile
 ```
-2. Install dependencies and set up the development environment
+
+We use `uv` to manage virtual environments. If you don't have it installed, see [here](https://pypi.org/project/uv/).
+
+2. Install dependencies and set up the development environment (using same lockfile as production):
+```bash
+uv sync --frozen --group dev
+```
+
+3. Activate the virtual environment (optional):
 ```bash
-pip install -e '.[dev]'
+source .venv/bin/activate
 ```
 
 ## Before submitting a Pull Request
@@ -29,7 +35,7 @@ Verify that your code adheres to the project standards and conventions. Run
 ruff and pytest to ensure your code is properly formatted and all tests pass.
 
 ```bash
-ruff check .
-ruff format .
-pytest .
+uv run poe format
+uv run poe lint
+uv run poe test
 ```

mediafile/__version__.py

@@ -4,14 +4,14 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "mediafile"
+version = "1.0.0a1"
 authors = [
     { name = "Adrian Sampson", email = "[email protected]" },
 ]
 readme = "README.rst"
 license = "MIT"
 requires-python = ">=3.9"
 description = "A simple, cross-format library for reading and writing media file metadata."
-dynamic = ["version"]
 classifiers = [
     'Topic :: Multimedia :: Sound/Audio',
     'Environment :: Web Environment',
@@ -32,12 +32,6 @@ dependencies = [
 Documentation = "https://mediafile.readthedocs.io"
 Source = "https://github.com/beetbox/mediafile"
 
-[project.optional-dependencies]
-dev = [
-    "ruff",
-    "pytest",
-    "pytest-cov"
-]
 
 [tool.ruff]
 target-version = "py39"
@@ -58,4 +52,47 @@ ignore = [
 ]
 
 [tool.ruff.format]
-quote-style = "double"
+quote-style = "double"
+
+[dependency-groups]
+dev = [
+    "poethepoet>=0.37.0",
+    "pytest>=8.4.2",
+    "pytest-cov>=7.0.0",
+    "ruff>=0.14.1",
+]
+
+[tool.poe]
+executor.type = "uv"
+
+[tool.poe.tasks.build]
+help = "Build the package"
+cmd = "uv build"
+
+[tool.poe.tasks.test]
+help = "Run the test suite with coverage"
+cmd = "pytest $OPTS"
+env.OPTS.default = "---cov=mediafile test/"
+
+[tool.poe.tasks.test-with-coverage]
+help = "Run the test suite with coverage (alias for 'poe test')"
+ref = "test"
+env.OPTS.default = """
+--cov=mediafile
+--cov-report=xml:.reports/coverage.xml
+--cov-report=html:.reports/html
+--cov-branch
+--cov-context=test
+"""
+
+[tool.poe.tasks.lint]
+help = "Run ruff linter"
+cmd = "ruff check"
+
+[tool.poe.tasks.format]
+help = "Autoformat code with ruff"
+cmd = "ruff format"
+
+[tool.poe.tasks.check-types]
+help = "Check the code for typing issues. Accepts mypy options."
+cmd = "mypy"