[SrSSKrSSKrSSKrSSKrSSKJrJrJr SSK r \R(aSSK J r "SS\RS9rS\RR 4S jr"S S \5rg) zSchedulers provide means to *schedule* callbacks asynchronously. These are used by the subscriber to call the user-provided callback to process each message. N)CallableListOptional) pubsub_v1c\rSrSrSr\\RS\R4Sj55r\RS\ SS4Sj5r \RS S\ S\ S 4S jj5rS rg) Scheduler z_Abstract base class for schedulers. Schedulers are used to schedule callbacks asynchronously. returnc[e)zQueue: A concurrency-safe queue specific to the underlying concurrency implementation. This queue is used to send messages *back* to the scheduling actor. NotImplementedErrorselfs >lib/third_party/google/cloud/pubsub_v1/subscriber/scheduler.pyqueueScheduler.queue&s "!callbackNc[e)zSchedule the callback to be called asynchronously. Args: callback: The function to call. args: Positional arguments passed to the callback. kwargs: Key-word arguments passed to the callback. Returns: None r rrargskwargss rscheduleScheduler.schedule0s "!rawait_msg_callbacks$pubsub_v1.subscriber.message.Messagec[e)a+Shuts down the scheduler and immediately end all pending callbacks. Args: await_msg_callbacks: If ``True``, the method will block until all currently executing callbacks are done processing. If ``False`` (default), the method will not wait for the currently running callbacks to complete. Returns: The messages submitted to the scheduler that were not yet dispatched to their callbacks. It is assumed that each message was submitted to the scheduler as the first positional argument to the provided callback. r )rrs rshutdownScheduler.shutdown>s $"!rF)__name__ __module__ __qualname____firstlineno____doc__propertyabcabstractmethodrQueuerrboolrr__static_attributes__r rrrr s "u{{""  " "t " " */"#'" 4 5""rr) metaclassr c>[RRSSS9$)N z"ThreadPoolExecutor-ThreadScheduler) max_workersthread_name_prefix) concurrentfuturesThreadPoolExecutorr rr"_make_default_thread_pool_executorr5Ss&    0 0+O 1 rc\rSrSrSrSS\\RR4Sjjr \ S5r S\ SS4S jr SS \S\S 4S jjrS rg)ThreadSchedulerYaA thread pool-based scheduler. It must not be shared across SubscriberClients. This scheduler is useful in typical I/O-bound message processing. Args: executor: An optional executor to use. If not specified, a default one will be created. Nexecutorcj[R"5UlUc[5UlgXlgN)rr*_queuer5 _executor)rr9s r__init__ThreadScheduler.__init__es&$);;=  ?ADN%NrcUR$)z^Queue: A thread-safe queue used for communication between callbacks and the scheduling thread.)r<rs rrThreadScheduler.queuens{{rrr cURR"U/UQ70UD6 g![a [R"S[ SS9 gf=f)zSchedule the callback to be called asynchronously in a thread pool. Args: callback: The function to call. args: Positional arguments passed to the callback. kwargs: Key-word arguments passed to the callback. Returns: None z.Scheduling a callback after executor shutdown.)category stacklevelN)r=submit RuntimeErrorwarningswarnRuntimeWarningrs rrThreadScheduler.scheduletsG  NN ! !( r'rrrr+rrr,r rrr7r7Ysx KO& !3!3!F!FG& t*+0" #'" 4 5" " rr7)r&r(concurrent.futuresr2rtypingrrrrH TYPE_CHECKING google.cloudrABCMetarr3r4r5r7r rrr[sd   ++ &0"#++0"fJ,>,>,Q,Q Q iQ r