This action creates a non-square matrix from parsing a matrix configuration declared in the workflow file.
I wrote this action for my python/django testing needs, but it is very flexible and scalable, so it can be used in many other contexts.
Example:
python-version {3.10}, django-version {4.0, 4.1, 4.2, 5.0, 5.1}, database {sqlite, mysql, postgres}
python-version {3.11}, django-version {4.1, 4.2, 5.0, 5.1}, database {sqlite, mysql, postgres}
python-version {3.12}, django-version {4.2, 5.0, 5.1}, database {sqlite, mysql, postgres}
python-version {3.13}, django-version {5.1}, database {sqlite, mysql, postgres}
Note: In the above example,
python-version,django-versionanddatabaseare just the matrix variable names that we can access in the following step, so it is possible to name these variables as needed.
Example:
# ...
jobs:
prepare:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v2
- name: Create matrix
id: create_matrix
uses: fabiocaccamo/create-matrix-action@v3
with:
matrix: |
python-version {3.10}, django-version {4.0, 4.1, 4.2, 5.0, 5.1}, database {sqlite, mysql, postgres}
python-version {3.11}, django-version {4.1, 4.2, 5.0, 5.1}, database {sqlite, mysql, postgres}
python-version {3.12}, django-version {4.2, 5.0, 5.1}, database {sqlite, mysql, postgres}
python-version {3.13}, django-version {5.1}, database {sqlite, mysql, postgres}
outputs:
matrix: ${{ steps.create_matrix.outputs.matrix }}
test:
needs: prepare
runs-on: ubuntu-latest
strategy:
fail-fast: false
matrix:
include: ${{fromJson(needs.prepare.outputs.matrix)}}
# ...
steps:
# ...
- name: Debug matrix
run: |
echo "Python ${{ matrix.python-version }} + Django ${{ matrix.django-version }} + Database ${{ matrix.database }}"Check the full test-action.yaml workflow file.
Released under MIT License.