Metadata-Version: 2.1
Name: django-migration-docs
Version: 1.0.5
Summary: Sync and validate additional information about your Django migrations.
Home-page: https://github.com/Opus10/django-migration-docs
License: BSD-3-Clause
Author: Juliana de Heer
Requires-Python: >=3.7.0,<4
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: django (>=2)
Requires-Dist: formaldict (>=1.0.0)
Requires-Dist: importlib_metadata (>=4); python_version >= "3.7" and python_version < "3.8"
Requires-Dist: jinja2 (>=2.11.3)
Requires-Dist: pyyaml (>=5.4)
Project-URL: Documentation, https://django-migration-docs.readthedocs.io
Project-URL: Repository, https://github.com/Opus10/django-migration-docs
Description-Content-Type: text/x-rst

django-migration-docs
#####################

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:


.. image:: https://raw.githubusercontent.com/jyveapp/django-migration-docs/master/docs/_static/sync.gif
    :width: 600

Check out the `docs <https://django-migration-docs.readthedocs.io/>`__ for more information
about how to use ``django-migration-docs`` in your application.

Documentation
=============

`View the django-migration-docs docs here
<https://django-migration-docs.readthedocs.io/>`_.

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 <CONTRIBUTING.rst>`_.


Primary Authors
===============

- @juemura (Juliana de Heer)
- @wesleykendall (Wes Kendall)
- @tomage (Tómas Árni Jónasson)

