tSrSSKJr SSKJr SSKJr SSKJr SSKrSSKrSSKJ r SSK J r SS K J r \ Rr"S S \5r"S S \R"5rg)zIThreading code for estimating total work of long-running gsutil commands.)absolute_import)print_function)division)unicode_literalsN)thread_message) constants)parallelism_framework_utilc"\rSrSrSrSSjrSrg)SeekAheadResult zResult class for seek_ahead_iterator results. A class is used instead of a namedtuple, making it easier to document and use default keyword arguments. cXlX lg)aCreate a SeekAheadResult. Args: est_num_ops: Number of operations the iterated result represents. Operation is loosely defined as a single API call for a single object. The total number of API calls may not be known at the time of iteration, so this number is approximate. data_bytes: Number of data bytes that will be transferred (uploaded, downloaded, or rewritten) for this iterated result. N) est_num_ops data_bytes)selfrrs *platform/gsutil/gslib/seek_ahead_thread.py__init__SeekAheadResult.__init__'s# O)rrN)r)__name__ __module__ __qualname____firstlineno____doc__r__static_attributes__rrr r s  !rr c2^\rSrSrSrU4SjrSrSrU=r$)SeekAheadThread6aThread to estimate total work to be performed by all processes and threads. Because the ProducerThread can only buffer a certain number of tasks on the global task queue, it cannot reliably provide the total count or size of iterated results for operations involving many iterated arguments until it nears the end of iteration. This thread consumes an iterator that should be functionally identical to the ProducerThread, but iterates to the end without adding tasks to the global task queue in an effort to estimate the amount of total work that the call to Apply will perform. It should be used only for large operations, and thus it is created by the main ProducerThread only when the number of iterated arguments exceeds a threshold. This thread may produce an inaccurate estimate if its iterator produces different results than the iterator used by the ProducerThread. This can happen due to eventual listing consistency or due to the source being modified as iteration occurs. This thread estimates operations for top-level objects only; sub-operations (such as a parallel composite upload) should be reported via the iterator as a single object including the total number of bytes affected. c|>[[U] 5 X0lXlX lSUlUR5 g)a]Initializes the seek ahead thread. Args: seek_ahead_iterator: Iterator matching the ProducerThread's args_iterator, but returning only object name and/or size in the result. cancel_event: threading.Event for signaling the seek-ahead iterator to terminate. status_queue: Status queue for posting summary of fully iterated results. FN)superrr status_queueseek_ahead_iterator cancel_event terminatestart)rr#r$r" __class__s rrSeekAheadThread.__init__Os4 /4)+$2$DNJJLrc SnSnURHjnUR(a gU[R-S:Xa!URR 5(a gXR - nX#R- nMl URR 5(ag[UR[R"X[R"555 g![a nSnAgSnAff=f)Nr)r#r%rNUM_OBJECTS_PER_LIST_PAGEr$isSetrrOSError_PutToQueueWithTimeoutr"rSeekAheadMessagetime)r num_objectsnum_data_bytesseek_ahead_resultes rrunSeekAheadThread.runbsKN #77  >>  )== =! C    $ $ & & 444 666 8(     '' (,  56    s!C7C C C3.C3)r$r#r"r%) rrrrrrr4r __classcell__)r's@rrr6s0&66rr)r __future__rrrr threadingr/gslibr gslib.utilsrr PutToQueueWithTimeoutr-objectr Threadrrrrr>sRP&%' !23II!f!,J6i&&J6r