B >?[@sdZddlZddlmZmZddlmZmZmZddl m Z ddl m Z GdddeZ e Ze eGd d d eZGd d d eZdS) zY This module provides an interface for TweetHandlers, and support for timezone handling. N)ABCMetaabstractmethod)tzinfo timedeltadatetime) add_metaclass)UTCc@s@eZdZdZeej dZejr0eej 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 )ZsecondscCs|jS)z2 Access the relevant time offset. ) DSTOFFSET)selfZdtr /lib/python3.7/site-packages/nltk/twitter/api.py utcoffset,sz$LocalTimezoneOffsetWithUTC.utcoffsetN) __name__ __module__ __qualname____doc__r_timeZtimezoneZ STDOFFSETZdaylightZaltzoner rr r r r r s  r c@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__?szBasicTweetHandler.__init__cCs|j|jko|j S)zL Returns `False` if the client should stop fetching Tweets. )rrr)r r r r do_continueNszBasicTweetHandler.do_continueN)r)rrrrrrr r r r r6s rc@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|_|r,t|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 rrrr r r r[s zTweetHandlerI.__init__cCsdS)zJ Deal appropriately with data returned by the Twitter API Nr )r datar r r handlesszTweetHandlerI.handlecCsdS)z? Actions when the tweet limit has been reached Nr )r r r r on_finishyszTweetHandlerI.on_finishFcCs|js |jrd}t|d|jtd}|jr8||jksH|jr||jkr|jrZd}|j}n d}|j}|rztd|||d|_dS) z' Validate date limits. z%a %b %d %H:%M:%S +0000 %YZ created_at)rZearlierZlaterz4Date limit {0} is {1} than date of current tweet {2}TN) rrrZstrptimereplacerprintformatr)r rverboseZdate_fmtZ tweet_datemessageZ date_limitr r r check_date_limits   zTweetHandlerI.check_date_limit)rNN)F) rrrrrrr r!r'r r r r rUs    r)rZtimerabcrrrrrZsixrZ nltk.compatrr robjectrrr r r r  s