{"id":32467717,"url":"https://github.com/jfhovinne/podmatrix","last_synced_at":"2026-05-18T10:09:31.382Z","repository":{"id":65705902,"uuid":"596276297","full_name":"jfhovinne/podmatrix","owner":"jfhovinne","description":"Parallel execution of commands within a matrix of Podman containers","archived":false,"fork":false,"pushed_at":"2023-02-05T20:37:59.000Z","size":22,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2023-03-24T18:37:59.128Z","etag":null,"topics":["automation","bash","bashly","ci-cd","containers","lightweight","parallel-processing","podman","test-matrix","testing"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jfhovinne.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2023-02-01T20:49:35.000Z","updated_at":"2023-02-05T21:22:22.000Z","dependencies_parsed_at":"2023-02-19T01:15:39.920Z","dependency_job_id":null,"html_url":"https://github.com/jfhovinne/podmatrix","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"purl":"pkg:github/jfhovinne/podmatrix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jfhovinne%2Fpodmatrix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jfhovinne%2Fpodmatrix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jfhovinne%2Fpodmatrix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jfhovinne%2Fpodmatrix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jfhovinne","download_url":"https://codeload.github.com/jfhovinne/podmatrix/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jfhovinne%2Fpodmatrix/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33174091,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-18T09:27:30.708Z","status":"ssl_error","status_checked_at":"2026-05-18T09:27:28.300Z","response_time":71,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","bash","bashly","ci-cd","containers","lightweight","parallel-processing","podman","test-matrix","testing"],"created_at":"2025-10-26T14:27:02.650Z","updated_at":"2026-05-18T10:09:31.376Z","avatar_url":"https://github.com/jfhovinne.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# podmatrix\n\nA script which executes commands within a 'matrix' of Podman containers.\n\nOne purpose would be to quickly spawn containers and launch an application\ntest suite within those containers, against multiple versions of a specific\nprogramming language.\n\nThe containers are created in sequence, then commands are executed in parallel.\n\n`podmatrix` is fast and only requires Bash and rootless Podman.\n\nThe script exit code is the sum of executed commands exit codes, which means 0\nif everything went fine.\n\nUse `echo $?` to display it after execution.\n\n## Requirements\n\n* [GNU bash](https://www.gnu.org/software/bash/) 4+\n* [Podman](https://podman.io/)\n\n## Install\n\n```\nwget https://raw.githubusercontent.com/jfhovinne/podmatrix/master/podmatrix \u0026\u0026 chmod +x podmatrix\n```\n\n## Usage\n\n```\n$ podmatrix\npodmatrix - A script which executes commands within a 'matrix' of Podman containers\n\nUsage:\n  podmatrix COMMAND\n  podmatrix [COMMAND] --help | -h\n  podmatrix --version | -v\n\nCommands:\n  exec   Execute a command inside Podman containers\n```\n\n### exec command\n\n```\n$ podmatrix exec --help\npodmatrix exec - Execute a command inside Podman containers\n\nAlias: e\n\nUsage:\n  podmatrix exec COMMAND [OPTIONS]\n  podmatrix exec --help | -h\n\nOptions:\n  --help, -h\n    Show this help\n\n  --source, -s SOURCE\n    Local source path to copy into containers\n\n  --target, -t TARGET\n    Container path to copy source to and where command will be executed\n\n  --image, -i IMAGE (repeatable)\n    The container image to run\n\n  --tag TAG (repeatable)\n    The container image tag to run\n    Default: latest\n\nArguments:\n  COMMAND\n    The command to execute\n\nExamples:\n  podmatrix exec ./test.sh --source . --target /tmp/src --image python --tag 3.9\n  --tag 3.10 --tag 3.11\n  podmatrix exec ./test.sh --source . --target /tmp/src --image python --image\n  docker.io/pypy --tag 3.8 --tag 3.9\n```\n\n## Examples\n\nCurrent directory contains a Python application and a `test.sh` script which\nbuilds and tests it.\n\nTo test it with different Python versions:\n\n```\npodmatrix exec ./test.sh --source . --target /tmp/src --image python \\\n--tag 3.9 --tag 3.10 --tag 3.11\n```\n\nTo test it with different Python versions and flavors:\n\n```\npodmatrix exec ./test.sh --source . --target /tmp/src --image python --image\ndocker.io/pypy --tag 3.8 --tag 3.9\n```\n\nTest installation of a PHP package with different versions of Composer:\n\n```\npodmatrix exec \"composer require monolog/monolog\" --image docker.io/composer \\\n--tag 1.10 --tag 2.2 --tag 2.3 --tag 2.4 --tag 2.5\n```\n\nCompare installation of the curl package in Debian and Ubuntu (why not):\n\n```\npodmatrix exec \"apt update \u0026\u0026 apt install -y curl\" \\\n--image debian --image ubuntu \u003e curl.log\n```\n\nClone a Python app repository and install its dependencies:\n\n```\npodmatrix exec \"git clone https://github.com/jfhovinne/gnrt \u0026\u0026 cd gnrt \u0026\u0026 pip install -r requirements.txt\" \\\n--image python --tag 3.11 --tag 3.12.0a4\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjfhovinne%2Fpodmatrix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjfhovinne%2Fpodmatrix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjfhovinne%2Fpodmatrix/lists"}