https://github.com/mikewolfd/django-gm2m

https://github.com/mikewolfd/django-gm2m

Last synced: 7 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/mikewolfd/django-gm2m
• Owner: mikewolfd
• License: mit
• Created: 2017-12-01T17:27:51.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2017-12-01T17:28:13.000Z (about 7 years ago)
• Last Synced: 2024-11-14T18:47:29.151Z (about 2 months ago)
• Language: Python
• Size: 271 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.rst
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
django-gm2m

===========

|copyright| 2014-2017 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.8, 1.10 and 1.11 and the latest minor

versions of Python (2.7 and 3.5 or 3.6).

If you like django-gm2m and are looking for a way to thank me and/or encourage

future development, you can send a few mBTC at this Bitcoin 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