Development Environment

Windows

Clone the repository

• https://github.com/juliandescottes/piskel-website.git

Prepare Python 2.7

• Install Python 2.7 from Python downloads (Look for Python 2.7.xx then download the latest and install it).

• Download and install lxml library for Python 2.7.

Prepare Google App Engine

• Download and install Google App Engine SD for Python.

• Launch the Google App Engine Launcher.

• An error might pop up in this case, configure Google App Engine by opening the Edit -> Preferences. Change the Python Path to your python executable file.

• Add Existing Application (CTRL + SHIFT + N or File -> Add Existing Application)

  • Point the application path to the repo's root.
  • Change the ports to whatever you want or leave them as is.

Create Google API Key for OAuth

• Open the Google Developer Console.

• Click on the Credentials.

• Click on the Create Credentials button then choose OAuth client ID.

• Choose Web application for Application type.

  • Type whatever you want for Name (For example: Piskel Local Development)
  • Authorized JavaScript origins: http://localhost:port
  • Authorized redirect URIs: http://localhost:port/auth/google/callback
  • Don't forget to change the port to whatever you used in the Google App Engine Launcher.
  • Save it.

Prepare application for launch

• Create a new secrets.py inside the repostiory in the config directory

  SESSION_KEY = '***session_key***'
  AUTH_CONFIG = {
      'google': ('***client ID***', '***client secret***', 'profile')
  }

• Replace session_key with a random encryption key (You can skip this step if you aren't exposing your local server to the public)
• Replace client ID and client secret with the values you got in the Google Developer Console

Launch Piskel website

• Open Google App Engine Launcher, choose the piskel-app then click Run.

Mac OS X 10.6

1. Check that python version is matching the one used by app-engine.
2. Run sudo easy_install lxml==2.3