+
4O|jK R t ^ RIHt ^ RIt^ RIHtHtHtHtH t H
t
H t ^ RI H
t
Ht ^ RIHt ^ RIHt ^ RIHtHt ^ RIHt ^ R IHtHtHtH t H t ^ R
I H t ^ R I H!t!H"t"H#t# ^ R I$H%t% ^ R
I&H't'H(t(H)t) Rt*]+! . R O4 t,]' d ^ RI-H.t. ^ RI/H0t0 ^ RI1H2t2 ^ RI3H4t4 ^ RI5H6t6 R R lt7 ! R R]](, 4 t8 ! R R]8](, 4 t9 ! R R]8](, 4 t: ! R R ]:](, 4 t;R# ) zAWatch changes on a collection, a database, or the entire cluster.) annotationsN)
TYPE_CHECKINGAnyGenericMappingOptionalTypeUnion) CodecOptions
_bson_to_dict)RawBSONDocument) Timestamp)_csotcommon)validate_collation_or_none)ConnectionFailureCursorNotFoundInvalidOperationOperationFailure PyMongoError)_Op)_AggregationCommand _CollectionAggregationCommand_DatabaseAggregationCommand)
CommandCursor) _CollationIn
_DocumentType _PipelineT)
ClientSession)
Collection)Database) MongoClient)
Connectionc V ^8 d QhRRRR/# ) excr returnbool )formats "ZC:\Users\alokc\chatbot\backend\venv\Lib\site-packages\pymongo/synchronous/change_stream.py __annotate__r+ M s
L
T
c B \ V \ \ 34 ' d R# \ V \ 4 ' dk V P f R# V P ^ 8 ;' d V P R4 ;' g+ V P ^ 8 ;' d V P \ 9 # R# )z5Return True if given a resumable change stream error.TFResumableChangeStreamError)
isinstancer r r _max_wire_versionhas_error_labelcode_RESUMABLE_GETMORE_ERRORS)r% s &r*
_resumabler4 M s #)>:;;#'(( ( ! !Q & \ \3+>+>?[+\S S##a'QQCHH8Q,Q S r, c j ] tR t^ZtRtR*R R lltR R lt]R R l4 t]R R
l4 t R R lt
R
R lt R R lt R R lt
R R ltR R ltR R ltR R ltR R lt]R R l4 t]P* R R l4 t]t]R! R" l4 t]P* R# R$ l4 tR% R& ltR' R( ltR)t R# )+ ChangeStreama The internal abstract base class for change stream cursors.
Should not be called directly by application developers. Use
:meth:`pymongo.collection.Collection.watch`,
:meth:`pymongo.database.Database.watch`, or
:meth:`pymongo.mongo_client.MongoClient.watch` instead.
.. versionadded:: 3.6
.. seealso:: The MongoDB documentation on `changeStreams `_.
Nc P V ^8 d QhRRRRRRRRR R
R R
R R
RRRRRRRRRRRRRR/# )r$ targetzUUnion[MongoClient[_DocumentType], Database[_DocumentType], Collection[_DocumentType]]pipelinezOptional[_Pipeline]
full_documentz
Optional[str] resume_afterOptional[Mapping[str, Any]]max_await_time_msz
Optional[int]
batch_size collationzOptional[_CollationIn]start_at_operation_timezOptional[Timestamp]sessionOptional[ClientSession] start_aftercommentz
Optional[Any]full_document_before_changeshow_expanded_eventszOptional[bool]r& Noner( )r) s "r* r+ ChangeStream.__annotate__f s 5: 5:
5: &5: %5: 25: )5: "5: *5: "55: ) 5: 1 5: !5:" &3#5:$ -%5:&
'5:r, c Vf . p\ P ! RV4 p\ P ! RV4 \ V4 \ P ! RV4 RV n VP V n VP P P ' d> RV n VP VP P \ R7 R7 V n MWn \ P ! V4 V n W0n Wn V
R JV n VR JV n \ P ! T
;' g T4 V n WPn W`n Wpn Wn Wn Wn RV n V P P8 V n Wn R # )Nr9 r: batchSizeFT)document_class)
codec_options) r
validate_listvalidate_string_or_noner %validate_non_negative_integer_or_none_decode_customrL _orig_codec_options
type_registry _decoder_map with_optionsr _targetcopydeepcopy _pipeline_full_document _full_document_before_change_uses_start_after_uses_resume_after
_resume_token_max_await_time_ms _batch_size
_collation_start_at_operation_time_session_comment_closed_timeout_show_expanded_events)selfr8 r9 r: r; r= r> r? r@ rA rC rD rE rF s &&&&&&&&&&&&&&r* __init__ChangeStream.__init__f sD ( H''
H=&&
F"9-44[*M #@F@T@T - - : : :"&D ".. $ 2 2 ? ? ? _ / DL "L x0 +,G)!,D!8 ".d": !]];+F+F, G"3 %#(?%
--
%9"r, c V ^8 d QhRR/# r$ r& rG r( )r) s "r* r+ rH s - -D -r, c 0 V P 4 V n R # N)_create_cursor_cursorrg s &r* _initialize_cursor ChangeStream._initialize_cursor s **, r, c V ^8 d QhRR/# )r$ r& zType[_AggregationCommand]r( )r) s "r* r+ rH s " ",E "r, c
\ h)z)The aggregation command class to be used.NotImplementedErrorrp s &r* _aggregation_command_class'ChangeStream._aggregation_command_class s
"!r, c V ^8 d QhRR/# )r$ r& r! r( )r) s "r* r+ rH s " " "r, c
\ h)zUThe client against which the aggregation commands for
this ChangeStream will be run.
ru rp s &r* _clientChangeStream._client s
"!r, c V ^8 d QhRR/# r$ r& zdict[str, Any]r( )r) s "r* r+ rH s r, c
R / pV P e V P VR& V P e V P VR& V P pVe V P ' d W!R& M"W!R& M V P e V P VR& V P
' d V P
VR& V# )z=Return the options dict for the $changeStream pipeline stage. fullDocumentfullDocumentBeforeChange
startAfter resumeAfterstartAtOperationTimeshowExpandedEvents)rY rZ resume_tokenr[ ra rf )rg optionsr s & r* _change_stream_options#ChangeStream._change_stream_options s "$ *&*&9&9GN # , , 8262S2SG. /(( #%%%(4 %)5
&
*
*
6.2.K.KG* + % % %,0,F,FG( )r, c V ^8 d QhRR/# r~ r( )r) s "r* r+ rH s . r, c
~ / pV P e V P VR& V P e V P VR& V# )z4Return the options dict for the aggregation command.maxAwaitTimeMSrJ )r^ r_ )rg r s & r* _command_options ChangeStream._command_options sE " " .(,(?(?G$ % '#'#3#3GK r, c V ^8 d QhRR/# )r$ r& zlist[dict[str, Any]]r( )r) s "r* r+ rH s '; r, c
f V P 4 pRV/.pVP V P 4 V# )z;Return the full aggregation pipeline for this ChangeStream.z
$changeStream)r extendrX )rg r
full_pipelines & r* _aggregation_pipeline"ChangeStream._aggregation_pipeline s5 --/0?/I.J
T^^, r, c $ V ^8 d QhRRRRRR/# )r$ resultzMapping[str, Any]connr" r& rG r( )r) s "r* r+ rH s" &7 z d r, c
t VR, R, ' g RVR, 9 d VR, R, V n R# V P fm V P RJ d[ V P RJ dI VP ^8 d6 VP R4 V n V P f \
RV: 24 hR# R# R# R# R# R# )a% Callback that caches the postBatchResumeToken or
startAtOperationTime from a changeStream aggregate command response
containing an empty batch of change documents.
This is implemented as a callback because we need access to the wire
version in order to determine whether to cache this value.
cursor
firstBatchpostBatchResumeTokenNF
operationTimez?Expected field 'operationTime' missing from command response : )r] ra r\ r[ max_wire_versiongetr )rg r r s &&&r* _process_result ChangeStream._process_result s h --%)99%+H%56L%M"--5++u4**e3))Q.06
?0K-008*&&,Z1 9 / 4 5 6 .r, c V ^8 d QhRRRR/# )r$ rA rB r& r r( )r) s "r* r+ rH s
,C
r, c
L V P V P \ V P 4 V P 4 V P
V P R7 pV P P VP V P P V4 V\ P R7 # )zdRun the full aggregation pipeline for this ChangeStream and return
the corresponding CommandCursor.
)result_processorrD ) operation)
rw rU r r r r rc r{ _retryable_read
get_cursor_read_preference_forr AGGREGATE)rg rA cmds && r* _run_aggregation_cmd!ChangeStream._run_aggregation_cmd s -- LL & & ( ! ! # ! 1 1MM
.
||++ NN LL - -g 6 mm ,
r, c V ^8 d QhRR/# )r$ r& r r( )r) s "r* r+ rH s 8 8
8r, c V P P V P 4 ;_uu_ 4 pV P VR 7 uuRRR4 # + ' g i R# ; i))rA N)r{ _tmp_sessionrb r )rg ss & r* rn ChangeStream._create_cursor s=
\\
&
&t}}
5
5,,Q,7 6
5
5
5s A A c V ^8 d QhRR/# rk r( )r) s "r* r+ rH s - - -r, c
V P P 4 V P 4 V n R# \ d L$i ; i)z7Reestablish this change stream after a resumable error.N)ro closer rn rp s &r* _resumeChangeStream._resume s= LL **, s 3 A Ac V ^8 d QhRR/# rk r( )r) s "r* r+ rH
s t r, c
H RV n V P P 4 R# )zClose this ChangeStream.TN)rd ro r rp s &r* r ChangeStream.close
s r, c V ^8 d QhRR/# r$ r& zChangeStream[_DocumentType]r( )r) s "r* r+ rH s 5 r, c V # rm r( rp s &r* __iter__ChangeStream.__iter__ r, c V ^8 d QhRR/# )r$ r& r< r( )r) s "r* r+ rH s 1 1 9 1r, c
B \ P ! V P 4 # )ztThe cached resume token that will be used to resume after the most
recently returned change.
.. versionadded:: 3.9
)rV rW r] rp s &r* r ChangeStream.resume_token s }}T / /00r, c V ^8 d QhRR/# )r$ r& r r( )r) s "r* r+ rH s % % m % r, c
b V P ' d V P 4 pVf K( V# \ h)a# Advance the cursor.
This method blocks until the next change document is returned or an
unrecoverable error is raised. This method is used when iterating over
all changes in the cursor. For example::
try:
resume_token = None
pipeline = [{'$match': {'operationType': 'insert'}}]
with db.collection.watch(pipeline) as stream:
for insert_change in stream:
print(insert_change)
resume_token = stream.resume_token
except pymongo.errors.PyMongoError:
# The ChangeStream encountered an unrecoverable error or the
# resume attempt failed to recreate the cursor.
if resume_token is None:
# There is no usable resume token because there was a
# failure during ChangeStream initialization.
logging.error('...')
else:
# Use the interrupted ChangeStream's resume token to create
# a new ChangeStream. The new stream will continue from the
# last seen insert change without missing any events.
with db.collection.watch(
pipeline, resume_after=resume_token) as stream:
for insert_change in stream:
print(insert_change)
Raises :exc:`StopIteration` if this ChangeStream is closed.
)alivetry_next
StopIteration)rg docs & r* nextChangeStream.next s) B jjj--/C
r, c V ^8 d QhRR/# )r$ r& r' r( )r) s "r* r+ rH I s t r, c
$ V P ' * # )zDoes this cursor have the potential to return more data?
.. note:: Even if :attr:`alive` is ``True``, :meth:`next` can raise
:exc:`StopIteration` and :meth:`try_next` can return ``None``.
.. versionadded:: 3.8
)rd rp s &r* r ChangeStream.aliveH s << r, c V ^8 d QhRR/# )r$ r& zOptional[_DocumentType]r( )r) s "r* r+ rH T s ] ]1 ]r, c
V P ' g- V P P ' g V P 4 V P P R4 pT P P ' g RT n Tf= T P P e# T P P T n RT n T# TR, pT P P 4 ' g3 T P P ' d T P P pRT n RT n Y0n RT n T P$ ' d! \' TP( T P* 4 # T# \
dI p\
T4 ' g h T P 4 T P P R4 p Rp?EL\Rp?ii ; i \
d: p\
T4 ' g# TP ' g T P 4 h Rp?i\ d T P 4 h i ; i \ d T P 4 \ R4 Rhi ; i)a Advance the cursor without blocking indefinitely.
This method returns the next change document without waiting
indefinitely for the next change. For example::
with db.collection.watch() as stream:
while stream.alive:
change = stream.try_next()
# Note that the ChangeStream's resume token may be updated
# even when no changes are returned.
print("Current resume token: %r" % (stream.resume_token,))
if change is not None:
print("Change document: %r" % (change,))
continue
# We end up here when there are no recent changes.
# Sleep for a while before trying again to avoid flooding
# the server with getMore requests when no changes are
# available.
time.sleep(10)
If no change document is cached locally then this method runs a single
getMore command. If the getMore yields any documents, the next
document is returned, otherwise, if the getMore returns no documents
(because there have been no changes) then ``None`` is returned.
:return: The next change document or ``None`` when no document is available
after running a single getMore or when the cursor is closed.
.. versionadded:: 3.8
TFN_idzECannot provide resume functionality when the resume token is missing.)rd ro r r _try_nextr r4 timeoutr
BaseException_post_batch_resume_tokenr] ra KeyErrorr _has_nextr[ r\ rP r rawrQ )rg changer% r s & r* r ChangeStream.try_nextS s @ |||DLL$6$6$6 LLN
7 //5" ||!!! DL >
||44@%)\\%J%J"04-M !%=L ||%%''DLL,Q,Q,Q <<@@L "' "& *(,% T-E-EF F
m
7!# //6
7
c??3;;;
JJL , JJL"W
sN E* H" * F=5=F82G 8F==G H "G?.G?? H H "(I
c V ^8 d QhRR/# r r( )r) s "r* r+ rH s 6 r, c V # rm r( rp s &r* __enter__ChangeStream.__enter__ r r, c ( V ^8 d QhRRRRRRRR/# )r$ exc_typer exc_valexc_tbr& rG r( )r) s "r* r+ rH s( s C D r, c & V P 4 R # rm )r )rg r r r s &&&&r* __exit__ChangeStream.__exit__ s
r, )r_ rd r` rc ro rP rY rZ r^ rQ rX r] rb rf ra rU re r\ r[ )NNN) __name__
__module__ __qualname____firstlineno____doc__rh rq propertyrw r{ r r r r r rn r r r r r applyr __next__r r r r __static_attributes__r( r, r* r6 r6 Z s 5:n- " " " " 0 2
&8-
1 1 [[% % N H
[[] ]~ r, r6 c R ] tR tRt$ RtR]R& ]R R l4 t]R R l4 tR t R
# ) CollectionChangeStreami zA change stream that watches changes on a single collection.
Should not be called directly by application developers. Use
helper method :meth:`pymongo.collection.Collection.watch` instead.
.. versionadded:: 3.7
zCollection[_DocumentType]rU c V ^8 d QhRR/# )r$ r& z#Type[_CollectionAggregationCommand]r( )r) s "r* r+ #CollectionChangeStream.__annotate__ s - -,O -r, c \ # rm )r rp s &r* rw 1CollectionChangeStream._aggregation_command_class s ,,r, c V ^8 d QhRR/# r$ r& zMongoClient[_DocumentType]r( )r) s "r* r+ r s , ,3 ,r, c B V P P P # rm )rU databaseclientrp s &r* r{ CollectionChangeStream._client s ||$$+++r, r( N
r r r r r __annotations__r rw r{ r r( r, r* r r s5 '&
- - , ,r, r c R ] tR tRt$ RtR]R& ]R R l4 t]R R l4 tR t R
# ) DatabaseChangeStreami zA change stream that watches changes on all collections in a database.
Should not be called directly by application developers. Use
helper method :meth:`pymongo.database.Database.watch` instead.
.. versionadded:: 3.7
zDatabase[_DocumentType]rU c V ^8 d QhRR/# )r$ r& z!Type[_DatabaseAggregationCommand]r( )r) s "r* r+ !DatabaseChangeStream.__annotate__ s + +,M +r, c \ # rm )r rp s &r* rw /DatabaseChangeStream._aggregation_command_class s **r, c V ^8 d QhRR/# r r( )r) s "r* r+ r s # #3 #r, c . V P P # rm )rU r rp s &r* r{ DatabaseChangeStream._client s ||"""r, r( Nr r( r, r* r r s5 %$
+ + # #r, r c 2 a ] tR tRtRtR V 3R lltRtV ;t# )ClusterChangeStreami zA change stream that watches changes on all collections in the cluster.
Should not be called directly by application developers. Use
helper method :meth:`pymongo.mongo_client.MongoClient.watch` instead.
.. versionadded:: 3.7
c V ^8 d QhRR/# r~ r( )r) s "r* r+ ClusterChangeStream.__annotate__ s r, c . < \ SV ` 4 pR VR& V# )TallChangesForCluster)superr )rg r __class__s & r* r *ClusterChangeStream._change_stream_options s '02*.&'r, r( )r r r r r r r
__classcell__)r s @r* r r s r, r ) Y [ i i)# i{' iP- iR- i{4 i|4 ? iL4 )r* s H " N N N , ) $ ! 8 #
= B B & . @95<3
]7=) ]@ ,\- 8 ,(#<
6 #( .}= r,