Return cursors when calling method from DMCursorIterator

This adds a return_cursors kwarg and attribute to APIMethod that can be used to explicitly specify to return cursors with the result.
The existing check for the cursor session parameter has been refactored from JSONParser.parse to APIMethod.execute.
This means that the parser's parse method is called with a return_cursors kwarg.
All parsers in the library have been updated to reflect this change.

Handle empty pages in ItemIterator

Add DMCursorIterator

Fix Cursor set start test

Update subclasses of BaseIterator to modify the kwargs attribute rather than the local variable

Pass args and kwargs properly

Replace references to kargs with kwargs

Fix misspelling in API.search documentation

Copied from Twitter's API

Merge pull request #1260 from cmarshall108/patch-1

api: fixed typo

api: fixed typo

Merge pull request #1229 from kylepw/consumerkey

Change `consumer token` to `consumer key` in documentation

Improve examples in extended Tweet documentation

Improve wording in extended Tweets documentation

Improve wording in extended Tweets documentation

Fix section title styles in Cursor tutorial documentation

Remove misplaced section in Cursor tutorial documentation

Remove improper note in documentation for API.get_status

Improve footnote formatting in extended Tweets documentation

Add extended Tweets documentation to index

Add documentation for extended Tweets

Order tests alphabetically in Travis CI tests configuration

Order tests alphabetically in tox configuration

Include resultset tests in tox configuration

Fix documentation for API.search return type

Update documentation badge to v3.8.0

Release v3.8.0

Add changelog for version 3.8.0

Merge pull request #1228 from tweepy/dm-migration

Direct Message migration

Merge branch 'master' into dm-migration

Update cassettes

Update testsendanddestroydirectmessage.json and replace testdirectmessages.json and testsentdirectmessages.json with testlistdirectmessages.json

Merge pull request #1242 from tweepy/tests-and-cassettes-update

Update tests and cassettes

Remove old Travis CI environment variables

For credentials for old test account

Update cassettes

Update default test account

Generalize hardcoded tests

Skip DM tests for now

Lower test requirements for Tweets and Following

Fix test for API.supported_languages

Fix screen name capitalization in tests

Standardize inline comment spacing in API tests

Remove methods using deprecated GET users/suggestions endpoints

This removes API.suggested_categories, API.suggested_users, and API.suggested_users_tweets, as the endpoints these methods use are now deprecated, return a 410 Gone error since June 30, 2019, and should no longer be used.
This also removes the corresponding tests and cassettes and the now obsolete Category model.

Reference:
https://twittercommunity.com/t/upcoming-changes-to-user-object-and-get-users-suggestions-endpoints/124732

Close Requests sessions

Fixes #810
Fixes #1093
Resolves #1237

Correct documentation for API.update_status

Fixes #1235

Change `consumer token` refs to `consumer key`

Update documentation for API.update_list

Update documentation for API.destroy_list

Merge pull request #1169 from HenriqueHott/master

Added _json attribute to Models: List, Friendship and Category

Add spaces after commas

Remove unnecessary whitespace changes

Merge pull request #1227 from kylepw/appauth

Add tweepy.AppAuthHandler documentation

Merge pull request #939 from gardir/master

Added possibility to compare `eq` and `ne` between users, using the unique `id`s.

Exclude Python 3.4 from setup python_requires

Include resultset tests in CI

Fix resultset tests

Update auth tests to be compatible with Python 3

Improve import organization

Replace deprecated assert_ in tests

With assertTrue
https://docs.python.org/3/library/unittest.html#deprecated-aliases

Replace deprecated assertEquals in tests

With assertEqual
https://docs.python.org/3/library/unittest.html#deprecated-aliases

Update test for API.send_direct_message and API.destroy_direct_message

Update API.destroy_direct_message

Update API.send_direct_message

Update API.get_direct_message

Replace API.direct_messages and API.sent_direct_messages

With API.list_direct_messages

Add tweepy.AppAuthHandler documentation.

Update DirectMessage model

Get loggers through implicit module names

Replace usage of root logger

Remove unnecessary type cast when logging unknown streaming message type

Merge pull request #886 from sjhewitt/streaming-events

handle scrub_geo, status_withheld and user_withheld streaming events

Remove outdated allowed parameters for API.search

Update documentation for API.search

Resolves #1199

Add documentation for API.remove_list_members

Update documentation for API.add_list_member

Improve documentation for API.add_list_members

Merge pull request #704 from hugovk/patch-1

[docs] Lists can have 5,000 members

Use raw strings for regex patterns

Add count as allowed parameter for API.friends

Add changelog for version 3.7.0

Add changelog for version 3.6.0

Add v3.4.0 and v3.5.0 to changelog

Add @blcksrx to contributors

Per request

Add documentation for API.mutes

Merge pull request #1215 from blcksrx/mutes

Add API.mutes

fix unvoluntry commit

Add API.mutes_list

Update friends_timeline to home_timeline in code snippet documentation

Update documentation for API.list_members

Resolves #738

Update documentation for API.is_subscribed_list to API.show_list_subscriber

Resolves #1202

Update documentation for API.get_list

Resolves #1201

Update documentation for API.is_list_member to API.show_list_member

Organize documentation parameters alphabetically

Correct documentation for API.report_spam

Merge pull request #1090 from shuuji3/add-support-report_spam-perform_block-param

Add a support of the 'perform_block' param for api.report_spam() method

Update documentation for API.create_list

Merge pull request #904 from Prakash2403/patch-1

Added missing return keyword

Drop support for Python 3.4

Python 3.4 has now reached its end-of-life and has been retired.
https://www.python.org/dev/peps/pep-0429/

Update setup Development Status classifier

Change API.mutes_ids payload type to ids

Merge pull request #931 from codingcatgirl/patch-1

Change API.blocks_ids payload type to ids

Merge branch 'master' into patch-1

Merge pull request #1208 from okomarov/feature/add_cursor_option

Add cursor param to blocks_ids and mutes_ids