exmailer/.github/workflows/pypi_publish.yml at e4898f9268c1ca3bf7edf19350d412e7eee049e7 · aerosadegh/exmailer · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
name: Publish to PyPI

on:
  push:
    branches:
      - main
    tags:
      - "v*.*.*"  # Triggers only on version tags, e.g., v1.0.0

permissions:
  contents: read

jobs:
  # ------------------------------------------------------------------
  # JOB 1: QUALITY ASSURANCE
  # strictly enforces that tests pass before any build occurs.
  # ------------------------------------------------------------------
  test:
    name: Run Tests
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        python-version: ["3.11", "3.12", "3.13"]

    steps:
      - name: Checkout Code
        uses: actions/checkout@v4

      - name: Install uv
        uses: astral-sh/setup-uv@v5
        with:
          version: "latest"

      - name: Set up Python ${{ matrix.python-version }}
        run: uv python install ${{ matrix.python-version }}

      - name: Install Project & Dependencies
        run: |
          uv sync --all-extras --dev

      - name: Run Pytest
        # We use 'uv run' to execute within the isolated environment
        run: uv run pytest

  # ------------------------------------------------------------------
  # JOB 2: BUILD ARTIFACTS
  # Creates the .whl and .tar.gz files
  # ------------------------------------------------------------------
  build:
    name: Build Distribution
    needs: test
    if: startsWith(github.ref, 'refs/tags/') # Only run on tags
    runs-on: ubuntu-latest

    steps:
      - name: Checkout Code
        uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.12"

      - name: Install Build Frontend
        run: python -m pip install build

      - name: Build Binary (Wheel) and Source (sDist)
        run: python -m build

      - name: Verify Artifacts
        run: ls -l dist/

      - name: Upload Artifacts
        uses: actions/upload-artifact@v4
        with:
          name: python-package-distributions
          path: dist/

  # ------------------------------------------------------------------
  # JOB 3: PUBLISH TO PYPI
  # Uploads the built artifacts to the package registry
  # ------------------------------------------------------------------
  publish:
    name: Upload to PyPI
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: pypi
      url: https://pypi.org/p/exmailer
    permissions:
      id-token: write  # MANDATORY for Trusted Publishing

    steps:
      - name: Download Artifacts
        uses: actions/download-artifact@v4
        with:
          name: python-package-distributions
          path: dist/

      - name: Publish to PyPI
        uses: pypa/gh-action-pypi-publish@release/v1