Metadata-Version: 2.4
Name: django-relatives
Version: 1.4.0
Summary: Utilities for linking to related objects in Django admin
Author: Trey Hunner
Author-email: Trey Hunner <trey@treyhunner.com>
License-Expression: MIT
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Framework :: Django
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.2
Requires-Dist: django>=4.2
Requires-Python: >=3.10
Project-URL: documentation, https://django-relatives.readthedocs.io
Project-URL: repository, https://github.com/treyhunner/django-relatives
Project-URL: issue-tracker, https://github.com/treyhunner/django-relatives/issues
Project-URL: changelog, https://github.com/treyhunner/django-relatives/blob/main/CHANGES.rst
Description-Content-Type: text/x-rst

================
django-relatives
================

.. image:: https://img.shields.io/pypi/v/django-relatives.svg
   :target: https://pypi.org/project/django-relatives/
   :alt: PyPI

.. image:: https://img.shields.io/pypi/pyversions/django-relatives
   :target: https://pypi.org/project/django-relatives
   :alt: Python Version

.. image:: https://img.shields.io/pypi/djversions/django-relatives
   :target: https://pypi.org/project/django-relatives
   :alt: Django Version

.. image:: https://img.shields.io/readthedocs/django-relatives/latest.svg?label=Read%20the%20Docs
   :target: https://django-relatives.readthedocs.io/
   :alt: Read the documentation at https://django-relatives.readthedocs.io/

.. image:: https://github.com/treyhunner/django-relatives/workflows/Tests/badge.svg
   :target: https://github.com/treyhunner/django-relatives/actions?workflow=Tests
   :alt: Tests

.. image:: https://codecov.io/gh/treyhunner/django-relatives/branch/main/graph/badge.svg
   :target: https://codecov.io/gh/treyhunner/django-relatives
   :alt: Codecov

Utilities for linking to related objects in Django admin.


Getting Help
------------

See `the full documentation for django-relatives here <https://django-relatives.readthedocs.org/>`_.

This app is available on `PyPI <https://pypi.python.org/pypi/django-relatives/>`_.

`Submit issues on Github <https://github.com/treyhunner/django-relatives/issues>`_.

Pull requests are welcome.
Read the ``CONTRIBUTING.rst`` file for tips on submitting a pull request.


Screenshots
-----------

.. image:: https://raw.github.com/treyhunner/django-relatives/main/docs/images/relatives_admin_example.png
   :alt: Use hyperlinks for foreign keys on change lists
   :target: https://django-relatives.readthedocs.org/en/latest/usage.html#change-lists

.. image:: https://raw.github.com/treyhunner/django-relatives/main/docs/images/contents_or_fk_link_example.png
   :alt: Use hyperlinks for read-only foreign keys on change forms
   :target: https://django-relatives.readthedocs.org/en/latest/usage.html#change-forms

.. image:: https://raw.github.com/treyhunner/django-relatives/main/docs/images/related_objects_example.png
   :alt: Link to reverse relations from from change forms
   :target: https://django-relatives.readthedocs.org/en/latest/usage.html#reverse-relations

.. image:: https://raw.github.com/treyhunner/django-relatives/main/docs/images/object_edit_link_example.png
   :alt: Add edit links to admin inlines
   :target: https://django-relatives.readthedocs.org/en/latest/usage.html#links-in-inlines


Related Projects
----------------

Thanks to the community for inspiration:

- `linked readonly foreign key code snippet`_
- `django-inlaws`_
- various `StackOverflow answers`_ about related object links in admin

.. _django-inlaws: https://github.com/callowayproject/django-inlaws
.. _stackoverflow answers: http://stackoverflow.com/a/5331032/98187
.. _linked readonly foreign key code snippet: http://djangosnippets.org/snippets/2657/
