hrDdZddlmZddlmZddlmZmZmZddl m Z ddl m Z m Z mZGddeZGd d eZGd d eZGd deZGddeZGddeZGddeZGddeZy)zOperation class definitions.) string_type)helpers)validate_booleanvalidate_is_mapping validate_list)validate_collation_or_none)_gen_index_name_index_document _index_listc2eZdZdZdZdZdZdZdZdZ y) InsertOnez#Represents an insert_one operation._docc||_y)zCreate an InsertOne instance. For use with :meth:`~pymongo.collection.Collection.bulk_write`. :Parameters: - `document`: The document to insert. If the document is missing an _id field one will be added. Nr)selfdocuments U/var/www/html/ranktracker/api/venv/lib/python3.12/site-packages/pymongo/operations.py__init__zInsertOne.__init__s  c:|j|jy)3Add this operation to the _Bulk instance `bulkobj`.N) add_insertrrbulkobjs r _add_to_bulkzInsertOne._add_to_bulk)s499%rc"d|jdS)Nz InsertOne()rrs r__repr__zInsertOne.__repr__-s"&))--rcnt|t|k(r|j|jk(StSN)typerNotImplementedrothers r__eq__zInsertOne.__eq__0s+ ;$t* $::* *rc||k( Sr!r$s r__ne__zInsertOne.__ne__55=  rN __name__ __module__ __qualname____doc__ __slots__rrrr&r)r(rrr r s#-I &. !rr c4eZdZdZdZd dZdZdZdZdZ y) DeleteOnez"Represents a delete_one operation._filter _collation_hintNc| td||%t|tstj|}||_||_||_y)acCreate a DeleteOne instance. For use with :meth:`~pymongo.collection.Collection.bulk_write`. :Parameters: - `filter`: A query that matches the document to delete. - `collation` (optional): An instance of :class:`~pymongo.collation.Collation`. This option is only supported on MongoDB 3.4 and above. - `hint` (optional): An index to use to support the query predicate specified either by its string name, or in the same format as passed to :meth:`~pymongo.collection.Collection.create_index` (e.g. ``[('field', ASCENDING)]``). This option is only supported on MongoDB 4.4 and above. .. versionchanged:: 3.11 Added the ``hint`` option. .. versionchanged:: 3.5 Added the `collation` option. Nfilterr isinstancerrr r4r5r6rr8 collationhints rrzDeleteOne.__init__>I,   & 1  dK0..t4 # rcj|j|jd|j|jy)rr<r=N add_deleter4r5r6rs rrzDeleteOne._add_to_bulk]*4<<doo $   ,rc<d|jd|jdS)Nz DeleteOne(, rr4r5rs rrzDeleteOne.__repr__bs&*llDOODDrct|t|k(r1|j|jf|j|jfk(StSr!r"r4r5r#r$s rr&zDeleteOne.__eq__eD ;$t* $]]E$4$45\\4??34 5rc||k( Sr!r(r$s rr)zDeleteOne.__ne__kr*rNNr+r(rrr2r29s$,2I>, E !rr2c4eZdZdZdZd dZdZdZdZdZ y) DeleteManyz#Represents a delete_many operation.r3Nc| td||%t|tstj|}||_||_||_y)aeCreate a DeleteMany instance. For use with :meth:`~pymongo.collection.Collection.bulk_write`. :Parameters: - `filter`: A query that matches the documents to delete. - `collation` (optional): An instance of :class:`~pymongo.collation.Collation`. This option is only supported on MongoDB 3.4 and above. - `hint` (optional): An index to use to support the query predicate specified either by its string name, or in the same format as passed to :meth:`~pymongo.collection.Collection.create_index` (e.g. ``[('field', ASCENDING)]``). This option is only supported on MongoDB 4.4 and above. .. versionchanged:: 3.11 Added the ``hint`` option. .. versionchanged:: 3.5 Added the `collation` option. Nr8r9r;s rrzDeleteMany.__init__tr>rcj|j|jd|j|jy)rrrANrBrs rrzDeleteMany._add_to_bulkrDrc<d|jd|jdS)Nz DeleteMany(rFrrGrs rrzDeleteMany.__repr__s'+||T__EErct|t|k(r1|j|jf|j|jfk(StSr!rIr$s rr&zDeleteMany.__eq__rJrc||k( Sr!r(r$s rr)zDeleteMany.__ne__r*rrLr+r(rrrNrNos$-2I>, F !rrNc8eZdZdZdZ d dZdZdZdZdZ y) ReplaceOnez#Represents a replace_one operation.)r4r_upsertr5r6Nc| td|| td||%t|tst j |}||_||_||_||_ ||_ y)aCreate a ReplaceOne instance. For use with :meth:`~pymongo.collection.Collection.bulk_write`. :Parameters: - `filter`: A query that matches the document to replace. - `replacement`: The new document. - `upsert` (optional): If ``True``, perform an insert if no documents match the filter. - `collation` (optional): An instance of :class:`~pymongo.collation.Collation`. This option is only supported on MongoDB 3.4 and above. - `hint` (optional): An index to use to support the query predicate specified either by its string name, or in the same format as passed to :meth:`~pymongo.collection.Collection.create_index` (e.g. ``[('field', ASCENDING)]``). This option is only supported on MongoDB 4.2 and above. .. versionchanged:: 3.11 Added the ``hint`` option. .. versionchanged:: 3.5 Added the ``collation`` option. Nr8upsert) rrr:rrr r4rrVr5r6)rr8 replacementrXr<r=s rrzReplaceOne.__init__sg4   & 1   Xv .  dK0..t4   # rc|j|j|j|j|j|j y)rrAN) add_replacer4rrVr5r6rs rrzReplaceOne._add_to_bulks5DLL$))T\\&*ooDJJ  Hrc"t|t|k(rs|j|j|j|j|j f|j|j|j|j|j fk(St Sr!)r"r4rrVr5r6r#r$s rr&zReplaceOne.__eq__ss ;$t* $ EMM5;K;K"&,, 4<<"&//5;;"@@ Arc||k( Sr!r(r$s rr)zReplaceOne.__ne__r*rc |jjd|jd|jd|jd|j d|j d SN(rFr) __class__r,r4rrVr5r6rs rrzReplaceOne.__repr__s8 NN # #T\\499dll OOTZZ) )r)FNN) r,r-r.r/r0rrr&r)rr(rrrUrUs+-EIDH&PH !)rrUc,eZdZdZdZdZdZdZdZy) _UpdateOpz)Private base class for update operations.)r4rrVr5_array_filtersr6c| td|| td|| td||%t|tst j |}||_||_||_ ||_ ||_ ||_ y)Nr8rX array_filters) rrrr:rrr r4rrVr5rdr6)rr8docrXr<rfr=s rrz_UpdateOp.__init__s   & 1   Xv .  $ /= 9  dK0..t4   #+ rcNt|t|k(r|j|j|j|j|j |j f|j|j|j|j|j |j fk(StSr!)r"r4rrVr5rdr6r#r$s rr&z_UpdateOp.__eq__s ;$t* $ EMM5;K;K%%u{{4tyy$,,$$djj22 3 rc||k( Sr!r(r$s rr)z_UpdateOp.__ne__ r*rc|jjd|jd|jd|jd|j d|j d|jdSr_)rar,r4rrVr5rdr6rs rrz_UpdateOp.__repr__ s@ NN # #T\\499dll OOT00$**> >rN) r,r-r.r/r0rr&r)rr(rrrcrcs 3I&!>rrcc2eZdZdZdZ dfd ZdZxZS) UpdateOnez#Represents an update_one operation.r(c6tt| ||||||y)aMRepresents an update_one operation. For use with :meth:`~pymongo.collection.Collection.bulk_write`. :Parameters: - `filter`: A query that matches the document to update. - `update`: The modifications to apply. - `upsert` (optional): If ``True``, perform an insert if no documents match the filter. - `collation` (optional): An instance of :class:`~pymongo.collation.Collation`. This option is only supported on MongoDB 3.4 and above. - `array_filters` (optional): A list of filters specifying which array elements an update should apply. Requires MongoDB 3.6+. - `hint` (optional): An index to use to support the query predicate specified either by its string name, or in the same format as passed to :meth:`~pymongo.collection.Collection.create_index` (e.g. ``[('field', ASCENDING)]``). This option is only supported on MongoDB 4.2 and above. .. versionchanged:: 3.11 Added the `hint` option. .. versionchanged:: 3.9 Added the ability to accept a pipeline as the `update`. .. versionchanged:: 3.6 Added the `array_filters` option. .. versionchanged:: 3.5 Added the `collation` option. N)superrlrrr8updaterXr<rfr=ras rrzUpdateOne.__init__s"@ i' (5t =rc |j|j|jd|j|j|j |j y)rFr<rfr=N add_updater4rrVr5rdr6rs rrzUpdateOne._add_to_bulk;s@4<<E4<<%)__)-)<)< $   ,rFNNNr,r-r.r/r0rr __classcell__ras@rrlrls-I?C*.!=F,rrlc2eZdZdZdZ dfd ZdZxZS) UpdateManyz$Represents an update_many operation.r(c6tt| ||||||y)aICreate an UpdateMany instance. For use with :meth:`~pymongo.collection.Collection.bulk_write`. :Parameters: - `filter`: A query that matches the documents to update. - `update`: The modifications to apply. - `upsert` (optional): If ``True``, perform an insert if no documents match the filter. - `collation` (optional): An instance of :class:`~pymongo.collation.Collation`. This option is only supported on MongoDB 3.4 and above. - `array_filters` (optional): A list of filters specifying which array elements an update should apply. Requires MongoDB 3.6+. - `hint` (optional): An index to use to support the query predicate specified either by its string name, or in the same format as passed to :meth:`~pymongo.collection.Collection.create_index` (e.g. ``[('field', ASCENDING)]``). This option is only supported on MongoDB 4.2 and above. .. versionchanged:: 3.11 Added the `hint` option. .. versionchanged:: 3.9 Added the ability to accept a pipeline as the `update`. .. versionchanged:: 3.6 Added the `array_filters` option. .. versionchanged:: 3.5 Added the `collation` option. N)rnrzrros rrzUpdateMany.__init__Hs"@ j$()6 >rc |j|j|jd|j|j|j |j y)rTrrNrsrs rrzUpdateMany._add_to_bulkks@4<<D$,,%)__)-)<)< $   ,rrurvrxs@rrzrzCs.I?C*.!>F,rrzc*eZdZdZdZdZedZy) IndexModelzRepresents an index to create.) __documentc t|}d|vrt||d<t||d<t|j dd}||_|||j d<yy)a Create an Index instance. For use with :meth:`~pymongo.collection.Collection.create_indexes`. Takes either a single key or a list of (key, direction) pairs. The key(s) must be an instance of :class:`basestring` (:class:`str` in python 3), and the direction(s) must be one of (:data:`~pymongo.ASCENDING`, :data:`~pymongo.DESCENDING`, :data:`~pymongo.GEO2D`, :data:`~pymongo.GEOHAYSTACK`, :data:`~pymongo.GEOSPHERE`, :data:`~pymongo.HASHED`, :data:`~pymongo.TEXT`). Valid options include, but are not limited to: - `name`: custom name to use for this index - if none is given, a name will be generated. - `unique`: if ``True``, creates a uniqueness constraint on the index. - `background`: if ``True``, this index should be created in the background. - `sparse`: if ``True``, omit from the index any documents that lack the indexed field. - `bucketSize`: for use with geoHaystack indexes. Number of documents to group together within a certain proximity to a given longitude and latitude. - `min`: minimum value for keys in a :data:`~pymongo.GEO2D` index. - `max`: maximum value for keys in a :data:`~pymongo.GEO2D` index. - `expireAfterSeconds`: Used to create an expiring (TTL) collection. MongoDB will automatically delete documents from this collection after seconds. The indexed field must be a UTC datetime or the data will not expire. - `partialFilterExpression`: A document that specifies a filter for a partial index. Requires MongoDB >= 3.2. - `collation`: An instance of :class:`~pymongo.collation.Collation` that specifies the collation to use in MongoDB >= 3.4. - `wildcardProjection`: Allows users to include or exclude specific field paths from a `wildcard index`_ using the { "$**" : 1} key pattern. Requires MongoDB >= 4.2. - `hidden`: if ``True``, this index will be hidden from the query planner and will not be evaluated as part of query plan selection. Requires MongoDB >= 4.4. See the MongoDB documentation for a full list of supported options by server version. :Parameters: - `keys`: a single key or a list of (key, direction) pairs specifying the index to create - `**kwargs` (optional): any additional index creation options (see the above list) should be passed as keyword arguments .. versionchanged:: 3.11 Added the ``hidden`` option. .. versionchanged:: 3.2 Added the ``partialFilterExpression`` option to support partial indexes. .. _wildcard index: https://docs.mongodb.com/master/core/index-wildcard/#wildcard-index-core namekeyr<N)r r r rpop_IndexModel__document)rkeyskwargsr<s rrzIndexModel.__init__xsh|4   ,T2F6N'-u .vzz+t/LM    +4DOOK ( !rc|jS)zUAn index document suitable for passing to the createIndexes command. )rrs rrzIndexModel.documents rN)r,r-r.r/r0rpropertyrr(rrr~r~ss%(IE5Nrr~N)r/bson.py3compatrpymongorpymongo.commonrrrpymongo.collationrpymongo.helpersr r r objectr r2rNrUrcrlrzr~r(rrrs#&OO8II!!@3!3!l3!3!l@)@)F(>(>V-, -,`-,-,`QQr