If you already know webapp, webapp2 is very easy to get started. You can use webapp2 exactly like webapp, and learn the new features as you go.
If you are new to App Engine, read Getting Started with App Engine first. You will need the App Engine SDK installed for this quick start.
If you want to use webapp2 outside of App Engine, read the Quick start (to use webapp2 outside of App Engine) tutorial instead.
Create a directory
hellowebapp2 for your new app.
unpack it and add
webapp2.py to that directory. If you want to use extra
features such as sessions, extra routes, localization, internationalization
and more, also add the
webapp2_extras directory to your app.
webapp2 is part of the Python 2.7 runtime since App Engine SDK 1.6.0, so you don’t need to upload it with your app anymore. To include it in your app see Configuring Libraries.
app.yaml file in your app directory with the following contents:
application: helloworld version: 1 runtime: python27 api_version: 1 threadsafe: true handlers: - url: /.* script: main.app
Then create a file
main.py and define a handler to display a
‘Hello, webapp2!’ message:
import webapp2 class HelloWebapp2(webapp2.RequestHandler): def get(self): self.response.write('Hello, webapp2!') app = webapp2.WSGIApplication([ ('/', HelloWebapp2), ], debug=True)
If you’re using the Google App Engine Launcher, you can set up the application
by selecting the File menu, Add Existing Application..., then selecting
hellowebapp2 directory. Select the application in the app list, click
the Run button to start the application, then click the Browse button to view
it. Clicking Browse simply loads (or reloads)
http://localhost:8080/ in your default web browser.
If you’re not using Google App Engine Launcher, start the web server with the
following command, giving it the path to the
The web server is now running, listening for requests on port 8080. You can test the application by visiting the following URL in your web browser: