Opened 6 years ago

Last modified 11 days ago

#29522 new Cleanup/optimization

Make Serializers easier to modify.

Reported by: Levi Cameron Owned by:
Component: Core (Serialization) Version: dev
Severity: Normal Keywords:
Cc: Herbert Fortes, Ian Foote, Ülgen Sarıkavak Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: yes Patch needs improvement: yes
Easy pickings: no UI/UX: no

Description (last modified by Levi Cameron)

Use case

Three times now I've had need to modify the ORM serializers for project use. In some cases I've had to replicate large parts (if not most) of django.core.serializers.python in order to change 1 or 2 lines because certain calls to functions in django.core.serializers.base from the serializers are hardcoded.

  • Changing JSON serialization to output in alphabetical order (so that dumpdata doesn't reorder every field each time you run it)
  • Changing deserialization to use _base_manager instead of _default_manager (due to extra constraints on a custom manager)
  • Implementing fixes for #7202, #7350 before they were merged

Proposal
I propose that instead of calling the following functions directly, the serializer classes are modified to call an instance method of the same name that then calls the existing module-level functions. This would allow the ability to more easily override just one aspect of serializer functionality without having to replicate large swathes of code.

I am not proposing to move these functions into the python serializer class directly because this may break compatibility with existing code that depends on the existing functions.

  • django.core.serializers.base.build_instance
  • django.core.serializers.base.deserializer_m2m_values
  • django.core.serializers.base.deserializer_fk_values
  • django.core.serializers.python._get_model (given that this is already an internal function, implementation can be pushed into the class directly)

(It might also be nice if the json and pyyaml classes could also have PythonDeserializer be made a class attribute but that would involve turning the Deserializer function into a class and is not nearly as much code to override these as the functions above)

If this sounds acceptable, I will submit a patch.

Change History (13)

comment:1 by Levi Cameron, 6 years ago

Description: modified (diff)

comment:2 by Levi Cameron, 6 years ago

Description: modified (diff)

comment:3 by Levi Cameron, 6 years ago

Description: modified (diff)

comment:4 by Carlton Gibson, 6 years ago

Triage Stage: UnreviewedAccepted

This sounds reasonable to me. My main thought would be to make sure the new hooks a properly documented etc. But yes, good idea.

comment:5 by Carlton Gibson, 6 years ago

Summary: Serializers are hard to modifyMake Serializers easier to modify

comment:6 by Herbert Fortes, 6 years ago

Cc: Herbert Fortes added

comment:7 by Emad Mokhtar, 5 years ago

Owner: changed from nobody to Emad Mokhtar
Status: newassigned

comment:8 by Ian Foote, 5 years ago

Cc: Ian Foote added

comment:9 by Emad Mokhtar, 5 years ago

Version 1, edited 5 years ago by Emad Mokhtar (previous) (next) (diff)

comment:10 by Ian Foote, 5 years ago

Has patch: set

comment:11 by Mariusz Felisiak, 5 years ago

Needs tests: set
Patch needs improvement: set
Summary: Make Serializers easier to modifyMake Serializers easier to modify.

comment:12 by Mariusz Felisiak, 3 weeks ago

Owner: Emad Mokhtar removed
Status: assignednew

comment:13 by Ülgen Sarıkavak, 11 days ago

Cc: Ülgen Sarıkavak added
Note: See TracTickets for help on using tickets.
Back to Top