A version migration tool written in Bash for applying upgrades from a source to a target, commonly used for PostgreSQL database schema and data migrations. Current stable version is 1.0.0. It follows a release cadence of manual releases via GitHub. Key differentiators: it is source- and target-agnostic via a simple Bash function interface, supports both incremental and from-scratch migrations, and includes a built-in filetree source and psql target. It is minimal and fast compared to heavier alternatives like Flyway or Liquibase.
npm install clunky-migration-toolNo compatibility data collected yet for this library.
Verified import paths — ran on the pinned version, not inferred.
Installs the tool, sets up a PostgreSQL target, and runs a migration to the latest version, followed by a dry-run to a specific version.
Ensure /bin/bash is version 4 or later. On macOS, use 'brew install bash' and set shebang accordingly.
Wrap all migration SQL in a single transaction; the tool expects target_accept_changes to be transactional.
Use version names like 'v1', 'v2', etc., avoiding reserved words.
Never modify source/target implementations during a migration run.
Ensure the source file is in the expected directory and sourced properly: source ./mysource.sh
Install postgresql client (e.g., apt-get install postgresql-client) or adjust PATH.
Check the target script for unbalanced quotes or backticks, and ensure proper Bash syntax.