{"id":22117725,"url":"https://github.com/kineticcafe/docker-sqitch-pgtap","last_synced_at":"2025-07-25T11:32:40.461Z","repository":{"id":40471600,"uuid":"367514364","full_name":"KineticCafe/docker-sqitch-pgtap","owner":"KineticCafe","description":"Run sqitch and pgTAP for PostgreSQL without installing them from docker","archived":false,"fork":false,"pushed_at":"2024-10-07T19:50:26.000Z","size":522,"stargazers_count":5,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-11-24T19:58:00.178Z","etag":null,"topics":["docker-image","pgtap","postgresql","postgresql-client","sqitch"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KineticCafe.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-15T01:18:32.000Z","updated_at":"2024-10-07T19:50:29.000Z","dependencies_parsed_at":"2024-02-04T21:06:16.069Z","dependency_job_id":"d27d4386-d7d5-4491-8bab-71dc50ac9903","html_url":"https://github.com/KineticCafe/docker-sqitch-pgtap","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KineticCafe%2Fdocker-sqitch-pgtap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KineticCafe%2Fdocker-sqitch-pgtap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KineticCafe%2Fdocker-sqitch-pgtap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KineticCafe%2Fdocker-sqitch-pgtap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KineticCafe","download_url":"https://codeload.github.com/KineticCafe/docker-sqitch-pgtap/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227570042,"owners_count":17787838,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["docker-image","pgtap","postgresql","postgresql-client","sqitch"],"created_at":"2024-12-01T13:38:55.843Z","updated_at":"2025-07-25T11:32:40.443Z","avatar_url":"https://github.com/KineticCafe.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# [ghcr.io/]kineticcafe/sqitch-pgtap: Sqitch/PostgreSQL \u0026 pgTAP in Docker\n\n\u003e [!IMPORTANT]\n\u003e\n\u003e This image will no longer receive updates and the repo is being archived as we\n\u003e no longer use Sqitch or pgTAP. I recommend forking this repo if you wish to\n\u003e maintain a similar image for your organization as the architecture and actions\n\u003e work very well.\n\u003e\n\u003e Kinetic Cafe open source team\n\nThis is a simple Docker container that contains [sqitch][sqitch],\n[pgTAP][pgTAP], and [`pg_prove`][`pg_prove`] for use with PostgreSQL. It has\nbeen created so that it's easier to work with `sqitch` and `pg_prove`/`pgTAP`\nwithout going through the effort of installing them on various systems.\n\nThe image is based on Alpine 3.19 and does not include a PostgreSQL server;\ninstead, it is expected that all values will be provided through environment\nvariables or on the command-line.\n\nUnless otherwise noted, pgTAP will be installed from [PGXN][PGXN].\n\nThis version of the container includes:\n\n- pgTAP 1.3.3 (from theory/pgtap@02bc769c92c48d01e4c2f76db6523287017b45a9)\n  - Full support for PostgreSQL 12, 13, 14, 15, 16, and 17\n  - Best effort support for end of life PostgreSQL versions 9.6, 10, 11, and 12\n- pg\\_prove 3.36\n- Sqitch 1.5.0\n\nThe version of pgTAP is installed and uninstalled as needed; unit test files\n_**must not**_ include `CREATE EXTENSION pgtap`.\n\nThese images can be pulled either from Docker Hub\n(`kineticcafe/sqitch-pgtap:2.7`) or the GitHub Container Registry\n(`ghcr.io/kineticcafe/sqitch-pgtap:2.7`).\n\n## `kineticcafe-sqitch-pgtap` script Commands\n\nThe `kineticcafe-sqitch-pgtap` script is recommended for running everything as\nit manages environment variable configuration for each run. The\n`kineticcafe-sqitch-pgtap` script will pull from\n`ghcr.io/kineticcafe/sqitch-pgtap:2` by default; this can be overridden by using\n`$IMAGE`:\n\n```console\n$ IMAGE=kineticcafe/sqitch-pgtap:latest ./run version\n[gchr.io/]kineticcafe/sqitch-pgtap:2.10.0\n\n  alpine 3.21\n  sqitch (App::Sqitch) v1.5.0\n  pgtap 1.3.3\n  pg_prove 3.36\n\nLast updated 2025-01-07\n```\n\n### Installing `kineticcafe-sqitch-pgtap`\n\n`kineticcafe-sqitch-pgtap` can be installed with symlinks using the `install`\nscript:\n\n```sh\ncurl -sSL --fail \\\n  https://raw.githubusercontent.com/KineticCafe/docker-sqitch-pgtap/main/install |\n  bash -s -- ~/.local/bin\n```\n\nReplace `~/.local/bin` with your preferred binary directory.\n\nBy default, it will download `kineticcafe-sqitch-pgtap` from GitHub and install\nit in the provided `TARGET` and make symbolic links for the following commands:\n`sqitch`, `sqitcher`, and `pgtap`. Symbolic link creation will not overwrite\nfiles or symbolic links to locations _other_ than `TARGET/kinetic-sqitch-pgtap`.\n\n`sqitcher` is a shorter name for `kineticcafe-sqitch-pgtap`.\n\n`--no-symlinks` (`-S`) may be specified to skip symbolic link creation entirely.\n\n`--force` (`-f`) may be specified to install `kineticcafe-sqitch-pgtap` even if\nit already exists, and to overwrite files and\nnon-`TARGET/kineticcafe-sqitch-pgtap` symbolic links.\n\n`--verbose` (`-v`) will turn on trace output of commands.\n\n### Core commands\n\n- `sqitch`: Runs Sqitch\n- `pg_prove`: Runs `pg_prove` directly\n- `pgtap install`: Installs pgTAP in the current database\n- `pgtap uninstall`: Uninstalls pgTAP from the current database\n- `pgtap test`: Installs pgTAP, runs `pg_prove`, and then uninstalls pgTAP\n- `version`: Prints the versions of the applications\n\n### PostgreSQL commands\n\n- `createdb`\n- `dropdb`\n- `psql`\n- `pg_config`\n- `pg_controldata`\n- `pg_ctl`\n- `pg_archivecleanup`\n- `pg_basebackup`\n- `pg_dump`\n- `pg_dumpall`\n- `pg_restore`\n- `pg_isready`\n- `pg_standby`\n- `pg_test_fsync`\n- `pg_test_timing`\n- `pg_recvlogical`\n- `pg_rewind`\n- `pg_upgrade`\n- `pg_receivexlog`\n- `pg_resetxlog`\n- `pg_xlogdump`\n\n### Extra commands\n\n- `sh`: Start a shell in the image\n- `jq`: Runs jq\n- `nano`: Runs nano\n- `show-targets`: Shows configured sqitch targets\n- `show-default-target`: Shows the configured default target\n- `show-default-dbname`: Shows the configured default target database name\n- `pgtap-tests`: Runs `pgtap test test/*.sql` for the default database\n\n[`pg_prove`]: https://pgtap.org/pg_prove.html\n[pgtap]: https://pgtap.org\n[pgxn]: https://pgxn.org/dist/pgtap/\n[sqitch]: https://sqitch.org\n[theory/tap-parser-sourcehandler-pgtap]: https://github.com/theory/tap-parser-sourcehandler-pgtap\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkineticcafe%2Fdocker-sqitch-pgtap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkineticcafe%2Fdocker-sqitch-pgtap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkineticcafe%2Fdocker-sqitch-pgtap/lists"}