Python wrapper for the Mastodon (https://github.com/mastodon/mastodon) API.
Go to file
Lorenz Diener 4b00c448f4 Add another bunch of tests 2018-05-06 02:50:54 +02:00
docs First steps to 2.3.0 support 2018-04-17 17:49:08 +02:00
mastodon Fix daemonization in python 2 2018-05-06 01:45:02 +02:00
tests Add another bunch of tests 2018-05-06 02:50:54 +02:00
.gitignore Add support for OAuth2 2017-04-07 21:59:39 +00:00
.travis.yml Revert "travis: only notify when a build starts failing, not every time" 2017-11-29 02:42:07 +01:00
CHANGELOG.rst Prepare release 1.2.2 2018-01-29 15:10:28 +01:00
DEVELOPMENT.md Update DEVELOPMENT.md 2018-04-17 18:19:30 +02:00
LICENSE Initial commit 2016-11-23 23:29:30 +01:00
MANIFEST.in Update MANIFEST.in 2018-05-06 01:46:42 +02:00
README.rst Knew I forgot to bump version somewhere. 2018-01-29 15:33:20 +01:00
setup.cfg add coverage reports to tests 2017-11-27 00:39:53 +01:00
setup.py Prepare release 1.2.2 2018-01-29 15:10:28 +01:00

README.rst

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 Mastodon version 2.2.0 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/ .

Acknowledgements
----------------
Mastodon.py contains work by a large amount of contributors, many of which have
put significant work into making it a better library. You can find some information
about who helped with which particular feature or fix in the changelog.

.. image:: https://travis-ci.org/halcy/Mastodon.py.svg?branch=master
    :target: https://travis-ci.org/halcy/Mastodon.py
.. image:: https://codecov.io/gh/halcy/Mastodon.py/branch/master/graph/badge.svg
    :target: https://codecov.io/gh/halcy/Mastodon.py