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 >= 10 only. Known issues exist with earlier versions. Development resources are limited, and feature support rather than backwards compatibility is prioritised.

THE DOCS

Documentation is at databaseci.com/docs/migra. Note that the docs have moved to databaseci.com. If you're wondering what that's about, read the blog post here (https://databaseci.com/blog/hello-world).

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 1.0.1597915807

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 1.0.1597915807
File Size Uploaded
migra-1.0.1597915807.tar.gz 9.4 kB Details

Built distribution (wheel)

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

Total release size: 19.2 kB

Release files / migra-1.0.1597915807.tar.gz

Download URL migra-1.0.1597915807.tar.gz
Size 9.4 kB
Tags Source
SHA-256 checksum
How to use checksums
7ffa93773127d139daa34893b163e8d06650843b1e29200a07cb4793f74b74ae
BLAKE2b-256 checksum
How to use checksums
099b6eaceede328fabbf30311b4620460be566e9841ec0ab9e542e4c5d52c554
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.0.5 CPython/3.8.2 Linux/4.15.0-1077-aws

Release files / migra-1.0.1597915807-py2.py3-none-any.whl

Download URL migra-1.0.1597915807-py2.py3-none-any.whl
Size 9.8 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
f79056aa8546ebfe0e9f5c1ee7d01c86c84a828a538fb08925ec8355c1a52d7f
BLAKE2b-256 checksum
How to use checksums
da05b51d7264454bb643389dde9ec19e459ed5f0816a4439e4764bf7a1e09ac6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.0.5 CPython/3.8.2 Linux/4.15.0-1077-aws

Release history Release notifications | RSS feed

This release

1.0.1597915807 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