Welcome to rt_api’s documentation!

rt_api is a python client for the Rooster Teeth Api. It allows easy access to resources such as episodes, seasons, shows, and users.

It supports Python 2.7, 3.4, 3.5, 3.6, and 3.7

Quickstart

Installation

To install rt_api, run:

pip install rt_api

Alternatively rt_api can be installed from source by cloning the repository and running setuptools:

git clone https://github.com/NickMolloy/rt_api
cd rt_api
python setup.py install

Using rt_api

The main entry point for the library is the Api class. Instantiating this class will give access to all of the API functionality. For example:

from rt_api.api import Api

api = Api()  # Instantiate api. Generates default access token.
latest_episodes = api.episodes()  # Get an iterable of the latest episodes
newest_episode = next(latest_episodes)
print(newest_episode.title)  # Print out episode title
show = newest_episode.show  # Get a reference to the show the episode is from
print(show.name)  # Print out name of the show

If you want to be able to perform actions as a specific user, you must first authenticate:

from rt_api.api import Api

api = Api()
api.authenticate("myUsername", "myPassword")  # Authenticate as myUsername

From this point, all actions performed will be done in the context of that user. For instance, the current user is available through the me attribute of the api:

my_user = api.me  # Get the user object associated with the authenticated user
my_user.queue  # Get the current user's episode watch list

For more information on the available actions, see the package documentation, or some examples.

Codebase Overview

rt_api.api contains the api itself, which actually performs the api actions.

rt_api.models contains the models of the api.

Indices and tables