vKgWo0SSKrSSKrSSKrSSKrSSKJrJr SSKJrJ r J r SSK J r SSK Jr SSKJr SSKJrJr SSKJrJrJrJrJrJr SS KJr SS KJrJrJ r J!r!J"r"J#r#J$r$J%r% \RL"\'5r("S S 5r)"S S5r*"SS5r+g)N)BandwidthLimiter LeakyBucket)ALLOWED_DOWNLOAD_ARGSKBMB)CopySubmissionTask)DeleteSubmissionTask)DownloadSubmissionTask)CancelledError FatalError)IN_MEMORY_DOWNLOAD_TAGIN_MEMORY_UPLOAD_TAGBoundedExecutorTransferCoordinatorTransferFuture TransferMeta)UploadSubmissionTask)CallArgsOSUtilsSlidingWindowSemaphore TaskSemaphoreadd_s3express_defaults get_callbackssignal_not_transferringsignal_transferringc N\rSrSrS\-S\-SSSSSS\-SSSS4 SjrS rS rg) TransferConfig/ iNc XlX lX0lX@lXPlX`lXplXlXlXl Xl Xl UR5 g)a Configurations for the transfer manager :param multipart_threshold: The threshold for which multipart transfers occur. :param max_request_concurrency: The maximum number of S3 API transfer-related requests that can happen at a time. :param max_submission_concurrency: The maximum number of threads processing a call to a TransferManager method. Processing a call usually entails determining which S3 API requests that need to be enqueued, but does **not** entail making any of the S3 API data transferring requests needed to perform the transfer. The threads controlled by ``max_request_concurrency`` is responsible for that. :param multipart_chunksize: The size of each transfer if a request becomes a multipart transfer. :param max_request_queue_size: The maximum amount of S3 API requests that can be queued at a time. :param max_submission_queue_size: The maximum amount of TransferManager method calls that can be queued at a time. :param max_io_queue_size: The maximum amount of read parts that can be queued to be written to disk per download. The default size for each elementin this queue is 8 KB. :param io_chunksize: The max size of each chunk in the io queue. Currently, this is size used when reading from the downloaded stream as well. :param num_download_attempts: The number of download attempts that will be tried upon errors with downloading an object in S3. Note that these retries account for errors that occur when streaming down the data from s3 (i.e. socket errors and read timeouts that occur after receiving an OK response from s3). Other retryable exceptions such as throttling errors and 5xx errors are already retried by botocore (this default is 5). The ``num_download_attempts`` does not take into account the number of exceptions retried by botocore. :param max_in_memory_upload_chunks: The number of chunks that can be stored in memory at a time for all ongoing upload requests. This pertains to chunks of data that need to be stored in memory during an upload if the data is sourced from a file-like object. The total maximum memory footprint due to a in-memory upload chunks is roughly equal to: max_in_memory_upload_chunks * multipart_chunksize + max_submission_concurrency * multipart_chunksize ``max_submission_concurrency`` has an affect on this value because for each thread pulling data off of a file-like object, they may be waiting with a single read chunk to be submitted for upload because the ``max_in_memory_upload_chunks`` value has been reached by the threads making the upload request. :param max_in_memory_download_chunks: The number of chunks that can be buffered in memory and **not** in the io queue at a time for all ongoing download requests. This pertains specifically to file-like objects that cannot be seeked. The total maximum memory footprint due to a in-memory download chunks is roughly equal to: max_in_memory_download_chunks * multipart_chunksize :param max_bandwidth: The maximum bandwidth that will be consumed in uploading and downloading file content. The value is in terms of bytes per second. N) multipart_thresholdmultipart_chunksizemax_request_concurrencymax_submission_concurrencymax_request_queue_sizemax_submission_queue_sizemax_io_queue_size io_chunksizenum_download_attemptsmax_in_memory_upload_chunksmax_in_memory_download_chunks max_bandwidth_validate_attrs_are_nonzero) selfr$r%r&r'r(r)r*r+r,r-r.r/s R/var/www/highfloat_scraper/venv/lib/python3.13/site-packages/s3transfer/manager.py__init__TransferConfig.__init__0sYl$7 #6 '>$*D'&<#)B&!2(%:"+F(-J** ((*cURR5H"upUcM US::dM[SUSUS35e g)NrzProvided parameter z of value z must be greater than 0.)__dict__items ValueError)r1attrattr_vals r2r0*TransferConfig._validate_attrs_are_nonzerosL"mm113ND#A  )$z(D))4r5) r+r/r.r-r*r&r(r'r)r%r$r,) __name__ __module__ __qualname____firstlineno__rrr3r0__static_attributes__r5r2rr/s@FF "#$#"&2X$&&(b+Hr5rc\rSrSr\r/SQr\/SQ-r/SQrSrS\ R"S50r SS jr \ S 5r\ S 5rSS jrSS jrSSjrSSjrSrSrSrSSjrSrSrSrSrSrSSjr\4SjrSr g) TransferManager)ACL CacheControlChecksumAlgorithmContentDispositionContentEncodingContentLanguage ContentTypeExpectedBucketOwnerExpiresGrantFullControl GrantRead GrantReadACP GrantWriteACPMetadataObjectLockLegalHoldStatusObjectLockModeObjectLockRetainUntilDate RequestPayerServerSideEncryption StorageClassSSECustomerAlgorithmSSECustomerKeySSECustomerKeyMD5 SSEKMSKeyIdSSEKMSEncryptionContextTaggingWebsiteRedirectLocation) CopySourceIfMatchCopySourceIfModifiedSinceCopySourceIfNoneMatchCopySourceIfUnmodifiedSinceCopySourceSSECustomerAlgorithmCopySourceSSECustomerKeyCopySourceSSECustomerKeyMD5MetadataDirectiveTaggingDirective)MFA VersionIdrWrMTzS3 Object LambdazV^arn:(aws).*:s3-object-lambda:[a-z\-0-9]+:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-]{1,63}Nc `XlX lUc[5UlX0lUc[ 5Ul[ 5UlSUl[URRURR[[URR5[[URR 50US9Ul[URR$URR&US9Ul[URR*SUS9UlSUlURR0bY[2R5SURR05 [7URR05n[9U5UlUR;5 g)aA transfer manager interface for Amazon S3 :param client: Client to be used by the manager :param config: TransferConfig to associate specific configurations :param osutil: OSUtils object to use for os-related behavior when using with transfer manager. :type executor_cls: s3transfer.futures.BaseExecutor :param executor_cls: The class of executor to use with the transfer manager. By default, concurrent.futures.ThreadPoolExecutor is used. Nr)max_sizemax_num_threadstag_semaphores executor_cls)rmrnrpzSetting max_bandwidth to %s)_client_configr_osutilrTransferCoordinatorController_coordinator_controller _id_counterrr(r&rrr-r rr._request_executorr)r'_submission_executorr* _io_executor_bandwidth_limiterr/loggerdebugrr_register_handlers)r1clientconfigosutilrp leaky_buckets r2r3TransferManager.__init__sY  >)+DL >"9DL'D'F$"1\\88 LL@@$mLL<<''(>LL>>) & "  %4\\;; LLCC%% !,\\33% #' << % % 1 LL-t||/I/I 't||'A'ABL&6|&DD # !r5cUR$N)rrr1s r2rTransferManager.client ||r5cUR$r)rsrs r2rTransferManager.config rr5cUc0nUc/nURX@R5 URU5 URX$5 [ UUUUUS9n0nUR (aUR US'UR U[U5$)a,Uploads a file to S3 :type fileobj: str or seekable file-like object :param fileobj: The name of a file to upload or a seekable file-like object to upload. It is recommended to use a filename because file-like objects may result in higher memory usage. :type bucket: str :param bucket: The name of the bucket to upload to :type key: str :param key: The name of the key to upload to :type extra_args: dict :param extra_args: Extra arguments that may be passed to the client operation :type subscribers: list(s3transfer.subscribers.BaseSubscriber) :param subscribers: The list of subscribers to be invoked in the order provided based on the event emit during the process of the transfer request. :rtype: s3transfer.futures.TransferFuture :returns: Transfer future representing the upload )fileobjbucketkey extra_args subscribersbandwidth_limiter)_validate_all_known_argsALLOWED_UPLOAD_ARGS_validate_if_bucket_supported_add_operation_defaultsrr{_submit_transferr)r1rrrrr call_argsextra_main_kwargss r2uploadTransferManager.upload$s4  J  K %%j2J2JK **62 $$V8!#    " "595L5L 1 2$$ +->  r5cUc0nUc/nURX@R5 URU5 [UUUUUS9nSUR0nUR (aUR US'UR U[U5$)a>Downloads a file from S3 :type bucket: str :param bucket: The name of the bucket to download from :type key: str :param key: The name of the key to download from :type fileobj: str or seekable file-like object :param fileobj: The name of a file to download or a seekable file-like object to download. It is recommended to use a filename because file-like objects may result in higher memory usage. :type extra_args: dict :param extra_args: Extra arguments that may be passed to the client operation :type subscribers: list(s3transfer.subscribers.BaseSubscriber) :param subscribers: The list of subscribers to be invoked in the order provided based on the event emit during the process of the transfer request. :rtype: s3transfer.futures.TransferFuture :returns: Transfer future representing the download )rrrrr io_executorr)rrrrrzr{rr )r1rrrrrrrs r2downloadTransferManager.downloadSs8  J  K %%j2L2LM **62!#  +D,=,=>  " "595L5L 1 2$$ -/@  r5c >Uc0nUc/nUc URnURX@R5 [U[5(a UR UR S55 UR U5 [UUUUUUS9nURU[5$)aCopies a file in S3 :type copy_source: dict :param copy_source: The name of the source bucket, key name of the source object, and optional version ID of the source object. The dictionary format is: ``{'Bucket': 'bucket', 'Key': 'key', 'VersionId': 'id'}``. Note that the ``VersionId`` key is optional and may be omitted. :type bucket: str :param bucket: The name of the bucket to copy to :type key: str :param key: The name of the key to copy to :type extra_args: dict :param extra_args: Extra arguments that may be passed to the client operation :type subscribers: a list of subscribers :param subscribers: The list of subscribers to be invoked in the order provided based on the event emit during the process of the transfer request. :type source_client: botocore or boto3 Client :param source_client: The client to be used for operation that may happen at the source object. For example, this client is used for the head_object that determines the size of the copy. If no client is provided, the transfer manager's client is used as the client for the source object. :rtype: s3transfer.futures.TransferFuture :returns: Transfer future representing the copy Bucket) copy_sourcerrrr source_client) rrrALLOWED_COPY_ARGS isinstancedictrgetrrr)r1rrrrrrrs r2copyTransferManager.copysV  J  K   LLM %%j2H2HI k4 ( (  . .{x/H I **62#!#'  $$Y0BCCr5cUc0nUc/nURX0R5 URU5 [UUUUS9nUR U[ 5$)a0Delete an S3 object. :type bucket: str :param bucket: The name of the bucket. :type key: str :param key: The name of the S3 object to delete. :type extra_args: dict :param extra_args: Extra arguments that may be passed to the DeleteObject call. :type subscribers: list :param subscribers: A list of subscribers to be invoked during the process of the transfer request. Note that the ``on_progress`` callback is not invoked during object deletion. :rtype: s3transfer.futures.TransferFuture :return: Transfer future representing the deletion. )rrrr)rALLOWED_DELETE_ARGSrrrr )r1rrrrrs r2deleteTransferManager.deletesh,  J  K %%j2J2JK **62!#  $$Y0DEEr5cUR(aKURR5H,up#URU5nU(dM[ SUS35e gg)Nz'TransferManager methods do not support z+ resource. Use direct client calls instead.) VALIDATE_SUPPORTED_BUCKET_VALUES_UNSUPPORTED_BUCKET_PATTERNSr8matchr9)r1rresourcepatternrs r2r-TransferManager._validate_if_bucket_supportedsc  0 0%)%F%F%L%L%N! f-5$A(LEE&O 1r5c tUH2nX2;dM [SRUSRU555e g)Nz/Invalid extra_args key '{}', must be one of: {}z, )r9formatjoin)r1actualallowedkwargs r2r(TransferManager._validate_all_known_argss9E# ))/tyy7I)Jr5c[X5 gr)r)r1rrs r2r'TransferManager._add_operation_defaultss v2r5cU(d0nURU5upE[US5HnUSRU5 M URXC5nURR U"USUS95 U=R S- slU$)Ndone coordinator)transfer_coordinator main_kwargsrq)_get_future_with_componentsradd_done_callback _get_submission_task_main_kwargsrysubmitrw)r1rsubmission_task_clsrtransfer_future componentscallbackrs r2r TransferManager._submit_transfers! " '+&F&F ' # &ov>H } % 7 7 A?;;  !!(( %/ %>'   Ar5cURn[US9nURRU5 UR URR U5 [ XS9US.n[S0UD6nXT4$)N) transfer_id)metarrB)rwrrvadd_transfer_coordinatorrremove_transfer_coordinatorrr)r1rrrrrs r2r+TransferManager._get_future_with_components!s}&& 2{K $$==  ..  ( ( D D  !D/ )6:6**r5cURURURURUS.nUR U5 U$)N)rrrrequest_executorr)rrrsrtrxupdate)r1rrrs r2r0TransferManager._get_submission_task_main_kwargs6sCllllll $ 6 6.   ,-r5cSnURRRRU[SS9 URRRR U[ SS9 g)Nzrequest-created.s3zs3upload-not-transferring) unique_idzs3upload-transferring)rrreventsregister_firstr register_lastr)r1 event_names r2r~"TransferManager._register_handlersCsa)    //  #1 0   .. +7N / r5cU$rrBrs r2 __enter__TransferManager.__enter__Os r5cSnSn[nU(a:Sn[U5nU(d [U5n[U[5(a[ nUR XEU5 g)NFT)r strreprrKeyboardInterruptr _shutdown)r1exc_type exc_valueargscancel cancel_msgcancel_exc_types r2__exit__TransferManager.__exit__RsS $ FYJ!)_ )%677"0 v?;r5c(URXU5 g)aShutdown the TransferManager It will wait till all transfers complete before it completely shuts down. :type cancel: boolean :param cancel: If True, calls TransferFuture.cancel() for all in-progress in transfers. This is useful if you want the shutdown to happen quicker. :type cancel_msg: str :param cancel_msg: The message to specify if canceling all in-progress transfers. N)r)r1rrs r2shutdownTransferManager.shutdowncs vz2r5cU(aURRX#5 URR5 URR 5 UR R 5 URR 5 g![a URRS5 ef=f!URR 5 UR R 5 URR 5 f=f)NzKeyboardInterrupt())rvrwaitrryrrxrz)r1rrrs r2rTransferManager._shutdownts   ( ( / / E )  ( ( - - /  % % . . 0  " " + + -    & & (!   ( ( / /0E F    % % . . 0  " " + + -    & & (sB'B55B88AD) r{rrrsrvrwrzrtrxry)NNN)NNr)Fr)!r=r>r?r@rrrrrrecompilerr3propertyrrrrrrrrrrrrr~rrrr rrArBr5r2rDrDs1<, / (,$ BJJ 2 $ @"D- `BF. j=D~"FH 3AE!F+*   <"3"6D)r5rDcJ\rSrSrSr\S5rSrSrS\ 4Sjr Sr S r g ) ruicV[R"5Ul[5Ulg)zAbstraction to control all transfer coordinators This abstraction allows the manager to wait for inprogress transfers to complete and cancel all inprogress transfers. N) threadingLock_lockset_tracked_transfer_coordinatorsrs r2r3&TransferCoordinatorController.__init__s ^^% .1e+r5cUR [R"UR5sSSS5 $!,(df  g=f)z.The set of transfer coordinators being trackedN)rrrrs r2tracked_transfer_coordinators;TransferCoordinatorController.tracked_transfer_coordinatorss)ZZ99T@@A ZZs 7 AcUR URRU5 SSS5 g!,(df  g=f)zAdds a transfer coordinator of a transfer to be canceled if needed :type transfer_coordinator: s3transfer.futures.TransferCoordinator :param transfer_coordinator: The transfer coordinator for the particular transfer N)rraddr1rs r2r6TransferCoordinatorController.add_transfer_coordinators*ZZ  / / 3 34H IZZ 2 AcUR URRU5 SSS5 g!,(df  g=f)aQRemove a transfer coordinator from cancellation consideration Typically, this method is invoked by the transfer coordinator itself to remove its self when it completes its transfer. :type transfer_coordinator: s3transfer.futures.TransferCoordinator :param transfer_coordinator: The transfer coordinator for the particular transfer N)rrremovers r2r9TransferCoordinatorController.remove_transfer_coordinators*ZZ  / / 6 67K LZZrrcLURHnURX5 M g)a Cancels all inprogress transfers This cancels the inprogress transfers by calling cancel() on all tracked transfer coordinators. :param msg: The message to pass on to each transfer coordinator that gets cancelled. :param exc_type: The type of exception to set for the cancellation N)rr)r1msgrrs r2r$TransferCoordinatorController.cancels$%)$F$F ' ' 6%Gr5cSnURHnUR5 M g![a4 [R S5 W(a[R SU5 e[ a gf=f)zWait until there are no more inprogress transfers This will not stop when failures are encountered and not propagate any of these errors from failed transfers, but it can be interrupted with a KeyboardInterrupt. Nz$Received KeyboardInterrupt in wait()z'On KeyboardInterrupt was waiting for %s)rresultrr|r} Exceptionrs r2r"TransferCoordinatorController.waitsp #' (,(J(J$$++-)K  LL? @$ =(     s%(AA10A1)rrN) r=r>r?r@r3rrrrr rrrArBr5r2rurus:4BBJ Mn 7r5ru),rloggingrrs3transfer.bandwidthrrs3transfer.constantsrrrs3transfer.copiesrs3transfer.deleter s3transfer.downloadr s3transfer.exceptionsr r s3transfer.futuresr rrrrrs3transfer.uploadrs3transfer.utilsrrrrrrrr getLoggerr=r|rrDrurBr5r2rs~  >>>026<3      8 $kk\m)m)`SSr5