rest-framework-generic-relations

What it is and what it does

This package extends Django REST Framework with serializers for handling generic foreign keys—the polymorphic relationships Django allows via ContentType and object_id pairs. It provides two main components: one maps model types to their respective serializers for serializing a single generic relationship to any of several possible models, and another handles serializing mixed lists of different model instances, delegating to the appropriate serializer based on each object's type.

The library is designed for scenarios where a single model field points to multiple unrelated model types. It handles both read and write operations, though write support relies on the nested serializers' ability to deserialize. The package is stable and maintained for bug fixes and compatibility updates, though no major feature development is planned.

Use it for

• Tag or annotation systems where tags can be attached to multiple unrelated model types.
• Activity feeds or audit logs that record actions on different model types in a single list.
• API endpoints returning mixed collections of different model types.
• Polymorphic relationships where a single foreign key field must point to one of several model types.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

rest-framework-generic-relations on PyPI

Before you install

Low friction install with a single runtime dependency on djangorestframework. Maintenance is dormant—the maintainer explicitly states no major changes are planned, though reported bugs are addressed and compatibility is kept current with recent Python and Django versions.

Requires Django 3.2+, Django REST Framework 3.12+, and Python 3.8+. You must add the package to INSTALLED_APPS.

License in practice

Licensed under BSD (permissive), so you can use, modify, and distribute freely with minimal restrictions.

Quickstart

pip install rest-framework-generic-relations

# In Django settings.py
INSTALLED_APPS = (
    ...,
    'rest_framework_generic_relations',
)

# In your serializer
from rest_framework_generic_relations.relations import GenericRelatedField

class TagSerializer(serializers.ModelSerializer):
    tagged_object = GenericRelatedField({
        Bookmark: BookmarkSerializer(),
        Note: NoteSerializer()
    })
    class Meta:
        model = TaggedItem
        fields = ('tag_name', 'tagged_object')

Package facts

Evidence: rest_framework_generic_relations-2.2.0-py3-none-any.whl

Tags

More Dynamic Content packages

See also drf-writable-nested · django-rest-polymorphic · drf-rw-serializers · django-modelcluster · swapper · drf-extra-fields · drf-dynamic-fields · django-rest-multiple-models · djangorestframework-dataclasses · djangorestframework-bulk