This repository contains two GitHub Actions:

1. Check Version - Ensures that the version in pyproject.toml has been updated before merging a pull request.
2. Tag Version - Automatically tags a commit with the version from pyproject.toml when changes are merged into main.

Add the following to your .github/workflows/check_version.yml:

name: Check Version

on:
  pull_request:
    branches:
      - main

jobs:
  check_version:
    runs-on: ubuntu-latest
    steps:
      - uses: villoro/vhooks/[email protected]
        with:
          branch: "main"  # Change this to compare against a different branch
          path: "project/version"  # Specify the version path inside pyproject.toml

• Fails the PR if the version in pyproject.toml has not been updated.
• Fails the PR if the version increments are not consecutive.
• Passes the PR if the version has been correctly incremented.

Add the following to your .github/workflows/tag_version.yml:

name: Tag Version

on:
  push:
    branches:
      - main
    paths:
      - pyproject.toml

permissions:
  contents: write

jobs:
  tag_version:
    runs-on: ubuntu-latest
    steps:
      - uses: villoro/vhooks/[email protected]
        with:
          path: "project/version"  # Specify the version path inside pyproject.toml

• Creates a new Git tag when pyproject.toml is modified in main.
• Uses the specified version path to extract the version.
• Skips tagging if the version is already tagged.

• GitHub Actions Documentation
• Python Packaging Guide