docs: document StreamListener.on_error more thoroughly

docs: include streaming_how_to in TOC

v3.3.0

Merge pull request #561 from michaelbrooks/stream-disconnection

Prevent infinite read loop in tweepy Stream

Merge pull request #562 from RussellTaylor83/master

Update api.py

Update api.py

Made catch statement error message more explicit for _pack_image

use closed property, not _fp

check for closed fp in stream reading

Merge pull request #557 from marionleborgne/loosen-version-requirements

Allow multiple versions to be installed

Merge pull request #559 from pvanderlinden/streaming-improvements

Streaming improvements

Merge pull request #558 from tweepy/fix-556

Fix bug where streams freeze up on Python 3 due to string formatting bug...

send out keep alive

fix: new session after closing should honour original headers and params

raise exception with original traceback

Remove urlencode_noplus util method.

Fix bug where streams freeze up on Python 3 due to string formatting bug.

Remove usage of urlencode_noplus and instead let Requests handle the encoding work for us.

Fixes #556

Allow multiple versions to be installed

Merge pull request #547 from skoczen/master

Fixes error message on file too big to reflect actual file size limit.

Merge pull request #548 from dfm/patch-1

More consistent SVG badges

Enable container travis builds.

Prepare for 3.2.0 release. Update change log and bump version.

Consistent docs badge

Nicer badges

Fixes missing string sub.

Fixes max size error message.

Merge pull request #542 from volnt/master

Fix issue #541

Add media_ids parameter to update_status.

`statuses/update` now support the parameter `media_ids`. It makes it
possible to update a status with an attached media.

See also :

[doc](https://dev.twitter.com/rest/reference/post/statuses/update)

Add media/upload endpoint.

The media/upload endpoint is located on a different server :
upload.twitter.com.

It returns a unique result model called `Media` containing the
`media_id` and the image infos.

See also :

* [doc](https://dev.twitter.com/rest/reference/post/media/upload)

Merge pull request #535 from groceryheist/master

Add Documentation Page for streaming

fix formatting in last code snippet.

refer to streaming.py in the source code because not all features are covered in this tutorial.

Add a Few More Pointers to streaming_how_to.rst to cover Async and error handling.

Merge branch 'master' of https://github.com/tweepy/tweepy

Add streaming_how_to.rst. A high level tutorial for getting started with streaming.

Merge pull request #534 from wdahlenburg/master

Updated requirements for pip 6.0+ to include a session

Updated requirements for pip 6.0+ to include a session

Merge pull request #530 from elanting/master

fixed issue #529

fixed issue #529

Merge pull request #526 from skoczen/master

Fixes to docs - auth tutorial docs were busted!

Adds to contrib

Fixes up outdated(?) docs.

Merge pull request #524 from AnSavvides/patch-1

Update reference to api search documentation

Update reference to api search documentation

Fix tweepy.debug() by using six's module helpers.

Fixup

Merge pull request #522 from BigxMac/master

Fixed httplib import

Commented Out Body of debug

Fixed httplib import

In Python 3 httplib should be imported and used as http.client

Add docs badge.

Upgrade trends methods documentation.

Remove deprecated trends methods.

Omit site packages from the coverage reports.

Fix version to include 3 digits.

Release 3.1

Fix coveralls.

Enable cursor tests in Travis builds.

Merge pull request #518 from yprez/fix-iterator-params

Attempt to fix cursor invocation

Setup a nosetests config file for Travis builds.

Tiddy up travis file.

Fix cursor invocation, passing args to underlying method

Regression test for #518

Upgrade Requests to 2.4.3

Remove old install file.

Run tests for both Python 2.7 and 3.4

Distribute Python Wheels

Merge pull request #497 from tewalds/cert

Allow specifying your own ssl certificates.

Update cassette to get tests passing.

Release 3.0.0

Configure Travis to deploy releases when pushing to "release" branch.

Commit cassette files in hopes of fixing the travis tests.

Merge pull request #509 from judy2k/fix-examples

Updated examples to work in Python 3.

Merge pull request #511 from yprez/fix-iterators

Fix CursorIterator.next() for Python 3

Merge pull request #513 from 7kry/master

Modify ReadBuffer for Py3

Modify ReadBuffer for Py3

On my Python 3.4.2 environment, UserStreaming did't work
because of an error of bytes-to-str conversion.

Fix CursorIterator.next() for Python 3

It was calling next, but returning None

Merge pull request #508 from judy2k/setup-classifiers

Classify tweepy.

Updated examples to work in Python 3.

Classify tweepy.

Merge pull request #507 from judy2k/python3-tox-vcrpy-squash

Port to Python 3.3+

Port to Python 3.3+

Merge pull request #505 from joausaga/master

Modify on_data method of StreamListener to process warning messages

Extend on_data method by including a conditional to process warning messages and add the definition of the method to manage those warning messages

Merge pull request #502 from JulienPalard/patch-1

FIX: To create an app it's not dev.twitter.com but apps.twitter.com

FIX: To create an app it's not dev.twitter.com but apps.twitter.com

Revert "Treat IncompleteRead as a disconnect or timeout, and reconnect."

This reverts commit c841a09a0a05b27979a5768274735d6fde184ea2.

Merge pull request #500 from rother/master

Update api.rst

Merge pull request #496 from tewalds/buffer

Add a read buffer so that tweepy does fewer socket.read calls.

Merge pull request #499 from tewalds/unescape

Revert "Unescape stream data from Twitter"

Revert "Unescape stream data from Twitter"

This reverts commit 09e29c815bd21514ec62df2cd8e8d176678bee40 and fixes https://github.com/tweepy/tweepy/issues/495

Update api.rst

Added missing since_id parameter for search()

Merge pull request #498 from tewalds/incompleteread

Treat IncompleteRead as a disconnect or timeout, and reconnect.

Treat IncompleteRead as a disconnect or timeout, and reconnect.

Add ReadBuffer unit tests.

Allow specifying your own ssl certificates.

Add a read buffer so that tweepy does fewer socket.read calls, which are expensive on GAE.

Merge pull request #494 from jozef-mitro/master

Fix sample to use Requests instead of httplib

Fix sample to use Requests instead of httplib

Merge pull request #492 from Kjwon15/compare-status

Comparison between Status object

Add __ne__ method for tweepy.models.Status

Comparison between Status object