Metadata-Version: 1.1
Name: Yatcobot
Version: 2.2.13
Summary: The best bot for searching twitter contests and automatically retweet them
Home-page: https://github.com/buluba89/Yatcobot
Author: John Buluba
Author-email: UNKNOWN
License: UNKNOWN
Project-URL: Source, https://github.com/buluba89/Yatcobot
Description: .. figure:: https://thumb.ibb.co/hLfUvS/Screenshot_from_2018_03_30_04_47_49.png
          :height: 100px
          :alt: logo
          :align: right
        
        *The best bot for retweeting twitter giveaways!*
        
        |Build Status| |codecov.io| |Codeclimate maintainability|
        
        
        | Do you want **free** stuff?
        | Do you like to **win**?
        | Do you want to participate in twitter **giveaways** but you dont have the time to search and retweet?
        | Yatcobot is the solution! A bot that search and retweet giveaways automatically!
        |
        
        Features:
        ---------
        
        - **Search for new giveaways** 
          *Search and queue tweets to retweet, with a customizable way*
        
        - **Retweet** 
          *Obviously...*
        
        - **Advanced sort** 
          *Prioritize tweets found based on parameters like user defined keywords, age and popularity*
        
        - **Notification**
          *Can notify you using pushbullet when someone mentions you so you can quickly get your precious gift*
        
        
        .. WARNING::
          Your account may be banned for using this kind of bot, so dont use your primary account
        
        ----
        
        **Visit our** `documentation <https://yatcobot.readthedocs.io/en/master/>`_ **for more info or
        follow these steps for a quick start!**
        
        Installation
        ============
        
        The easiest way to install is::
        
            pip install yatcobot
        
        See more at `Installation <https://yatcobot.readthedocs.io/en/master/installation.html/>`_
        
        
        Configuration
        =============
        Before starting you must get api keys from twitter. You can get these keys from `here <https://apps.twitter.com/>`_.
        (See more at `How to get twitter api keys <https://yatcobot.readthedocs.io/en/master/api_keys.html/>`_)
        
        You must create a config named `config.yaml` and must at least set the api keys. A minimal config.yaml is
        
        .. code-block:: yaml
        
            twitter:
                consumer_key: your_consumer_key
                consumer_secret: your_consumer_secret
                access_token_key: your_access_token
                access_token_secret: your_access_token_secret
            
        
        You can edit config.sample.yaml that is placed in the root of the project (`dont forget to rename it to config.yaml`) or view the sample `on github <https://github.com/buluba89/Yatcobot/blob/master/config.sample.yaml>`_
        
        
        Config file is loaded automatically from specific paths. The paths that are searched for config.yaml are (from highest priority to lowest):
        
        1. *./config.yaml*
            Search for config in the current working directory
        2. *~/.config/Yatcobot/config.yaml*
            Search in config folder. If for example your username is `user` the full path will be `/home/user/.config/Yatcobot/config.yaml`
        3. *default*
            The default config that is packaged with the bot.
        
        Also you can define another config with the **--config** argument, which will have the highest priority
        
        Higher priority configs override settings that are defined in the lower. So in your config you only need to define the changes.
        (See more at `Configuration documentation <https://yatcobot.readthedocs.io/en/master/config.html/>`_)
        
        
        
        Run
        ===
        In the directory where your config.yaml run::
        
            yatcobot
        
        Or you can specify the path of config with:
        
            yatcobot --config=/path/to/config.yaml
        
        See more at `Command Line Arguments <https://yatcobot.readthedocs.io/en/master/cli.html/>`_
        
        
        Now just wait for all the **free gifts!**
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        ----
        
        Documentation
        =============
        For more info visit our docs: `documentation <https://yatcobot.readthedocs.io/en/master/>`_ .
        
        ----
        
        Donate
        ======
        
        Please donate to support the development if you find this software useful (`or if you are so rich from the staff you won`).
        
        
        |Flattr this git repo|
        
        |Donate with Patreon|
        
        |Donate with Paypal|
        
        |Donate with Bitcoin|
        
        |Donate with Litecoin|
        
        |Donate with Ethereum|
        
        
        .. |Flattr this git repo| image:: http://api.flattr.com/button/flattr-badge-large.png
           :target: https://flattr.com/submit/auto?user_id=buluba89&url=https://github.com/buluba89/Yatcobot&title=Yatcobot&language=GH_PROJECT_PROG_LANGUAGE&tags=github&category=software
        
        .. |Donate with Patreon| image:: https://img.shields.io/badge/patreon-donate-yellow.svg
           :target: https://www.patreon.com/johnbuluba
        
        .. |Donate with Paypal| image:: https://img.shields.io/badge/Donate-PayPal-green.svg
           :target: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=QWCTMJZ9JME3L&lc=GR&item_name=Yatcobot&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted
        
        .. |Donate with Bitcoin| image:: https://en.cryptobadges.io/badge/small/19iX7wCSzjmr66BY7h3uGRqKWGxuoddjLN
           :target: https://en.cryptobadges.io/donate/19iX7wCSzjmr66BY7h3uGRqKWGxuoddjLN
        
        .. |Donate with Litecoin| image:: https://en.cryptobadges.io/badge/small/LPzjwWzAPBeUWoeKsusZKEsavkmDS83fRR
           :target: https://en.cryptobadges.io/donate/LPzjwWzAPBeUWoeKsusZKEsavkmDS83fRR
        
        .. |Donate with Ethereum| image:: https://en.cryptobadges.io/badge/small/0x1c1304173d05c61903789de07a3edcc9629e0222
           :target: https://en.cryptobadges.io/donate/0x1c1304173d05c61903789de07a3edcc9629e0222
        
        
        .. |Build Status| image:: https://travis-ci.org/buluba89/Yatcobot.svg?branch=master
           :target: https://travis-ci.org/buluba89/Yatcobot
        .. |codecov.io| image:: https://codecov.io/gh/buluba89/Yatcobot/branch/master/graph/badge.svg
          :target: https://codecov.io/gh/buluba89/Yatcobot
        .. |Codeclimate maintainability| image:: https://api.codeclimate.com/v1/badges/a99a88d28ad37a79dbf6/maintainability
           :target: https://codeclimate.com/github/buluba89/Yatcobot/maintainability
           :alt: Maintainability
        .. |logo| image:: https://thumb.ibb.co/hLfUvS/Screenshot_from_2018_03_30_04_47_49.png
          :height: 100px
          :alt: logo
          :scale: 50 %
        
        Licence
        =======
        
        This program is released under GPL v2
        
Keywords: twitter bot contest retweet
Platform: UNKNOWN
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
