README.md

Python Demo

• App Engine Site: https://tatwell-python-demo.appspot.com/
• Trello Board: https://trello.com/b/j0yRbilt/python-demo

Flask App Engine Application

The Flask App Engine application is based on the GoogleCloudPlatform Flask App Engine skeleton.

To install:

1. Install the Google App Engine Python SDK.

2. Clone this repository:

   git clone https://github.com/tatwell/python-demo.git python-demo

3. Install the required libraries using Pip:

   cd python-demo/app-engine pip install -r requirements.txt -t lib

4. Create secrets file by copying -dist version into place:

   cp -v python-demo/app-engine/config/secrets.py{-dist,}

Update secret values in news secrets.py.

Development Server

To launch the local development server:

dev_appserver.py --port=3000 --admin_port=3001 --api_port=3002 ./app-engine

Application will run on http://localhost:3000.

Tests

First, install testing libraries. From project root:

pip install -r app-engine/requirements-test.txt

Then copy and update the gae-lib-root setting in the nose.cfg file:

cp -v app-engine/nose.cfg{-dist,}
# Remember to update gae-lib-root setting.

To run tests:

cd app-engine
nosetests -c nose.cfg

With coverage:

nosetests -c nose.cfg --with-coverage --cover-erase \
  --cover-package=config,models

To run a single test:

nosetests -c nose.cfg tests/service/test-summer.py

Deployment

To deploy the App Engine application:

appcfg.py -A PROJECT_NAME -e YOUR_USER_NAME update ./app-engine