Python wrapper for the Mastodon (https://github.com/mastodon/mastodon) API.
Anar al arxiu
Elizabeth Myers 6067aa4604 Workaround Mastodon issue with streaming API redirection
Mastodon can be configured to use another address for streaming
server-side. Such a setup is common with certain deployments.

However, due to a bug, Mastodon does not properly issue HTTP redirects
for anything but the endpoint /api/v1/streaming (including subdirs). It
instead gives a 404, causing the request to fail.

The workaround is to hit this path first, checking for any redirects,
and modifying the URL accordingly.

This commit also includes a workaround for behaviour in requests that
causes it to strip the Authorization header from redirected requests.
This is intentional behaviour on the part of requests, but breaks the
redirection done by Mastodon.

Fixes #84
2017-09-16 10:05:44 -05:00
docs Maintenance release 2017-09-10 17:05:57 +02:00
mastodon Workaround Mastodon issue with streaming API redirection 2017-09-16 10:05:44 -05:00
tests not pep8 compliant #71 2017-09-05 22:59:32 +02:00
.gitignore Add support for OAuth2 2017-04-07 21:59:39 +00:00
CHANGELOG.rst Changelog 1.1.1 2017-09-10 23:27:35 +02:00
DEVELOPMENT.md Update DEVELOPMENT.md 2017-09-10 23:33:56 +02:00
LICENSE Initial commit 2016-11-23 23:29:30 +01:00
MANIFEST.in Create MANIFEST.in 2017-04-04 23:32:35 -07:00
README.rst Update README.rst 2017-09-08 17:45:22 +02:00
setup.cfg Set up pytest 2017-04-10 08:00:43 +01:00
setup.py Maintenance release 2017-09-10 17:05:57 +02:00

Mastodon.py
===========
.. code-block:: python

   from mastodon import Mastodon

   # Register app - only once!
   '''
   Mastodon.create_app(
        'pytooterapp',
        api_base_url = 'https://mastodon.social',
        to_file = 'pytooter_clientcred.secret'
   )
   '''

   # Log in - either every time, or use persisted
   '''
   mastodon = Mastodon(
       client_id = 'pytooter_clientcred.secret',
       api_base_url = 'https://mastodon.social'
   )
   mastodon.log_in(
       'my_login_email@example.com',
       'incrediblygoodpassword',
       to_file = 'pytooter_usercred.secret'
   )
   '''

   # Create actual API instance
   mastodon = Mastodon(
       client_id = 'pytooter_clientcred.secret', 
       access_token = 'pytooter_usercred.secret',
       api_base_url = 'https://mastodon.social'
   )
   mastodon.toot('Tooting from python using #mastodonpy !')

Python wrapper for the Mastodon ( https://github.com/tootsuite/mastodon/ ) API. 
Feature complete for public API as of version v1.6 and easy to get started with.

You can install Mastodon.py via pypi:

.. code-block:: Bash

   # Python 2
   pip install Mastodon.py
   
   # Python 3
   pip3 install Mastodon.py

Full documentation and basic usage examples can be found 
at http://mastodonpy.readthedocs.io/en/latest/ .