Mongodb migrations using Python.
Since mongodb is schema-less most of the time you can do without data migrations.
Sometimes tho you want to create some new entities, or migrate old data instead adding another IF statement to your code.
This is where pymongo-migrate comes in.
Usage: pymongo-migrate [OPTIONS] COMMAND [ARGS]...
Options:
--help Show this message and exit.
Commands:
downgrade apply necessary downgrades to reach target migration
graph
migrate automagically apply necessary upgrades or downgrades to reach
target migration
show show migrations and their status
upgrade apply necessary upgrades to reach target migration
The most used command will be migrate, which works can be called like this:
$ pymongo-migrate migrate -u 'mongodb://localhost/test_db' -m tests/migrations
Use pymongo-migrate command --help to learn more about particular command.
Contributions and raising Issues is welcome; standard netiquette rules apply.
Use make init to setup the project for development.
To format your code & test your changes run:
make check
ATM there seem only two active python projects like this:
So if something already existed, why then another project?
Goals of this project, where at least one of them were not fullfilled by above:
- tests and CI pipeline for ensuring that tool indeed works
- keeping it usable both as standalone tool and as python dependency
- use of modern Python version (3.6 and above)
- which allows use of type annotations, dataclasses, f-strings and other goodies
Other than Alternatives mentioned above, both alembic and django were used as references when designing this tool.
For now only linear revision history is supported. The support for squash migrations is planned.