roblox.py
=========

.. toctree::
    :maxdepth: 3
    :caption: Contents:

    api
    changelog

**roblox.py** is the easiest to use Python library for the ROBLOX site.

It's already capable of many things,
supporting several features outside of the usual `roblox api`_,
but there's a lot more to come.

.. _roblox api: https://api.roblox.com/docs

Getting Started
===============

You can install the project with ``$ pip install roblox.py``

An Example(tm) ::

    import roblox

    # I wanna let my friends know how much I love them
    with roblox.RobloxSession(username="iLoveBricks", password="password123") as rbx:
        for friendship in rbx.friendships():
            try:
                convo = rbx.chat.start_conversation(friendship.user1)
                convo.send_message("ily!  ~ iLoveBricks")
            except roblox.errors.RobloxException:
                print("Couldn't send message to {}".format(friendship.user1))

.. _github: https://github.com/reshanie/roblox.py