Migrations can be one of the most challenging aspects of deploying a Django application at scale. Depending on the size of tables and flavor of database, some migrations can easily lock some of the most important tables and bring down an application if more scrutiny isn’t applied towards deployed migrations. Along with this, sometimes we must document more critical metadata about a migration before it is even deployed, such as when the migration should run in the deployment process.
django-migration-docs provides the ability to collect more structured information about every migration in your Django project. Along with this, it also automatically collects important metadata about migrations like the raw SQL so that more information is available for reviewers and maintainers of a large project.
When django-migration-docs is installed, users will be prompted for more information about migrations using a completely customizable schema that can be linted in continuous integration. The default prompt looks like the following:
Check out the docs for more information about how to use django-migration-docs in your application.
Documentation
Installation
Install django-migration-docs with:
pip3 install django-migration-docs
After this, add migration_docs to the INSTALLED_APPS setting of your Django project.
Contributing Guide
For information on setting up django-migration-docs for development and contributing changes, view CONTRIBUTING.rst.
1 maintainer
Metadata
1 maintainer
Release files for django-migration-docs 1.0.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| django-migration-docs-1.0.2.tar.gz | 16.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| django_migration_docs-1.0.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 35.4 kB
Release files / django-migration-docs-1.0.2.tar.gz
| Download URL | django-migration-docs-1.0.2.tar.gz |
|---|---|
| Size | 16.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b4f3a9dc75c051093ed970f3ed72bbc24994b77c7385fa861bdb22c5af76f93c
|
|
BLAKE2b-256 checksum How to use checksums |
da4ade4422f223fc1ad12c1dd19f4e4c110e32dedb1fb3e9a6726f8653cfc1d6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.1.12 CPython/3.10.1 Linux/5.13.0-1017-aws
|
Release files / django_migration_docs-1.0.2-py3-none-any.whl
| Download URL | django_migration_docs-1.0.2-py3-none-any.whl |
|---|---|
| Size | 19.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0fbb90674b78c36973b0d2e408327866744a14d20aa6b17e018fa9a4f4dc0c45
|
|
BLAKE2b-256 checksum How to use checksums |
0e3a3ba36585518e63e8f5aaaa57cc51cb87f5eaeefdfbf2bb8af09c752924de
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.1.12 CPython/3.10.1 Linux/5.13.0-1017-aws
|
