Skip to content
A cookiecutter template for Google App Engine Python project.
Python HTML CSS JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
{{cookiecutter.repo_name}}
.gitignore
README.md
cookiecutter.json
requirements.txt

README.md

Google App Engine Python Starter

A cookiecutter template for Google App Engine Python project.

Ingredients

  • webapp2 Lightweight Python web framework compatible with GAE.
  • Jinja2 Modern and designer-friendly templating language for Python.
  • NDB App Engine Datastore API.
  • WTForms A flexible forms validation and rendering library for Python.
  • unittest The Python unit testing framework.
  • webtest WebTest helps you test your WSGI-based web applications.
  • NoseGAE Nose plugin for Google App Engine testing.
  • Fabric Suite of operations for executing local or remote shell commands.
  • SimpleAuth Simple Authentication supporting OAuth and OpenID (Google, Facebook, ...)
  • Bower A package manager for the web.
  • Gulp A streaming build tool built on Node.js.
  • HTML5Boilerplate A professional front-end template.
  • Modernizr A JavaScript library that detects HTML5 and CSS3 features in the user's browser.
  • Sass A scripting language that interpreted into CSS.
  • LiveReload A happy land where browsers don't need a Refresh button.
  • jQuery A fast, small, and feature-rich JavaScript library.
  • Twitter Bootstrap Sleek, intuitive, and powerful front-end framework. (Optional)

Demo

Prerequisits

  1. Download and install Google App Engine SDK.
  2. Create a unique App ID in Google Developers Console and enable needed services and APIs.
  3. Install Fabric
$ pip install Fabric

Get Started

Install latest cookiecutter and ruamel.yaml. (We need '_copy_without_render' function.)

$ pip install --upgrade git+https://github.com/audreyr/cookiecutter.git
$ pip install ruamel.yaml

Run cookiecutter to create your project.

$ cookiecutter gh:flyakite/gae-starter

Create virtual environment in project folder and install Python and Javascript packages.

$ cd <your_project>
$ virtualenv --python=python2.7 venv
$ . venv/bin/activate
$ pip install -r requirements.txt
$ npm install
$ bower install

Run Server

Run Gulp tasks and start web server using Fabric command.

$ gulp
$ fab start

Run Test

$ fab test

Deploy to GAE

Run unittest and deploy to server.

$ fab deploy

Social Login

Please follow the instruction to apply and fill the secrets in config.py

  1. Google
  1. Facebook
  1. Linkedin
  1. Microsoft Live
  1. Twitter
  1. Foursquare

More info please refer to SimpleAuth

You can’t perform that action at this time.