simpl-client 0.7.5

Installation

pip install simpl-client

Endpoints

Endpoints are available as properties on the main instance.

async_games_client.runusers.all()  # GET /runusers/

async_games_client.runusers.filter(run=12, world=1)  # GET /runusers/?run=12&world=1

async_games_client.runusers.filter(run=12, world=1)  # GET /runusers/?run=12&world=1
async_games_client.runusers.filter(id=12)  # GET /runusers/12/
async_games_client.users.filter(username='alice')  # GET /users/alice/

runuser = async_games_client.runusers.create({'run': 12, 'world': 1})  # POST /runusers/

runuser = async_games_client.runusers.create_or_update({'id': 1234, 'world': 1})  # PUT /runusers/1234/

async_games_client.runusers.delete(24)  # DELETE /runusers/24/

Resources

All endpoints methods (with the exception of .delete()) return either a Resource or a list of Resource s.

A Resource is just a wrapping class for a dict, where keys can be accessed as properties.

Additionally, Resource s have a special property called .payload, which contains the original payload received from the server.

Resource s have the following methods:

Resource.delete() will result in a DELETE, with Resource.id as par of the URL:

runuser = async_games_client.runusers.create({'run': 12, 'world': 1})  # POST /runusers/
runuser.delete()  # DELETE /runuser/345/ -- the ID 345 was returned by the server in the previous response

Resource.save() will result in a PUT, with Resource.id as par of the URL:

runuser = async_games_client.runusers.create({'run': 12, 'world': 1})  # POST /runusers/
runuser.run = 13
runuser.save()  # PUT /runuser/345/

Bulk requests

async_games_client.bulk.results.create([...], return_ids=False)
async_games_client.bulk.results.delete(**lookup)

Detail Routes

async_games_client.scenario(id=123).rewind()

Setup development environment

git clone git@github.com:simplworld/simpl-client.git
cd simpl-client
mkvirtualenv simpl-client
pip install -e .

Testing

python setup.py test

Running the tests requires having libmagic installed.

On OS X, simply run brew install libmagic.

License

Copyright © 2018 The Wharton School,  The University of Pennsylvania

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.