&gK S r SSKJr SSKrSSKJrJrJrJrJ r J
r
J r SSK J
r
Jr SSKJr SSKJr SSKJrJr SS KJr SS
KJrJrJrJ r J r SS K J r SS K J!r!J"r"J#r# SS
K$J%r% SSK&J'r'J(r(J)r) Sr*\+" / SQ5 r,\( a SSK-J.r. SSK/J0r0 SSK1J2r2 SSK3J4r4 SSK5J6r6 S S jr7 " S S\\( 5 r8 " S S\8\( 5 r9 " S S \8\( 5 r: " S S \:\( 5 r;g) 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) Y [ i i)# i{' iP- iR- i{4 i|4 ? iL4 )
ClientSession)
Collection)Database) MongoClient)
Connectionc 0 [ U [ [ 45 ( a g[ U [ 5 ( ae U R c gU R S: =( a U R S5 =( d) U R S: =( a U R [ ; $ g)z5Return True if given a resumable change stream error.TF ResumableChangeStreamError)
isinstancer r r _max_wire_versionhas_error_labelcode_RESUMABLE_GETMORE_ERRORS)excs fC:\Suresh\moveshuttle\MDcreated\moveengine\venv\Lib\site-packages\pymongo/synchronous/change_stream.py
_resumabler7 M s #)>:;;#'(( ( ! !Q & \3+>+>?[+\S##a'QCHH8Q,Q S c \ rS rSrSr S SS jjrSS jr\SS j5 r\S S j5 r S S jr
S S jr S S
jr S S jr
S S jrS!S
jrSS jrSS jrS"S jr\S#S j5 r\R* S$S j5 r\r\S%S j5 r\R* S&S j5 rS"S jrS'S jrSr g)( ChangeStreamZ a 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 Uc / n[ R " SU5 n[ R " SU5 [ U5 [ R " SU5 SU l UR U l UR R R ( a7 SU l UR UR R [ S9S9U l OXl [ R " U5 U l X0l Xl U
S LU l US LU l [ R " U
=( d U5 U l XPl X`l Xpl Xl Xl Xl SU l U R R8 U l Xl g )Npipeline
full_document batchSizeFT)document_class)
codec_options) r
validate_listvalidate_string_or_noner %validate_non_negative_integer_or_none_decode_customrA _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)selftargetr= r> resume_aftermax_await_time_ms
batch_size collationstart_at_operation_timesession start_aftercommentfull_document_before_changeshow_expanded_eventss r6 __init__ChangeStream.__init__f s> ( H''
H=&&
F"9-44[*M #@F@T@T - - : :"&D ".. $ 2 2 ? ? ? _ / DL "L x0 +,G)!,D!8 ".d": !]];+F, G"3 %#(?%
--
%9"r8 c . U R 5 U l g N)_create_cursor_cursorr\ s r6 _initialize_cursor ChangeStream._initialize_cursor s **, r8 c [ e)z)The aggregation command class to be used.NotImplementedErrorrn s r6 _aggregation_command_class'ChangeStream._aggregation_command_class s
"!r8 c [ e)zUThe client against which the aggregation commands for
this ChangeStream will be run.
rr rn s r6 _clientChangeStream._client s
"!r8 c F 0 nU R b U R US' U R b U R US' U R nUb U R ( a X!S' O!X!S' O U R b U R US' U R
( a U R
US' U$ )z=Return the options dict for the $changeStream pipeline stage. fullDocumentfullDocumentBeforeChange
startAfter resumeAfterstartAtOperationTimeshowExpandedEvents)rN rO resume_tokenrP rV r[ )r\ optionsr s r6 _change_stream_options#ChangeStream._change_stream_options s "$ *&*&9&9GN # , , 8262S2SG. /(( #%%(4 %)5
&
*
*
6.2.K.KG* + % %,0,F,FG( )r8 c z 0 nU R b U R US' U R b U R US' U$ )z4Return the options dict for the aggregation command.maxAwaitTimeMSr? )rS rT )r\ r s r6 _command_options ChangeStream._command_options sE " " .(,(?(?G$ % '#'#3#3GK r8 c f U R 5 nSU0/nUR U R 5 U$ )z;Return the full aggregation pipeline for this ChangeStream.z
$changeStream)r extendrM )r\ r
full_pipelines r6 _aggregation_pipeline"ChangeStream._aggregation_pipeline s5 --/ / 9 :
T^^, r8 c 0 US S ( d SUS ; a US S U l gU R cd U R SL aT U R SL aD UR S: a3 UR S5 U l U R c [
SU< 35 egggggg) 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
firstBatchpostBatchResumeTokenNFr
operationTimez?Expected field 'operationTime' missing from command response : )rR rV rQ rP max_wire_versiongetr )r\ resultconns r6 _process_result ChangeStream._process_result s h -%)99%+H%56L%M"--5++u4**e3))Q.06
?0K-008*&&,Z1 9 / 4 5 6 .r8 c
B U R U R [ U R 5 U R 5 UU R
U R S9nU R R UR U R R U5 U[ R S9$ )zdRun the full aggregation pipeline for this ChangeStream and return
the corresponding CommandCursor.
)result_processorre ) operation)
rt rJ r r r r rX rw _retryable_read
get_cursor_read_preference_forr AGGREGATE)r\ rc explicit_sessioncmds r6 _run_aggregation_cmd!ChangeStream._run_aggregation_cmd s -- LL & & ( ! ! # ! 1 1MM .
||++ NN LL - -g 6 mm ,
r8 c U R R U R SS9 nU R XR S LS9sS S S 5 $ ! , ( d f g = f)NFclose)rc r )rw _tmp_sessionrW r )r\ ss r6 rl ChangeStream._create_cursor sG
\\
&
&t}}E
&
Ba,,Q ^bIb,c C
B
Bs A
Ac U R R 5 U R 5 U l g! [ a N"f = f)z7Reestablish this change stream after a resumable error.N)rm r r rl rn s r6 _resumeChangeStream._resume s= LL **, s 2
??c F SU l U R R 5 g)zClose this ChangeStream.TN)rY rm r rn s r6 r ChangeStream.close s r8 c U $ rk rn s r6 __iter__ChangeStream.__iter__ r8 c B [ R " U R 5 $ )ztThe cached resume token that will be used to resume after the most
recently returned change.
.. versionadded:: 3.9
)rK rL rR rn s r6 r ChangeStream.resume_token s }}T / /00r8 c U R ( a( U R 5 nUb U$ U R ( a M( [ e)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)r\ docs r6 nextChangeStream.next! s4 B jj--/C
jjj
r8 c $ U R ( + $ )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
)rY rn s r6 r ChangeStream.aliveK s << r8 c t U R ( d+ U R R ( d U R 5 U R R S5 nU R R ( d SU l Uc; U R R b" U R R U l SU l U$ US nU R R 5 ( d1 U R R ( a U R R nSU l SU l X0l SU l U R$ ( a [' UR( U R* 5 $ U$ ! [
aG n[
U5 ( d e U R 5 U R R S5 n SnAGNPSnAff = f! [
a7 n[
U5 ( d! UR ( d U R 5 e SnAf[ a U R 5 e f = f! [ a U R 5 [ S5 Sef = f)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.)rY rm r r _try_nextr r7 timeoutr
BaseException_post_batch_resume_tokenrR rV KeyErrorr _has_nextrP rQ rE r rawrF )r\ changer5 r s r6 r ChangeStream.try_nextV s @ ||DLL$6$6 LLN
7 //5" ||!! DL >
||44@%)\\%J%J"04-M !%=L ||%%''DLL,Q,Q <<@@L "' "& *(,% T-E-EF F
m
7!# //6
7
c??3;;
JJL , JJL"W
sA E ;H
F/(
Optional[str]r^ Optional[Mapping[str, Any]]r_
Optional[int]r` r ra zOptional[_CollationIn]rb zOptional[Timestamp]rc Optional[ClientSession]rd r re z
Optional[Any]rf r rg zOptional[bool]returnNone)r r )r zType[_AggregationCommand])r r+ r zdict[str, Any])r zlist[dict[str, Any]])r zMapping[str, Any]r r, r r )rc r r boolr r )r r )r zChangeStream[_DocumentType])r r )r r )r r )r zOptional[_DocumentType])r r r r r r r r ) __name__
__module__ __qualname____firstlineno____doc__rh ro propertyrt rw r r r r r rl r r r r r applyr __next__r r r r __static_attributes__r r8 r6 r: r: Z s 6 "&59/3%5:
5: &5: %5: 25: )5: "5: *5: "55: ) 5: 1 5: !5:" &3#5:$ -%5:&
'5:n- " " " " 0 2
.
BF
,d-
1 1 [[% % N H
[[] ]~r8 r: c L \ rS rSr% SrS\S' \S S j5 r\S
S j5 rSr g) 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]rJ c [ $ rk )r rn s r6 rt 1CollectionChangeStream._aggregation_command_class s ,,r8 c B U R R R $ rk )rJ databaseclientrn s r6 rw CollectionChangeStream._client s ||$$+++r8 r N)r z#Type[_CollectionAggregationCommand]r zMongoClient[_DocumentType]
r r r r r __annotations__r rt rw r r r8 r6 r r s5 '&
- - , ,r8 r c L \ rS rSr% SrS\S' \S S j5 r\S
S j5 rSr g) 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]rJ c [ $ rk )r rn s r6 rt /DatabaseChangeStream._aggregation_command_class s **r8 c . U R R $ rk )rJ r rn s r6 rw DatabaseChangeStream._client s ||"""r8 r N)r z!Type[_DatabaseAggregationCommand]r r r r8 r6 r r s5 %$
+ + # #r8 r c 0 ^ \ rS rSrSrSU 4S jjrSrU =r$ )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 . > [ TU ] 5 nSUS' U$ )NTallChangesForCluster)superr )r\ r __class__s r6 r *ClusterChangeStream._change_stream_options s '02*.&'r8 r r )r r r r r r r
__classcell__)r s @r6 r r s r8 r )r5 r r r )r s H " N N N , ) $ ! 8 #
= B B & . @95<3
`7=) `F ,\- 8 ,(#<
6 #( .}= r8