naoyat / Mastodon.py

Python wrapper for the Mastodon ( https://github.com/tootsuite/mastodon/ ) API.

Mastodon.py

from mastodon import Mastodon

# Register app - only once!
'''
Mastodon.create_app(
     'pytooterapp',
      to_file = 'pytooter_clientcred.txt'
)
'''

# Log in - either every time, or use persisted
'''
mastodon = Mastodon(client_id = 'pytooter_clientcred.txt')
mastodon.log_in(
    '[e-mail]',
    'incrediblygoodpassword',
    to_file = 'pytooter_usercred.txt'
)
'''

# Create actual instance
mastodon = Mastodon(
    client_id = 'pytooter_clientcred.txt',
    access_token = 'pytooter_usercred.txt'
)
mastodon.toot('Tooting from python!')

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

You can install Mastodon.py via pypi:

# Python 2
pip install Mastodon.py

# Python 3
pip3 install Mastodon.py

Full documentation and basic "how to post a toot" usage example can be found at http://mastodonpy.readthedocs.io/en/latest/ .

Full "real life" example of how to use this library to write a Mastodon bot will be linked here shortly.