h+dZddlmZddlmZddlmZddlmZGdde Z Gdd e Z Gd d e Z Gd d e Z Gdde Zy)a0**DEPRECATED**: Manipulators that can edit SON objects as they enter and exit a database. The :class:`~pymongo.son_manipulator.SONManipulator` API has limitations as a technique for transforming your data. Instead, it is more flexible and straightforward to transform outgoing documents in your own code before passing them to PyMongo, and transform incoming documents after receiving them from PyMongo. SON Manipulators will be removed from PyMongo in 4.0. PyMongo does **not** apply SON manipulators to documents passed to the modern methods :meth:`~pymongo.collection.Collection.bulk_write`, :meth:`~pymongo.collection.Collection.insert_one`, :meth:`~pymongo.collection.Collection.insert_many`, :meth:`~pymongo.collection.Collection.update_one`, or :meth:`~pymongo.collection.Collection.update_many`. SON manipulators are **not** applied to documents returned by the modern methods :meth:`~pymongo.collection.Collection.find_one_and_delete`, :meth:`~pymongo.collection.Collection.find_one_and_replace`, and :meth:`~pymongo.collection.Collection.find_one_and_update`. )DBRefObjectId)abcSONc"eZdZdZdZdZdZy)SONManipulatorziA base son manipulator. This manipulator just saves and restores objects without changing them. cy)aeWill this SON manipulator make a copy of the incoming document? Derived classes that do need to make a copy should override this method, returning True instead of False. All non-copying manipulators will be applied first (so that the user's document will be updated appropriately), followed by copying manipulators. Fselfs Z/var/www/html/ranktracker/api/venv/lib/python3.12/site-packages/pymongo/son_manipulator.py will_copyzSONManipulator.will_copy0sc<|jr t|S|S)zManipulate an incoming SON object. :Parameters: - `son`: the SON object to be inserted into the database - `collection`: the collection the object is being inserted into rrrson collections rtransform_incomingz!SONManipulator.transform_incoming: >> s8O rc<|jr t|S|S)zManipulate an outgoing SON object. :Parameters: - `son`: the SON object being retrieved from the database - `collection`: the collection this object was stored in rrs rtransform_outgoingz!SONManipulator.transform_outgoingErrN)__name__ __module__ __qualname____doc__rrrr rrr r *s   rr ceZdZdZdZy)ObjectIdInjectorzA son manipulator that adds the _id field if it is missing. .. versionchanged:: 2.7 ObjectIdInjector is no longer used by PyMongo, but remains in this module for backwards compatibility. c(d|vr t|d<|S)z+Add an _id field if it is missing. _idrrs rrz#ObjectIdInjector.transform_incomingYs|!CJ rNrrrrrr rrr r Qs rr ceZdZdZdZdZy)ObjectIdShufflerzfdfdt|S)z0Replace embedded documents with DBRefs. ct|tjr1d|vrd|vrt|d|dSt |St|t r|Dcgc] }| c}S|Scc}w)Nr"r.) isinstancerMutableMappingrrlist)valuevtransform_dicttransform_values rr@z9AutoReference.transform_incoming..transform_valuess%!3!34E>eun uuU|/LMM)#e*55E4(49:q*::L;s!A5cN|jD]\}}|||<|Sr3itemsobjectkeyr=r@s rr?z8AutoReference.transform_incoming..transform_dict/ &  5 e-e4s  5Mrrrrrr?r@s @@rrz AutoReference.transform_incomings   c#h''rcBfdfdt|S)z0Replace DBRefs with embedded documents. c t|trjj|St|tr|Dcgc] }| c}St|t j rt|S|Scc}wr3)r:rr4 dereferencer<rr;r)r=r>rr?r@s rr@z9AutoReference.transform_outgoing..transform_valuesk%'}}0077E4(49:q*::E3#5#56%c%j11L;sBcN|jD]\}}|||<|Sr3rBrDs rr?z8AutoReference.transform_outgoing..transform_dictrGrrrHs` @@rrz AutoReference.transform_outgoings   c#h''rN)rrrrr6rrrr rrr1r1s  (*(rr1N)r bson.dbrefr bson.objectidrbson.py3compatrbson.sonrrEr r r%r,r1r rrrQsU*"$V$N ~ &~&=(N=(r