fabiocaccamo/create-matrix-actionPublic

NotificationsYou must be signed in to change notification settings
Fork1
Star12

🧪 💥 GitHub action that creates a non-square matrix parsing a readable config.

License

MIT license

12 stars 1 fork Branches Tags Activity

Star

Notifications

You must be signed in to change notification settings

Use this GitHub action with your project

Add this Action to an existing workflow or create a new one

View on Marketplace

Branches Tags

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 84 Commits
.github		.github
tests		tests
.gitignore		.gitignore
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
action.yml		action.yml
pyproject.toml		pyproject.toml
requirements-test.txt		requirements-test.txt
requirements.txt		requirements.txt
script.py		script.py

Repository files navigation

create-matrix-action

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.

Matrix configuration

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-version anddatabase are just the matrix variable names that we can access in the following step, so it is possible to name these variables as needed.

Workflow

Example:

# ...jobs:prepare:runs-on:ubuntu-lateststeps:      -name:Checkout codeuses:actions/checkout@v2      -name:Create matrixid:create_matrixuses:fabiocaccamo/create-matrix-action@v3with: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:prepareruns-on:ubuntu-lateststrategy:fail-fast:falsematrix:include:${{fromJson(needs.prepare.outputs.matrix)}}# ...steps:# ...      -name:Debug matrixrun:|          echo "Python ${{ matrix.python-version }} + Django ${{ matrix.django-version }} + Database ${{ matrix.database }}"