pyne-xmas-elves 0.7.1

Installation

Make sure you have Python installed - if you have Windows, check out the Beginner’s Guide of the Xmas Elves document.

Once you’re ready, you can get the client code running:

pyvenv venv
. venv/bin/activate
pip install pyne-xmas-elves

Building your Bot

Create your game file, called game.py:

from pyne_xmas_elves.client import BaseGame


class Game(BaseGame):
    """Your main Game Class.
    """

    PLAYER_NAME = 'Tom Cooper'

    def turn(self, elves_available):
        """Take a single turn.

        The elves_available argument will tell you how many elves you can use
        as a guide.
        """
        send_to_woods = elves_available // 2
        send_to_forest = (elves_available - send_to_woods) // 2
        send_to_mountains = elves_available - send_to_forest
        return (send_to_woods,
                send_to_forest,
                send_to_mountains)

Run the game

After creating your bot, you can run the game:

elves game

Installing Dependencies

The server is self-contained with an SQLite database, so just install the requirements:

pip install -r requirements.txt

Running

We’re using Django Channels, so running the server is as easy as:

python server/manage.py runserver

Starting a New Session

To start a new session, send a POST request with a name variable form-encoded to https://<host>/sessions/:

curl https://example.com/sessions/ -X POST -d player_name="Scott"

and you’ll get a simple JSON object back with a session URL that you post your turns against.

Taking a Turn

To take a turn, make a POST request against the day endpoint of a session.