Metadata-Version: 1.1
Name: django-nested-admin
Version: 3.3.0
Summary: Django admin classes that allow for nested inlines
Home-page: https://github.com/theatlantic/django-nested-admin
Author: The Atlantic
Author-email: programmers@theatlantic.com
License: BSD
Description: |build_badge| |docs_badge|
        
        **django-nested-admin** is a project that makes it possible to nest
        admin inlines (that is, to define inlines on InlineModelAdmin classes).
        It is compatible with Django 1.11+ and Python versions 2.7 and 3.4+ and works
        with or without Grappelli. When Grappelli is not installed it allows
        Grappelli-like drag-and-drop functionality.
        
        Installation
        ============
        
        The recommended way to install django-nested-admin is from
        `PyPI <https://pypi.python.org/pypi/django-nested-admin>`_::
        
                pip install django-nested-admin
        
        Alternatively, one can install a development copy of django-nested-admin
        from source::
        
                pip install -e git+git://github.com/theatlantic/django-nested-admin.git#egg=django-nested-admin
        
        If the source is already checked out, use setuptools to install::
        
                python setup.py develop
        
        Configuration
        =============
        
        To use django-nested-admin in your project, ``"nested_admin"`` must be added
        to the ``INSTALLED_APPS`` in your settings:
        
        .. code-block:: python
        
            INSTALLED_APPS = (
                # ...
                'nested_admin',
            )
        
        If you’re using `django-grappelli <https://github.com/sehmaschine/django-grappelli>`_,
        you will also need to add to include ``nested_admin.urls`` in your urlpatterns:
        
        .. code-block:: python
        
            # Django 2+
            urlpatterns = [
                # ...
                path('_nested_admin/', include('nested_admin.urls')),
            ]
        
            # Django < 2
            urlpatterns = [
                # ...
                url(r'^_nested_admin/', include('nested_admin.urls')),
            ]
        
        Example Usage
        =============
        
        In order to use ``django-nested-admin``, use the following classes in
        place of their django admin equivalents:
        
        ========================  ======================
        **django.contrib.admin**  **nested_admin**      
        ------------------------  ----------------------
        ModelAdmin                NestedModelAdmin           
        InlineModelAdmin          NestedInlineModelAdmin
        StackedInline             NestedStackedInline   
        TabularInline             NestedTabularInline
        ========================  ======================
        
        There is also ``nested_admin.NestedGenericStackedInline`` and
        ``nested_admin.NestedGenericTabularInline`` which are the nesting-capable
        versions of ``GenericStackedInline`` and ``GenericTabularInline`` in
        ``django.contrib.contenttypes.admin``.
        
        .. code-block:: python
        
            # An example admin.py for a Table of Contents app
        
            from django.contrib import admin
            import nested_admin
        
            from .models import TableOfContents, TocArticle, TocSection
        
            class TocArticleInline(nested_admin.NestedStackedInline):
                model = TocArticle
                sortable_field_name = "position"
        
            class TocSectionInline(nested_admin.NestedStackedInline):
                model = TocSection
                sortable_field_name = "position"
                inlines = [TocArticleInline]
        
            class TableOfContentsAdmin(nested_admin.NestedModelAdmin):
                inlines = [TocSectionInline]
        
            admin.site.register(TableOfContents, TableOfContentsAdmin)
        
        Testing
        =======
        
        django-nested-admin has fairly extensive test coverage.
        The best way to run the tests is with `tox <https://testrun.org/tox/latest/>`_,
        which runs the tests against all supported Django installs. To run the tests
        within a virtualenv run ``pytest`` from the repository directory. The tests
        require a selenium webdriver to be installed. By default the tests run with
        phantomjs, but it is also possible to run the tests with the chrome webdriver
        by passing ``--selenosis-driver=chrome`` to ``pytest`` or, if running with
        tox, running ``tox -- --selenosis-driver=chrome``. See ``pytest --help`` for
        a complete list of the options available.
        
        Contributing
        ============
        
        This project uses `webpack <https://webpack.js.org/>`_ for building its
        javascript and css. To install the dependencies for the build process, run
        ``npm install`` from the root of the repository. You can then run
        ``npm run build`` to rebuild the static files.
        
        License
        =======
        
        The django code is licensed under the `Simplified BSD
        License <http://opensource.org/licenses/BSD-2-Clause>`_. View the
        ``LICENSE`` file under the root directory for complete license and
        copyright information.
        
        .. |build_badge| image:: https://travis-ci.org/theatlantic/django-nested-admin.svg?branch=master
            :target: https://travis-ci.org/theatlantic/django-nested-admin
        .. |docs_badge| image:: https://readthedocs.org/projects/django-nested-admin/badge/?version=latest
            :target: http://django-nested-admin.readthedocs.org/en/latest/
        
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 2.0
Classifier: Framework :: Django :: 2.1
Classifier: Framework :: Django :: 2.2
