Skip to main content

Django management commands for project-wide (editable) migrations.

Project description

License Build Status Latest PyPI version Coverage

Django management commands for project-wide (editable) migrations.

Overview

The django-migrate-project app aims to add management commands to make running full project migrations more sane and controllable. The concept is pretty simple: first collect any unapplied migrations into per-app migration files, then review and modify as need be, and finally apply the migrations.

By staging and consolidating unapplied migrations in a way that they can be edited and reviewed before applying, more confidence is gained that a rogue migration won’t damage production tables. The collected and consolidated migrations are listed as replacements for the individual app migrations they represent so once they have been applied everything is in the same state as if the individual app migrations has been applied via ‘migrate’.

Requirements

Requires Django 1.7+ and as such Python 2.7+ as well

Installation

Simply use pip to install:

$ pip install django-migrate-project

To be of any use django-migrate-project must be added to the Django project via INSTALLED_APPS in the project settings.py file:

INSTALLED_APPS = (
    ...
    'django_migrate_project',
    ...
)

Usage

Two new management commands provide the core functionality. To gather up any unapplied migrations for the project simply run:

$ python manage.py collectmigrations

The default collection location is BASE_DIR/pending_migrations. If the project’s settings.py does not have a BASE_DIR then a directory path must be provided using the --output-dir option.

The collected migrations are grouped per-app and have the filename format of <app_label>_project.py. These files can be edited to taste in order to change the migration, the only important bit is to keep the replaces and dependencies fields in the migration the same, as those allow the bookkeeping to be kept accurate.

Collected migrations are applied via:

$ python manage.py applymigrations

The default directory path is used again if possible, otherwise the path must be provided via the --input-dir option.

Finally, migrations can be unapplied easily as well, returning the migration state to what it was before by running:

$ python manage.py applymigrations --unapply

Experimental

Starting with v0.2.0 there’s also the capability to generate project-level migrations as a way to capture monkey-patched models and other changes that shouldn’t create migrations in a third-party app.

To use this functionality, first create a top-level migrations directory with a __init__.py file to make it a Python package. Then run the following command to create any new project-level migrations (changes not present in third-party app migrations):

$ python manage.py makeprojectmigrations

Assuming there are any migrations to generate, the top-level migrations directory should now be populated and you can migrate the project using:

$ python manage.py migrateproject

As with the applymigrations command, migrateproject also has an easy unapply functionality:

$ python manage.py migrateproject --unapply

While this functionality is well covered by tests it will remain ‘experimental’ until it gets a bit more real world use.

Contributing

Contributions are welcome, just create a pull request or issue on the GitHub repository for the project.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-migrate-project-0.2.0.tar.gz (14.1 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file django-migrate-project-0.2.0.tar.gz.

File metadata

File hashes

Hashes for django-migrate-project-0.2.0.tar.gz
Algorithm Hash digest
SHA256 b78518b4681c866b286616917687903ba13b235fcdba377940aab631f9a9ec21
MD5 f5f47f1e9d9802ed06f76f9ebf69079b
BLAKE2b-256 d20e8967f62784b3ea2168fed8ed27545e668a3a53fc9b95c869563265b46f96

See more details on using hashes here.

File details

Details for the file django-migrate-project-0.2.0.linux-x86_64.tar.gz.

File metadata

File hashes

Hashes for django-migrate-project-0.2.0.linux-x86_64.tar.gz
Algorithm Hash digest
SHA256 f0120bc3d748ebd0b548bf1f1700a66dc6e021b37949b8bc743ba45ee6b8375c
MD5 a82e8112d6d89c7c74fcb0f6c07f945f
BLAKE2b-256 83c19dcd902af17348da0628f23d09f4b3e1da83aac5a52492231770cb27c45c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page