Skip to main content

migra: Like diff but for Postgres schemas

  • compare schemas

  • autogenerate migration scripts

  • autosync your development database from your application models

  • make your schema changes testable, robust, and (mostly) automatic

migra is a schema diff tool for PostgreSQL, written in Python. Use it in your python scripts, or from the command line like this:

$ migra postgresql:///a postgresql:///b
alter table "public"."products" add column newcolumn text;

alter table "public"."products" add constraint "x" CHECK ((price > (0)::numeric));

migra magically figures out all the statements required to get from A to B.

Most features of PostgreSQL are supported.

Migra supports PostgreSQL >= 9 only. Known issues exist with earlier versions. More recent versions are more comprehensively tested. Development resources are limited, and feature support rather than backwards compatibility is prioritised.

THE DOCS

Documentation is at databaseci.com/docs/migra.

Folks, schemas are good

Schema migrations are without doubt the most cumbersome and annoying part of working with SQL databases. So much so that some people think that schemas themselves are bad!

But schemas are actually good. Enforcing data consistency and structure is a good thing. It’s the migration tooling that is bad, because it’s harder to use than it should be. migra is an attempt to change that, and make migrations easy, safe, and reliable instead of something to dread.

Contributing

Contributing is easy. Jump into the issues, find a feature or fix you'd like to work on, and get involved. Or create a new issue and suggest something completely different. If you're unsure about any aspect of the process, just ask.

Credits

Metadata

Release files for migra 3.0.1658661961

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for migra 3.0.1658661961
File Size Uploaded
migra-3.0.1658661961.tar.gz 10.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for migra 3.0.1658661961
File Interpreter ABI Platform
migra-3.0.1658661961-py3-none-any.whl Python 3 none any Details

Total release size: 20.5 kB

Release files / migra-3.0.1658661961.tar.gz

Download URL migra-3.0.1658661961.tar.gz
Size 10.1 kB
Tags Source
SHA-256 checksum
How to use checksums
f6ccac3a04909bc8e8b71f89c89aecc3c15901338ede534290fc81de4a949224
BLAKE2b-256 checksum
How to use checksums
974117225b17dc5831720538c2acfd2c24463cf6a4dcadc66a3f5f7e2c877b1a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.13 CPython/3.10.5 Linux/5.13.0-1023-aws

Release files / migra-3.0.1658661961-py3-none-any.whl

Download URL migra-3.0.1658661961-py3-none-any.whl
Size 10.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c27ca25e45885bef9c1c3232fe406957ab46da2ec4a861f32bef5126671a43d0
BLAKE2b-256 checksum
How to use checksums
ce97cc0cd2de1e09884a756da83e5b77bb471b118677eab2ed62a99bcc5365f7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.13 CPython/3.10.5 Linux/5.13.0-1023-aws

Release history Release notifications | RSS feed

This release

3.0.1658661961 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page