o rZh@spdZddlZddlmZmZddlmZmZmZm Z Gddde Z e Z Gddded Z Gd d d e Z dS) zY This module provides an interface for TweetHandlers, and support for timezone handling. N)ABCMetaabstractmethod)datetime timedeltatimezonetzinfoc@s@eZdZdZeej dZejreej dZ neZ ddZ dS)LocalTimezoneOffsetWithUTCa This is not intended to be a general purpose class for dealing with the local timezone. In particular: * it assumes that the date passed has been created using `datetime(..., tzinfo=Local)`, where `Local` is an instance of the object `LocalTimezoneOffsetWithUTC`; * for such an object, it returns the offset with UTC, used for date comparisons. Reference: https://docs.python.org/3/library/datetime.html )secondscCs|jS)z2 Access the relevant time offset. ) DSTOFFSET)selfdtr ?/var/www/auris/lib/python3.10/site-packages/nltk/twitter/api.py utcoffset'sz$LocalTimezoneOffsetWithUTC.utcoffsetN) __name__ __module__ __qualname____doc__r_timerZ STDOFFSETdaylightaltzoner rr r r rrs  rc@s"eZdZdZdddZddZdS) BasicTweetHandlerz Minimal implementation of `TweetHandler`. Counts the number of Tweets and decides when the client should stop fetching them. cCs ||_d|_ d|_ d|_dS)NrF)limitcounterdo_stopZmax_id)r rr r r__init__9s  zBasicTweetHandler.__init__cCs|j|jko |j S)zL Returns `False` if the client should stop fetching Tweets. )rrrr r r r do_continueHszBasicTweetHandler.do_continueN)r)rrrrrrr r r rr1s  r) metaclassc@s<eZdZdZd ddZeddZedd Zdd d ZdS) TweetHandlerIzu Interface class whose subclasses should implement a handle method that Twitter clients can delegate to. rNcCsJt||d|_d|_|rt|dti|_|r t|dti|_d|_dS)a :param int limit: The number of data items to process in the current round of processing. :param tuple upper_date_limit: The date at which to stop collecting new data. This should be entered as a tuple which can serve as the argument to `datetime.datetime`. E.g. `date_limit=(2015, 4, 1, 12, 40)` for 12:30 pm on April 1 2015. :param tuple lower_date_limit: The date at which to stop collecting new data. See `upper_data_limit` for formatting. NrT)rrupper_date_limitlower_date_limitrLOCALZ startingup)r rr!r"r r rrUs  zTweetHandlerI.__init__cCdS)zJ Deal appropriately with data returned by the Twitter API Nr )r datar r rhandlemzTweetHandlerI.handlecCr$)z? Actions when the tweet limit has been reached Nr rr r r on_finishsr'zTweetHandlerI.on_finishFcCs|js|jrCd}t|d|jtjd}|jr||jks%|jrE||jkrG|jr.d}|j}nd}|j}|r>td|||d|_ dSdSdSdS) z' Validate date limits. z%a %b %d %H:%M:%S +0000 %YZ created_at)rZearlierZlaterz1Date limit {} is {} than date of current tweet {}TN) r!r"rstrptimereplacerutcprintformatr)r r%verboseZdate_fmtZ tweet_datemessageZ date_limitr r rcheck_date_limitys0   zTweetHandlerI.check_date_limit)rNN)F) rrrrrrr&r(r0r r r rr Os   r )rtimerabcrrrrrrrr#rr r r r rs