Metadata-Version: 1.1
Name: schedule-tweet
Version: 1.0.0
Summary: Schedules tweets using TweetDeck
Home-page: https://github.com/honzajavorek/schedule-tweet
Author: Honza Javorek
Author-email: mail@honzajavorek.cz
License: MIT
Description: Schedule Tweet
        ==============
        
        Automated tweet scheduling using TweetDeck. Uses `Selenium <http://docs.seleniumhq.org/>`_ to spawn a browser, log in to TweetDeck with your credentials, and schedule a tweet on your behalf by clicking on things in the app.
        
        Installation
        ------------
        
        Install `geckodriver <https://github.com/mozilla/geckodriver>`_. On macOS with `Homebrew <http://homebrew.sh/>`_ you can use ``brew install geckodriver``. Then...
        
        ..code:: shell
        
            $ pip install schedule_tweet
        
        Only **Python 3.6** and higher is supported.
        
        Usage
        -----
        
        ..code:: python
        
            >>> import os
            >>> from datetime import datetime, timedelta
            >>>
            >>> import schedule_tweet
            >>>
            >>> username = 'schedule_tw'
            >>> password = os.getenv('PASSWORD')
            >>> now_dt = datetime.now()
            >>>
            >>> with schedule_tweet.session(username, password) as session:
            ...     dt = now_dt + timedelta(minutes=2)
            ...     session.tweet(dt, f'First Tweet 🚀 {dt.isoformat()}')
            ...
            ...     dt = now_dt + timedelta(minutes=3)
            ...     session.tweet(dt, f'Second Tweet 💥 {dt.isoformat()}')
        
        Tests
        -----
        
        Obviously, TweetDeck authors can change anything anytime, which may or may not break this tool. That's why it is tested by a `regular nightly Travis CI build <https://travis-ci.org/honzajavorek/schedule-tweet>`_. If it's able to schedule a tweet in the sample `@schedule_tw <https://twitter.com/schedule_tw>_` account, it assumes the tool still works and the build will pass. If the build badge is red, it means the tool doesn't work anymore and it needs to be updated.
        
        .. image:: https://travis-ci.org/honzajavorek/schedule-tweet.svg?branch=master
            :target: https://travis-ci.org/honzajavorek/schedule-tweet
        
        Why
        ---
        
        Twitter doesn't provide scheduling tweets in their API. It is provided only as a feature of `TweetDeck <http://tweetdeck.twitter.com/>`_, their advanced official client. Unlike other clients which support scheduling tweets, TweetDeck is free of charge, it is an official tool made by Twitter themselves, and it supports `teams <https://blog.twitter.com/official/en_us/a/2015/introducing-tweetdeck-teams.html>`_.
        
        The ``schedule-tweet`` tool was originally built to save precious volunteering time of the `PyCon CZ 2017 <https://cz.pycon.org/2017/>`_ social media team.
        
Keywords: tweet tweets twitter tweetdeck scheduling scheduler
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
