cloudfoundry-samples/pong_matcher_django

Name: pong_matcher_django

Owner: Cloud Foundry Sample Applications

Description: null

Created: 2014-12-30 19:14:19.0

Updated: 2017-09-27 13:47:38.0

Pushed: 2018-01-05 23:09:38.0

Homepage: null

Size: 18

Language: Python

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

CF example app: ping-pong matching server

This is an app to match ping-pong players with each other. It's currently an API only, so you have to use curl to interact with it.

It has an acceptance test suite you might like to look at.

Note: We highly recommend that you use the latest versions of any software required by this sample application.

Running on Pivotal Web Services

Log in.

ogin -a https://api.run.pivotal.io

Target your org / space. An empty space is recommended, to avoid naming collisions.

arget -o myorg -s myspace

Sign up for a cleardb instance.

reate-service cleardb spark mysql

Push the app. Its manifest assumes you called your ClearDB instance 'mysql'.

ush -n mysubdomain

Export the test host

rt HOST=http://mysubdomain.cfapps.io

Now follow the interaction instructions.

NB: By default, the app runs with an insecure, shared SECRET_KEY. If you care about security in your app, you should set this in an environment variable:

et-env djangopong SECRET_KEY thesecretkeythatonlyyouknow
estage djangopong
Running locally

The following assumes you have a working, 3.4.x version of Python installed. You'll also need pip, the Python dependency manager. If you installed Python using Homebrew on OSX, you're already set. On Ubuntu, the package you want is 'python3-pip'.

Install and start MySQL:

 install mysql
l.server start
l -u root

Create a database user and table in the MySQL REPL you just opened:

TE USER 'djangopong'@'localhost' IDENTIFIED BY 'djangopong';
TE DATABASE pong_matcher_django_development;
T ALL ON pong_matcher_django_development.* TO 'djangopong'@'localhost';

Install virtualenv:

 install virtualenv

Create and activate a new Python environment:

ualenv env
ce env/bin/activate

Install the project's dependencies:

install -r requirements.txt --allow-external mysql-connector-python

Migrate the database:

nage.py migrate

Start the application server:

nage.py runserver

Export the test host in another shell, ready to run the interactions.

rt HOST=http://localhost:8000

Now follow the interaction instructions.

NB: you can also use Foreman to run the migrations and start the app server with foreman start. However, Foreman defaults to a different port (5000), so be sure to export the test host with port 5000 instead of 8000.

Interaction instructions

Start by clearing the database from any previous tests. You should get a 200.

 -v -X DELETE $HOST/all

Then request a match, providing both a request ID and player ID. Again, you should get a 200.

 -v -H "Content-Type: application/json" -X PUT $HOST/match_requests/firstrequest -d '{"player": "andrew"}'

Now pretend to be someone else requesting a match:

 -v -H "Content-Type: application/json" -X PUT $HOST/match_requests/secondrequest -d '{"player": "navratilova"}'

Let's check on the status of our first match request:

 -v -X GET $HOST/match_requests/firstrequest

The bottom of the output should show you the match_id. You'll need this in the next step.

Now pretend that you've got back to your desk and need to enter the result:

 -v -H "Content-Type: application/json" -X POST $HOST/results -d '

"match_id":"thematchidyoureceived",
"winner":"andrew",
"loser":"navratilova"

You should get a 201 Created response.

Future requests with different player IDs should not cause a match with someone who has already played. The program is not yet useful enough to allow pairs who've already played to play again.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.