Metadata-Version: 2.1
Name: ritetag
Version: 1.0.2
Summary: RiteTag API client.
Home-page: https://github.com/pavelhouzva/ritetag-api-python
Author: Pavel Houžva
Author-email: pavel@ritekit.com
License: UNKNOWN
Description: # RiteTag API client
        
        Python API client
        
        ## Documentation
        
        [API Documentation](https://documenter.getpostman.com/view/2010712/SzS7Qku5?version=latest#3a6540d0-61e3-4333-b353-f1072621a23b)
        
        ## Installation
        
        `pip install --user ritetag`
        
        
        ## Usage
        
        ### In The Code
        ```python
        from ritetag import RiteTagApi
        
        access_token = 'token'
        client = RiteTagApi(access_token)
        
        def limit_80_percentage_reached(limit):
            message = 'Used {}% of API credits. The limit resets on {}'.format(limit.usage, limit.reset)
            print(message)
        
        # The callback function is triggered when 80% of the API limit is reached
        client.on_limit(80, limit_80_percentage_reached)
        
        stats = client.hashtag_stats(['jobs', 'hello'])
        
        for data in stats:
            print('#{}: {} tweets per hour'.format(data.hashtag, data.tweets))
        
        ```
        
        output:
        
        ```
        #jobs: 642 tweets per hour
        #hello: 25 tweets per hour
        ```
        
        ### In The Console
        
        ```
        ritetag-api -h
        usage: ritetag-api [-h] [-t ACCESS_TOKEN] [-m MAX_HASHTAGS] [-p {auto,end}]
                           [-f FILENAME] [-ci CTA_ID]
                           {hashtag_stats,auto_hashtags,hashtag_suggestions,hashtag_history,emojis_suggestion,auto_emojify,company_logo,list_of_cta,shorten_link}
                           [hashtags [hashtags ...]]
        
        RiteTag API console client.
        
        positional arguments:
          {hashtag_stats,auto_hashtags,hashtag_suggestions,hashtag_history,emojis_suggestion,auto_emojify,company_logo,list_of_cta,shorten_link}
                                action
          hashtags              hashtags
        
        optional arguments:
          -h, --help            show this help message and exit
          -t ACCESS_TOKEN, --access_token ACCESS_TOKEN
                                access token
          -m MAX_HASHTAGS, --max_hashtags MAX_HASHTAGS
          -p {auto,end}, --hashtag_position {auto,end}
          -f FILENAME, --filename FILENAME
          -ci CTA_ID, --cta_id CTA_ID
        ```
        
        
        ```
        export ACCESS_TOKEN={access_token}
        ritetag-api hashtag_stats jobs hello
        ```
        
        or
        
        `ritetag-api -t {access_token} hashtag_stats jobs hello`
        
        output:
        
        ```
        Used 19.89% of API credits. The limit resets on 2020-04-01.
        ==== Stats of #jobs ====
        tweets: 642
        retweets: 62
        exposure: 1984429
        mentions: 9.03427%
        links: 35.04673%
        images: 35.04673%
        color: HOT_NOW
        media count: 3490073
        
        ==== Stats of #hello ====
        tweets: 25
        retweets: 4
        exposure: 32567
        mentions: 32.0%
        links: 32.0%
        images: 32.0%
        color: HOT_NOW
        media count: 18896544
        
        ```
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires: requests
Requires-Python: >=2.7
Description-Content-Type: text/markdown
