ó ù`]c@s¿dZddlZddlmZmZddlmZmZmZddl m Z ddl m Z defd„ƒYZ e ƒZe eƒd efd „ƒYƒZd efd „ƒYZdS( sY This module provides an interface for TweetHandlers, and support for timezone handling. iÿÿÿÿN(tABCMetatabstractmethod(ttzinfot timedeltatdatetime(t add_metaclass(tUTCtLocalTimezoneOffsetWithUTCcBsOeZdZedej ƒZejr>edej ƒZ neZ d„Z RS(s» 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 tsecondscCs|jS(s2 Access the relevant time offset. (t DSTOFFSET(tselftdt((s/lib/python2.7/site-packages/nltk/twitter/api.pyt utcoffset,s( t__name__t __module__t__doc__Rt_timettimezonet STDOFFSETtdaylighttaltzoneR R (((s/lib/python2.7/site-packages/nltk/twitter/api.pyRs   tBasicTweetHandlercBs#eZdZdd„Zd„ZRS(s Minimal implementation of `TweetHandler`. Counts the number of Tweets and decides when the client should stop fetching them. icCs(||_d|_t|_d|_dS(Ni(tlimittcountertFalsetdo_stoptNonetmax_id(R R((s/lib/python2.7/site-packages/nltk/twitter/api.pyt__init__?s   cCs|j|jko|j S(sL Returns `False` if the client should stop fetching Tweets. (RRR(R ((s/lib/python2.7/site-packages/nltk/twitter/api.pyt do_continueNs(R RRRR(((s/lib/python2.7/site-packages/nltk/twitter/api.pyR6s t TweetHandlerIcBsJeZdZdddd„Zed„ƒZed„ƒZed„Z RS(su Interface class whose subclasses should implement a handle method that Twitter clients can delegate to. icCsktj||ƒd|_d|_|r@tdt|Œ|_n|r^tdt|Œ|_nt|_dS(s :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. RN( RRRtupper_date_limittlower_date_limitRtLOCALtTruet startingup(R RRR ((s/lib/python2.7/site-packages/nltk/twitter/api.pyR[s   cCsdS(sJ Deal appropriately with data returned by the Twitter API N((R tdata((s/lib/python2.7/site-packages/nltk/twitter/api.pythandlestcCsdS(s? Actions when the tweet limit has been reached N((R ((s/lib/python2.7/site-packages/nltk/twitter/api.pyt on_finishyR&cCsÄ|js|jrÀd}tj|d|ƒjdtƒ}|jrR||jksj|jrÀ||jkrÀ|jr…d}|j}nd}|j}|r±dj|||ƒGHnt|_qÀndS(s' Validate date limits. s%a %b %d %H:%M:%S +0000 %Yt created_atRtearliertlaters4Date limit {0} is {1} than date of current tweet {2}N( RR RtstrptimetreplaceRtformatR"R(R R$tverbosetdate_fmtt tweet_datetmessaget date_limit((s/lib/python2.7/site-packages/nltk/twitter/api.pytcheck_date_limits    N( R RRRRRR%R'RR3(((s/lib/python2.7/site-packages/nltk/twitter/api.pyRUs (RttimeRtabcRRRRRtsixRt nltk.compatRRR!tobjectRR(((s/lib/python2.7/site-packages/nltk/twitter/api.pyt s