Merge branch 'master' into targeted-childcare-entitlement

.github/workflows/code_changes.yaml

@@ -0,0 +1,91 @@
+# Workflow that runs on code changes to the master branch.
+
+name: Code changes
+on:
+  push:
+    branches:
+      - master
+
+    paths:
+      - policyengine_uk/**
+      - tests/**
+      - .github/**
+
+jobs:
+  Lint:
+    runs-on: ubuntu-latest
+    steps:
+        - uses: actions/checkout@v4
+        - name: Check formatting
+          uses: "lgeiger/black-action@master"
+          with:
+              args: ". -l 79 --check"
+  Test:
+      runs-on: ubuntu-latest
+      steps:
+          - name: Checkout repo
+            uses: actions/checkout@v2
+          - name: Install uv
+            uses: astral-sh/setup-uv@v5
+
+          - name: Set up Python
+            uses: actions/setup-python@v2
+            with:
+                python-version: '3.12'
+
+          - name: Install package
+            run: uv pip install -e .[dev] --system
+          - name: Install policyengine
+            run: uv pip install policyengine --system
+          - name: Run tests
+            run: make test
+          - name: Build documentation
+            run: make documentation
+          - name: Deploy documentation
+            uses: JamesIves/github-pages-deploy-action@releases/v3
+            with:
+              GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              BRANCH: gh-pages  # The branch the action should deploy to.
+              FOLDER: docs/book/_build/html  # The folder the action should deploy.
+  Publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v2
+      - name: Setup Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: '3.12'
+      - name: Publish a git tag
+        run: ".github/publish-git-tag.sh"
+      - name: Build package
+        run: make
+      - name: Publish a Python distribution to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI }}
+          skip_existing: true
+  Deploy:
+    runs-on: ubuntu-latest
+    env:
+      GH_TOKEN: ${{ secrets.POLICYENGINE_GITHUB }}
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v2
+        with:
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+          ref: ${{ github.event.pull_request.head.ref }}
+          token: ${{ secrets.POLICYENGINE_GITHUB }}
+      - name: Setup Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: 3.9
+      - name: Install Wheel and Pytest
+        run: pip3 install wheel setuptools pytest==5.4.3
+      - name: Install package
+        run: make install
+      - name: Update API
+        run: python .github/update_api.py
+        env:
+          GITHUB_TOKEN: ${{ secrets.POLICYENGINE_GITHUB }}

.github/workflows/docs_changes.yaml

@@ -0,0 +1,38 @@
+# Workflow that runs on code changes to the master branch.
+
+name: Docs changes
+on:
+  push:
+    branches:
+      - master
+
+    paths:
+      - docs/**
+      - .github/**
+
+jobs:
+  Documentation:
+    runs-on: ubuntu-latest
+    steps:
+        - name: Checkout repo
+          uses: actions/checkout@v2
+        - name: Install uv
+          uses: astral-sh/setup-uv@v5
+
+        - name: Set up Python
+          uses: actions/setup-python@v2
+          with:
+              python-version: '3.12'
+
+        - name: Install package
+          run: uv pip install -e .[dev] --system
+        - name: Install policyengine
+          run: uv pip install policyengine --system
+        - name: Build documentation
+          run: make documentation
+        - name: Deploy documentation
+          uses: JamesIves/github-pages-deploy-action@releases/v3
+          with:
+            GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+            BRANCH: gh-pages  # The branch the action should deploy to.
+            FOLDER: docs/book/_build/html  # The folder the action should deploy.

.github/workflows/pr_code_changes.yaml

@@ -0,0 +1,49 @@
+# Workflow that runs on code changes to a pull request.
+
+name: Code changes
+on:
+  pull_request:
+    branches:
+      - master
+
+    paths:
+      - policyengine_uk/**
+      - tests/**
+      - .github/**
+
+jobs:
+  Lint:
+    runs-on: ubuntu-latest
+    steps:
+        - uses: actions/checkout@v4
+        - name: Check formatting
+          uses: "lgeiger/black-action@master"
+          with:
+              args: ". -l 79 --check"
+  Test:
+      runs-on: ubuntu-latest
+      steps:
+          - name: Checkout repo
+            uses: actions/checkout@v2
+          - name: Install uv
+            uses: astral-sh/setup-uv@v5
+
+          - name: Set up Python
+            uses: actions/setup-python@v2
+            with:
+                python-version: '3.12'
+
+          - name: Install package
+            run: uv pip install -e .[dev] --system
+          - name: Install policyengine
+            run: uv pip install policyengine --system
+          - name: Run tests
+            run: pytest
+            env:
+              HUGGING_FACE_TOKEN: ${{ secrets.HUGGING_FACE_TOKEN }}
+          - name: Compare PSND
+            run: make compare_psnd
+            env:
+              HUGGING_FACE_TOKEN: ${{ secrets.HUGGING_FACE_TOKEN }}
+          - name: Test documentation builds
+            run: make documentation

.github/workflows/pr_docs_changes.yaml

@@ -0,0 +1,41 @@
+# Workflow that runs on code changes to a pull request.
+
+name: Docs changes
+on:
+  pull_request:
+    branches:
+      - master
+
+    paths:
+      - docs/**
+      - .github/**
+
+jobs:
+  Lint:
+    runs-on: ubuntu-latest
+    steps:
+        - uses: actions/checkout@v4
+        - name: Check formatting
+          uses: "lgeiger/black-action@master"
+          with:
+              args: ". -l 79 --check"
+  Test:
+      runs-on: ubuntu-latest
+      name: Test documentation builds
+      steps:
+          - name: Checkout repo
+            uses: actions/checkout@v2
+          - name: Install uv
+            uses: astral-sh/setup-uv@v5
+
+          - name: Set up Python
+            uses: actions/setup-python@v2
+            with:
+                python-version: '3.12'
+
+          - name: Install package
+            run: uv pip install -e .[dev] --system
+          - name: Install policyengine
+            run: uv pip install policyengine --system
+          - name: Test documentation builds
+            run: make documentation

.github/workflows/versioning.yaml

@@ -0,0 +1,36 @@
+# Workflow that runs on versioning metadata updates.
+
+name: Versioning updates
+on:
+  push:
+    branches:
+      - master
+
+    paths:
+      - changelog_entry.yaml
+      - .github/**
+
+jobs:
+    Versioning:
+      if: (github.event.head_commit.message != 'Update package version')
+      runs-on: ubuntu-latest
+      steps:
+        - name: Checkout repo
+          uses: actions/checkout@v4
+          with:
+            repository: ${{ github.event.pull_request.head.repo.full_name }}
+            ref: ${{ github.event.pull_request.head.ref }}
+            token: ${{ secrets.POLICYENGINE_GITHUB }}
+        - name: Setup Python
+          uses: actions/setup-python@v5
+          with:
+            python-version: 3.12
+        - name: Build changelog
+          run: pip install yaml-changelog && make changelog
+        - name: Preview changelog update
+          run: ".github/get-changelog-diff.sh"
+        - name: Update changelog
+          uses: EndBug/add-and-commit@v9
+          with:
+            add: "."
+            message: Update package version