Package: python-appengine
Copyright 2008 Google Inc.All rights reserved.App Engine SDK - Development tools for Google App EngineCONTENTS========* Installing on Mac OSX* Installing on Windows* Installing on Linux and other platforms* Running the SDK* Using the SDK* Using the App Engine LauncherINSTALLING ON Mac OSX=====================1) Download and install Python 2.7 from http://www.python.org/download/2) Download the SDK installer fromhttps://developers.google.com/appengine/downloads3) Install the SDK by double-clicking on the GoogleAppEngine.dmg file andrunning the installer.INSTALLING ON WINDOWS=====================1) Download and install Python 2.7 from http://www.python.org/download/2) Download the SDK installer fromhttps://developers.google.com/appengine/downloads3) Install the SDK by double-clicking on the GoogleAppEngine.msi file andrunning the installer.INSTALLING ON LINUX AND OTHER PLATFORMS===============================1) Download and install Python 2.7 from http://www.python.org/download/2) Download the SDK zip file fromhttps://developers.google.com/appengine/downloads3) Unpack the zip file.RUNNING THE SDK=========================You can run the SDK with the following command:dev_appserver.py [options] <application root>Application root must be the path to the application to run in this server.Must contain a valid app.yaml or app.yml file.Options:--address=ADDRESS, -a ADDRESSAddress to which this server should bind. (Defaultlocalhost).--clear_datastore, -c      Clear the Datastore on startup. (Default false)--debug, -d                Use debug logging. (Default false)--help, -h                 View this helpful message.--port=PORT, -p PORT       Port for the server to run on. (Default 8080)--allow_skipped_files      Allow access to files matched by app.yaml'sskipped_files (default False)--auth_domain              Authorization domain that this app runs in.(Default gmail.com)--auto_id_policy=POLICY    Dictate how automatic IDs are assigned by thedatastore stub, "sequential" or "scattered".(Default sequential)--backends                 Run the dev_appserver with backends support(multiprocess mode).--blobstore_path=DIR       Path to directory to use for storing Blobstorefile stub data.--clear_prospective_search Clear the Prospective Search subscription index(Default false).--clear_search_indexes     Clear the Full Text Search indexes (Default false).--datastore_path=DS_FILE   Path to file to use for storing Datastore filestub data.(Default /tmp/dev_appserver.datastore)--debug_imports            Enables debug logging for module imports, showingsearch paths used for finding modules and anyerrors encountered during the import process.--default_partition        Default partition to use in the APPLICATION_ID.(Default dev)--disable_static_caching   Never allow the browser to cache static files.(Default enable if expiration set in app.yaml)--disable_task_running     When supplied, tasks will not be automaticallyrun after submission and must be run manuallyin the local admin console.--enable_sendmail          Enable sendmail when SMTP not configured.(Default false)--high_replication         Use the high replication datastore consistencymodel. (Default false).--history_path=PATH        Path to use for storing Datastore history.(Default /tmp/dev_appserver.datastore.history)--persist_logs             Enables storage of all request and applicationlogs to enable later access. (Default false).--logs_path=LOGS_FILE      Path to use for storing request logs. If this isset, logs will be persisted to the given path. Ifthis is not set and --persist_logs is true, logsare stored in /tmp/dev_appserver.logs.--multiprocess_min_port    When running in multiprocess mode, specifies thelowest port value to use when choosing ports. Ifset to 0, select random ports.(Default 9000)--mysql_host=HOSTNAME      MySQL database host that the rdbms API will use.(Default localhost)--mysql_port=PORT          MySQL port to connect to.(Default 3306)--mysql_user=USER          MySQL user to connect as.(Default '')--mysql_password=PASSWORD  MySQL password to use.(Default '')--mysql_socket=PATH        MySQL Unix socket file path.(Default '%(mysql_socket)s')--require_indexes          Disallows queries that require composite indexesnot defined in index.yaml.--search_indexes_path=PATH Path to file to use for storing Full Text Searchindexes (Default %(search_indexes_path)s).--show_mail_body           Log the body of emails in mail stub.(Default false)--skip_sdk_update_check    Skip checking for SDK updates. If false, fall backto opt_in setting specified in .appcfg_nag(Default false)--smtp_host=HOSTNAME       SMTP host to send test mail to.  Leaving thisunset will disable SMTP mail sending.(Default '')--smtp_port=PORT           SMTP port to send test mail to.(Default 25)--smtp_user=USER           SMTP user to connect as.  Stub will only attemptto login if this field is non-empty.(Default '').--smtp_password=PASSWORD   Password for SMTP server.(Default '')--task_retry_seconds       How long to wait in seconds before retrying atask after it fails during execution.(Default '30')--use_sqlite               Use the new, SQLite based datastore stub.(Default false)--port_sqlite_data         Converts the data from the file based datastorestub to the new SQLite stub, one time use only.Requires enough RAM to hold all of the entities.(Default false)--[enable|disable]_console Enables/disables the interactive console.(Default enabled if --address is unset,disabled if --address is set)USING THE SDK=======================For instructions on getting started with Google App Engine, please see theGoogle App Engine Getting Started Guidehttps://developers.google.com/appengine/docs/python/gettingstartedUSING THE APP ENGINE LAUNCHER=============================The Windows and Mac OSX Python SDKs include an additional development toolcalled the App Engine Launcher.  This tool provides a simple graphicalinterface to create projects, run them locally, and deploy them to Google's AppEngine servers. It can be used in place of the dev_appserver and appcfgcommand-line tools.The Windows SDK can optionally install a desktop short-cut duringinstallation. If you are missing the short-cut, you can find the launcher inthe launcher subdirectory of your App Engine installation. The defaultlocation isC:\Program Files\Google\google_appengine\launcher\GoogleAppEngineLauncher.exeIn Mac OSX, the Launcher is installed by dragging it out of the .dmg to alocation specified by the user. The Launcher contains the SDK inside of it.A typical drag-install destination for the Launcher and SDK is/Applications/GoogleAppEngineLauncher.app