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
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
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.
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
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.
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.