QdTdZddlZddlmZmZddlmZmZmZm Z Gdde Z e Z Gdde Z Gd d e Z dS) zY This module provides an interface for TweetHandlers, and support for timezone handling. N)ABCMetaabstractmethod)datetime timedeltatimezonetzinfocteZdZdZeej Zejreej Z neZ dZ 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 )secondsc|jS)z2 Access the relevant time offset. ) DSTOFFSET)selfdts 0lib/python3.11/site-packages/nltk/twitter/api.py utcoffsetz$LocalTimezoneOffsetWithUTC.utcoffset's ~N) __name__ __module__ __qualname____doc__r_timer STDOFFSETdaylightaltzoner rrrr r sl   5>/222I ~Iu}n555  rr c eZdZdZddZdZdS)BasicTweetHandlerz Minimal implementation of `TweetHandler`. Counts the number of Tweets and decides when the client should stop fetching them. cB||_d|_ d|_ d|_dS)NrF)limitcounterdo_stopmax_id)rr s r__init__zBasicTweetHandler.__init__9s0      rc2|j|jko|j S)zL Returns `False` if the client should stop fetching Tweets. )r!r r"rs r do_continuezBasicTweetHandler.do_continueHs|dj(=-==rN)r)rrrrr$r'rrrrr1sA    >>>>>rr) metaclasscNeZdZdZd dZedZedZd dZdS) TweetHandlerIzu Interface class whose subclasses should implement a handle method that Twitter clients can delegate to. rNct||d|_d|_|rt |dt i|_|rt |dt i|_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)rr$upper_date_limitlower_date_limitrLOCAL startingup)rr r,r-s rr$zTweetHandlerI.__init__Uss ""4/// $ $  N$,.>$Mu$M$MD !  N$,.>$Mu$M$MD !rcdS)zJ Deal appropriately with data returned by the Twitter API Nr)rdatas rhandlezTweetHandlerI.handlemrcdS)z? Actions when the tweet limit has been reached Nrr&s r on_finishzTweetHandlerI.on_finishsr3rFcz|js|jrd}tj|d|t j}|jr ||jks|jrV||jkrM|jr d}|j}n d}|j}|r$td|||d|_ dSdSdSdS) z' Validate date limits. z%a %b %d %H:%M:%S +0000 %Y created_at)rearlierlaterz1Date limit {} is {} than date of current tweet {}TN) r,r-rstrptimereplacerutcprintformatr")rr1verbosedate_fmt tweet_datemessage date_limits rcheck_date_limitzTweetHandlerI.check_date_limitys   $D$9 $3H!*4 +=xHHPP|QJ% $*t7L*L*L%+M*4t7L*L*L(7'G!%!6JJ%G!%!6JKRR& $ ) $ $ +M*L*L*Lr)rNN)F) rrrrr$rr2r5rDrrrr*r*Os| 0  ^   ^ $$$$$$rr*)rtimerabcrrrrrrr r.rr*rrrrGs ''''''''::::::::::::6 #"$$>>>>>'>>>>