2.5.1

What's Changed

• Correct serializer generation to add allow_null=True to reverse one-to-one relationships (#114)
• Added Python 3.14 to the test matrix and dropped Python 3.9

For full details see the changelog.

Release 2.5.0

Added

• Added qs.alias function to support the .alias() QuerySet method (#109).
• Added pairs.alias function to support aliasing in a spec. (#112).

Release 2.4.0

Added

• Added support for using Python type objects instead of serializer fields in schema generation code (#106)
• Added Django 5.2 and Python 3.13 to test matrix (#107)

Release 2.3.0

Added

• Added support for overriding field kwargs for autogenerated serializer fields via out mechanism (#99).

Release 2.2.0

Added

• Added support for Django's reverse generic relations (GenericRelation model field) (#93).

Changed

• Add support for Django 5.0

Release 2.1.2

Fixed

• Fix an error when using the @out decorator on producer functions that return values like booleans, that can't have arbitrary attributes added to them (#86).

Changed

• Add support for Django 4.2
• Drop support for Python 3.7

Release 2.1.1

Fixed

• Correctly set the allow_null attribute on nested serializers (#81)

Release 2.1.0

Changed

• Add support for Django 4.1
• Drop support for Django 2.2
• Add support for Python 3.11
• Drop support for Python 3.6

Added

• In the Django REST framework layer, callables in a spec are now automatically called and passed the request object (#76)
• Support for generating a Django REST framework serializer from a spec, and for annotating custom pairs in a spec with their output field types. This enables automatic schema generation. (#76)

Release 2.0.0

Changed

• BACKWARDS INCOMPATIBLE: The default value of the distinct argument for the pairs.count and pairs.has functions has changed from True to False. This now matches the default value of the distinct arguments to Django's Count annotation. To retain current behaviour, add distinct=True to all calls to these two functions in your codebase. For background on this decision, see this discussion.

Added

• Proper documentation! https://www.django-readers.org
• New pairs.annotate function allowing you to annotate a queryset with aggregates, functions etc and produce the result.
• New pairs.sum function to annotate a queryset with the Sum aggregate function and produce the result.

Release 1.1.0

Added

• New pairs.discard_queryset_function and pairs.discard_projector functions to discard one or other item in a reader pair.

Changed

• SpecMixin now applies prepare function in get_queryset, not filter_queryset