Metadata-Version: 2.1
Name: django-gm2m
Version: 0.6.1
Summary: Django generic many-to-many field
Home-page: https://bitbucket.org/tkhyn/django-gm2m
Author: Thomas Khyn
Author-email: thomas@ksytek.com
Keywords: django,generic,many-to-many
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Django
Classifier: Environment :: Other Environment
License-File: LICENSE.txt
Requires-Dist: Django>=1.11

django-gm2m
===========

|copyright| 2014-2018 Thomas Khyn

Django generic many-to-many field implementation.

This django application exposes a ``GM2MField`` that combines
the features of the standard Django ``ManyToManyField`` and
``GenericForeighKey`` and that can be used exactly the same way.

It has been tested with Django 1.11 and 2.0 and the latest minor versions
of Python 2 and 3 (Django 2.0 only supports Python 3).

If you like django-gm2m and are looking for a way to thank me and/or encourage
future development, here is my BTC or BCH donation address:
``1EwENyR8RV6tMc1hsLTkPURtn5wJgaBfG9``.


Features
--------

- Works like the built-in Django related fields
- Creates one table per relation, like ``ManyToManyField``, and not one big
  table linking anything to anything (django-generic-m2m_'s default approach)
- No need to modify nor monkey-patch the existing model classes that need to be
  linked
- Automatic reverse relations when an instance is added
- Related objects prefetching
- Through models support
- Deletion behaviour customization using signals
- Migrations support


Documentation
-------------

The documentation is hosted on readthedocs_. You'll find a quick start and
the description of all django-gm2m's advanced features.



.. |copyright| unicode:: 0xA9

.. _django-generic-m2m: https://pypi.python.org/pypi/django-generic-m2m
.. _readthedocs: http://django-gm2m.readthedocs.io/en/stable
