This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

tweebot

A twitter bot client, written in Python. This can be used as either a command-line tool, or as a library imported into your Python applications.

Requirements

  1. Python 3.3+
  2. A twitter account

Installation

To install:

make install

Development

To build the dev environment:

make venv
. venv/bin/activate
python main.py

Configuration

The application will only try to tweet if you provide a key file, which is formatted like:

CONSUMER_KEY: dsafsafafsd
CONSUMER_SECRET: iuhbfusdfiu44
ACCESS_KEY: vjhbv99889
ACCESS_SECRET: ivfjslfiguhg98

OR the equivalent JSON.

The filename must be provided using the --keys command-line argument.

Command-line usage

Tweeting

To tweet a simple status update:

tweebot --keys {twitter-key-file} tweet "Hello world, this is my Tweebot status update!" -vv

You can control verbosity with the number of vs.

More command-line options are possible, try --help to see them all.

If you use - for the tweet text, the application will use standard input, which can be handy for piping info from your bots – ie, use an arbitrary application to pipe to tweebot which can tweet it out.

Following

To automatically follow new followers, and unfollow unfollowers:

tweebot --keys {twitter-key-file} follow --auto

Library usage

There are two basic ways you can use this in a library: you can either import the TwitterClient class and control that from your application, or you can import tweebot’s main function and provide it with a callback that will generate your status updates.

tweebot.main

If you provide a callable to tweebot.main, then tweebot will use it as a callback when the main function is called. The main method implements all the command-line tweebot arguments, the difference is that if the program is asked to tweet an empty status, it will instead tweet the results of your method, called with no arguments. If you tweet a non-empty status, that string will be handed to your method, and the result will be tweeted:

mytweebot --keys {twitter-key-file} tweet -vv

Thus, this provides a simple way to define new twitter-bots: define a method of the form:

def my_tweet_builder(status, directives):
    new_status = do_something()
    return new_status
    # or
    return new_status, new_directives

This can either ignore the status it’s given, or use it in any way you wish. If you have multiple bots that modify the status when given, then you could run them independently, or pipe them together in novel ways without recompiling – your choice.

Direct client use

If you want your application to be in control, you can simply import tweebot.TwitterClient and use its methods directly. This includes direct API access (via tweepy) to twitter, and few custom, convenience methods.

Release History

Release History

0.2.1

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.2.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
tweebot-0.2.1.tar.gz (7.9 kB) Copy SHA256 Checksum SHA256 Source May 29, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting