,>ddlmZddlmZddlmZGddeZy))six)accepts_kwargs)InvalidSubscriberMethodErrorcLeZdZdZgdZfdZedZdZdZ dZ xZ S)BaseSubscriberzThe base subscriber class It is recommended that all subscriber implementations subclass and then override the subscription methods (i.e. on_{subsribe_type}() methods). )queuedprogressdonecJ|jtt||S)N)_validate_subscriber_methodssuperr__new__)clsargskwargs __class__s )lib/third_party/s3transfer/subscribers.pyrzBaseSubscriber.__new__s! ((*^S1#66c|jD]M}t|d|z}tj|st d|zt |rAt d|zy)Non_z&Subscriber method %s must be callable.z=Subscriber method %s must accept keyword arguments (**kwargs))VALID_SUBSCRIBER_TYPESgetattrrcallablerr)rsubscriber_typesubscriber_methods rr z+BaseSubscriber._validate_subscriber_methods#sp"99O 'U_-D E << 122<%&''""342+->?@@ :rc y)aCallback to be invoked when transfer request gets queued This callback can be useful for: * Keeping track of how many transfers have been requested * Providing the expected transfer size through future.meta.provide_transfer_size() so a HeadObject would not need to be made for copies and downloads. :type future: s3transfer.futures.TransferFuture :param future: The TransferFuture representing the requested transfer. Nselffuturers r on_queuedzBaseSubscriber.on_queued1 rc y)ajCallback to be invoked when progress is made on transfer This callback can be useful for: * Recording and displaying progress :type future: s3transfer.futures.TransferFuture :param future: The TransferFuture representing the requested transfer. :type bytes_transferred: int :param bytes_transferred: The number of bytes transferred for that invocation of the callback. Note that a negative amount can be provided, which usually indicates that an in-progress request needed to be retried and thus progress was rewound. Nr)rr bytes_transferredrs r on_progresszBaseSubscriber.on_progress@s rc y)aCallback to be invoked once a transfer is done This callback can be useful for: * Recording and displaying whether the transfer succeeded or failed using future.result() * Running some task after the transfer completed like changing the last modified time of a downloaded file. :type future: s3transfer.futures.TransferFuture :param future: The TransferFuture representing the requested transfer. Nrrs ron_donezBaseSubscriber.on_doneRr"r) __name__ __module__ __qualname____doc__rr classmethodr r!r%r' __classcell__)rs@rrrs:  7 @ @   $  rrN)botocore.compatrs3transfer.compatrs3transfer.exceptionsrobjectrrrrr2s ,>L VL r