Copyright 2008 Google Inc.

All rights reserved.

App Engine Python SDK - Release Notes

Version 1.2.7 - October 14, 2009

================================

  - Changed the 'key' parameter to Model.__init__ to be keyword only.

  - Fixed taskqueue import in Remote API.

    http://code.google.com/p/googleappengine/issues/detail?id=2259

Version 1.2.6 - September 17, 2009

==================================

  - Added incoming email support.

    http://code.google.com/p/googleappengine/issues/detail?id=165

  - Remote API now supports XMPP and task queues.

  - The default for all handlers is now secure: optional. Users can

    now access all pages via SSL unless explicitly disallowed.

  - Remote API now supports HTTPS.

    http://code.google.com/p/googleappengine/issues/detail?id=1461

  - Appcfg now uses https by default.

    http://code.google.com/p/googleappengine/issues/detail?id=794

  - Appcfg.py now supports the --application and --version flags to

    override the values specified in app.yaml.

    http://code.google.com/p/googleappengine/issues/detail?id=670

  - GQL now supports '= NULL' queries.

  - The db.Model constructor now supports explicitly setting a key

    (and thus an id) for a Model instance.

  - New Datastore stats api. Stats are also visible in the admin console.

  - Bulkloader dump and restore now supports restoring to a different

    app id and restoring numeric keys.

Version 1.2.5 - August 13, 2009

===============================

  - The Windows Python SDK now includes a GUI launcher, similar to the Mac SDK.

  - Added XMPP support.

    http://code.google.com/appengine/docs/python/xmpp

    http://code.google.com/p/googleappengine/issues/detail?id=231

  - Datastore now supports multiple writes to the same entity within a 

    transaction.

  - Datastore entity key names can now start with a digit.

      http://code.google.com/p/googleappengine/issues/detail?id=1352

  - Datastore now supports ancestor + kind queries without a composite index

      http://code.google.com/p/googleappengine/issues/detail?id=1003

  - Bulkloader now supports configurationless dump and restore with new

    --dump and --restore options.

  - Bulkloader now supports a --dry_run flag to testing data prior to uploading.

  - Appcfg.py now allows specifying any end date for request_logs.

  - Urlfetch now allows setting the Referer header.

      http://code.google.com/p/googleappengine/issues/detail?id=445

  - Urlfetch stub now correctly handles HEAD requests.

      http://code.google.com/p/googleappengine/issues/detail?id=866

  - New remote_api_shell tool for interactive remote_api operations.

  - New google.ext.ereporter module to collect and email exception reports.

  - New google.ext.deferred module to execute ad-hoc tasks on the Task Queue.

Version 1.2.4 - July 16, 2009

=============================

  - Added support for kindless queries, ie. transaction descendant queries.

      http://code.google.com/p/googleappengine/issues/detail?id=913

  - Composite indexes no longer required for certain types of key queries.

  - Improved exception reporting in the bulkloader.

  - Datastore transaction RPC sent at beginning of transaction rather than

    upon first Datastore request.

  - PolyModel supports keys_only query.

      http://code.google.com/p/googleappengine/issues/detail?id=1630

  - Remote API supports more API's (Images, Memcache and URLFetch).

      http://code.google.com/p/googleappengine/issues/detail?id=1596

  - Remote API shell.

  - Support for multiple inheritance for Model and PolyModel.

  - Enhancement to SearchableModel allowing multiple properties to be

    indexed.

  - Various code quality improvements.

Version 1.2.3 - June 1, 2009

============================

  - Task Queue support available as google.appengine.api.labs.taskqueue.

      http://code.google.com/appengine/docs/python/taskqueue

  - Django 1.0 support. You must install Django locally on your machine

    for the SDK but no longer need to upload it to App Engine.

      from google.appengine.dist import use_library

      use_library('django', '1.0')

      http://code.google.com/p/googleappengine/issues/detail?id=872

  - Urlfetch supports asynchronous requests.

      http://code.google.com/p/googleappengine/issues/detail?id=958

  - Urlfetch in SDK now matches App Engine more closely:

    By default, it now sets the referer header, does not set the Accept

    header, and sets Accept-Encoding to gzip.

      http://code.google.com/p/googleappengine/issues/detail?id=970

  - Fixed issue with httplib and absolute URLs.

      http://code.google.com/p/googleappengine/issues/detail?id=1311

  - Memcache key length is no longer restricted to 250 bytes: longer keys

    will be replaced with a hash of the key.

  - Datastore ancestor queries now work within transactions.

  - Datastore transactions in SDK now snapshot on the first operation so they

    do not see writes made during the transaction. Matches App Engine.  

Version 1.2.2 - April 22, 2009

==============================

  - New quota API which returns the CPU usage of the current request.

      from google.appengine.api import quota

      cpu_usage_so_far = quota.get_request_cpu_usage()

  - Urlfetch fetch now has support for user configurable deadlines.

      http://code.google.com/p/googleappengine/issues/detail?id=79

  - Urlfetch in the SDK allows the Accept-Encoding header to match App Engine.

      http://code.google.com/p/googleappengine/issues/detail?id=1071

  - urllib now supports HTTPS in addition to HTTP

      http://code.google.com/p/googleappengine/issues/detail?id=1156

  - Datastore indexes on single properties can now be disabled by setting

    indexed=False on the property constructor.

  - Datastore now supports Key-only queries, using either SELECT __key__ or

    or db.Query(Model, keys_only=True)

  - Fixed issues with Datastore IN filters and sorting: sort order is now

    correct, and can be used with __key__.

      http://code.google.com/p/googleappengine/issues/detail?id=1100

      http://code.google.com/p/googleappengine/issues/detail?id=1016

  - Cron supports additional time specification formats.

      http://code.google.com/p/googleappengine/issues/detail?id=1261

  - Fixed an issue in the dev_appserver admin console datastore viewer

    (/_ah/admin/datastore) with sorting columns containing None types.

      http://code.google.com/p/googleappengine/issues/detail?id=1007

  - Bulk Loader improvements:  New appcfg download_data command.

    Better backoff support and debugging output for long requests.

  - New --vhost flag on appcfg.py request_logs command to select logs for

    a particular host.

  - Python _ast module is now available for import

      http://code.google.com/p/googleappengine/issues/detail?id=779

  - Fixed issue with the color argument of the Images API composite method.

Version 1.2.1 - April 13, 2009

=============================

  - Stable, unique IDs for User objects. The Users service now

    provides a unique user_id for each user that stays the same even

    if a user changes her email address.

      http://code.google.com/p/googleappengine/issues/detail?id=1019

  - The Images API now supports compositing images and calculating

    a color histogram for an image.

  - New allowed mail attachment types: ics, vcf

      http://code.google.com/p/googleappengine/issues/detail?id=494

  - Urlfetch requests can now set the User-Agent header.

      http://code.google.com/p/googleappengine/issues/detail?id=342

  - An App Engine-specific version of the Python PyCrypto cryptography

    library is now available. Learn more at

      http://code.google.com/appengine/docs/python/tools/libraries.html

  - The bulk loader configuration format has changed.to allow non-CSV

    input. This change is not backwards compatible, so you will need to

    update your code.

    An early release of the bulk downloader is also now available in

    bulkloader.py. Learn more about these changes at:

      http://code.google.com/appengine/docs/python/tools/uploadingdata.html

  - Fixed parsing of unicode GQL queries.

      http://code.google.com/p/googleappengine/issues/detail?id=1105

  - Fixed dev_appserver security restrictions for os.path

      http://code.google.com/p/googleappengine/issues/detail?id=1068

  - Fixed Reply-To header set in emails sent from dev_appserver.

      http://code.google.com/p/googleappengine/issues/detail?id=1017

Version 1.2.0 - March 24, 2009

==============================

  - Cron support. Appcfg.py will upload the schedule to App Engine.

      The dev_appserver console at /_ah/admin describes your schedule but does

      not automatically run scheduled jobs. Learn more at

      http://code.google.com/appengine/docs/python/config/cron.html

  - New allow_skipped_files flag in dev_appserver to allow it to read files

    which are not available in App Engine.

      http://code.google.com/p/googleappengine/issues/detail?id=550

  - New upload_data command in appcfg to run the bulk uploader.

      http://code.google.com/appengine/docs/python/tools/uploadingdata.html

Version 1.1.9 - February 2, 2009

================================

  - HTTP Request and Response limit raised to 10MB from 1MB.

    Note that API call limits remain at 1MB.

      http://code.google.com/p/googleappengine/issues/detail?id=78

  - urllib and urllib2 now available, implemented using urlfetch.

    Also adds additional stubs which may enable other modules.

      http://code.google.com/p/googleappengine/issues/detail?id=61

      http://code.google.com/p/googleappengine/issues/detail?id=68

      http://code.google.com/p/googleappengine/issues/detail?id=572

      http://code.google.com/p/googleappengine/issues/detail?id=821

  - Early release of a new data bulk upload tool, bulkloader.py

      http://code.google.com/appengine/docs/python/tools/uploadingdata.html

  - New remote_api for datastore at google.appengine.ext.remote_api

  - Single property descending indexes are automatically generated.

  - Added db.Query support for IN and != operators.

      http://code.google.com/p/googleappengine/issues/detail?id=751

  - Fixed issue where gql date/time parsing could not handle Unicode strings.

  - Fixed issue with db model instance key() returning the wrong key for

    unsaved instances with parent as key

      http://code.google.com/p/googleappengine/issues/detail?id=883

  - New run_in_transaction_custom_retries method for datastore.

  - Fixed issue with relative dev_appserver datastore and history paths.

      http://code.google.com/p/googleappengine/issues/detail?id=845

  - Static files and skipped files are not readable in dev_appserver, to match

    the behavior on App Engine.

      http://code.google.com/p/googleappengine/issues/detail?id=550

  - Images API allows multiple transforms of the same type in one request. A

    limit of 10 total transforms per request has been added.

  - PIL import will work with both PIL.Image and Image.

      http://code.google.com/p/googleappengine/issues/detail?id=929

  - Fixed an issue with sending email in dev_appserver when the application

    code changed.

      http://code.google.com/p/googleappengine/issues/detail?id=182

  - Memcache counters (incr/decr) do nothing on non positive integers to match

    the behavior on App Engine.

      http://code.google.com/p/googleappengine/issues/detail?id=918

Version 1.1.8 - January 7, 2008

=================================

  - Skip_files RegexStr validator allows lists to for regex-ors.

      http://code.google.com/p/googleappengine/issues/detail?id=81

  - sys.path and sys.argv are no longer reset for each request.

      http://code.google.com/p/googleappengine/issues/detail?id=772

  - New ByteString data type for the datastore.  Indexed non-text short-blob.

  - UserProperty now takes auto_current_user and auto_current_user_add

    attributes.

  - Support for polymorphic models and queries.

  - db.Model.order() now supports __key__.

      http://code.google.com/p/googleappengine/issues/detail?id=884

  - Urlfetch no longer sets content-length: 0 when there is no body.

      http://code.google.com/p/googleappengine/issues/detail?id=817

  - Get height and width of an image via the Images API.

      http://code.google.com/p/googleappengine/issues/detail?id=435

  - Limit auto-Bcc of email sender to the case where the email sender is the

    currently-logged-in user.

  - Adds limit of 100 order/filters on datastore query size to the SDK.

  - Fix unicode support for the bulkloader

      http://code.google.com/p/googleappengine/issues/detail?id=157

  - Bulkload.py from the appengine/tools directory to the appengine/ directory

  - Modify webapp to use logging.exception instead of logging.error.

  - Additional fixes to SDK sanitizing response headers to match production.

      http://code.google.com/p/googleappengine/issues/detail?id=198

Version 1.1.7 - November 20, 2008

=================================

  - Fixed an issue with urlfetch response headers.

      http://code.google.com/p/googleappengine/issues/detail?id=877

Version 1.1.6 - November 17, 2008

=================================

  - Datastore now supports filtering and sorting on the __key__ special

    property, which evaluates to each entity's key.

  - Fixed a bug where it was possible to append None to ListProperty.

  - Datastore appengine.ext.db models allow deletion by key without

    instantiating a model instance.

  - Datastore models allow access to key name before put() if key_name given.

  - Datastore fetch max results and max query offset match production limits.

  - Fixed an issue in production where query fails with NeedIndexError when

    a model has two ancestor indexes.

    http://code.google.com/p/googleappengine/issues/detail?id=423

  - Allow trailing whitespace in PropertyValueFromString for datetime.

  - Fixed to_xml on models with binary data in a BlobProperty: they now

    are base64 encoded.

    Note: This changes XML serialization.

      http://code.google.com/p/googleappengine/issues/detail?id=430

  - Fixed an issue with setting expando attributes.

      http://code.google.com/p/googleappengine/issues/detail?id=431

  - Fixed an issue where TypeError was raised instead of NeedIndexError for

    "merge join" queries, i.e. queries with only equals filters and no ancestor

    or sort orders, that still need an index.

      http://code.google.com/p/googleappengine/issues/detail?id=749

  - URLFetch in the SDK now has the same 5 second timeout to match production.

  - URLFetch response headers are combined

      http://code.google.com/p/googleappengine/issues/detail?id=412

  - URLFetch now uses original method when following a redirect.

      http://code.google.com/p/googleappengine/issues/detail?id=363

  - URLFetch logs a warning when using a non standard port.

      http://code.google.com/p/googleappengine/issues/detail?id=436

  - URLFetch allows integers as values in request headers.

  - Enforce response size and API request size limits to match production.

      http://code.google.com/p/googleappengine/issues/detail?id=447

  - SDK sanitizes response headers to match production

      http://code.google.com/p/googleappengine/issues/detail?id=198

  - Login URLs now require login in the SDK to match production.

      http://code.google.com/p/googleappengine/issues/detail?id=53

  - Fixed an issue with long URLs in HTTP 302 redirect responses.

      http://code.google.com/p/googleappengine/issues/detail?id=407

  - Fixed an issue with regular expressions in static_files in app.yaml

      http://code.google.com/p/googleappengine/issues/detail?id=711

  - SDK only allows "C" locale to match production.

      http://code.google.com/p/googleappengine/issues/detail?id=356

  - Support the bufsize positional arg in open()/file().

  - lstat is aliased to stat.

  - appcfg handles index building errors more gracefully.

  - Fixed an issue with symlinks in the path to the Python core libraries.

Version 1.1.5 - September 29, 2008

==================================

  - Additional fixes for file paths on Windows and OSX.

  - Sped up the datastore stub.

  - Allow different types in list properties in datastore.Entity and Expando.

  - Add add_multi and replace_multi to memcache API.

      http://code.google.com/appengine/docs/memcache/clientclass.html#Client_add_multi

      http://code.google.com/appengine/docs/memcache/clientclass.html#Client_replace_multi

  - Ignore errors from the API proxy when calling memcache read methods.

  - Set the webapp Request charset property more accurately from CONTENT_TYPE.

  - Fixed an issue in the development console with schema caching.

  - Fixed an issue with StringListProperty not returning a class

      http://code.google.com/p/googleappengine/issues/detail?id=415

  - Fixed an issue in the development console where quotes couldn't be used

      within fields.

  - Fixed an issue with TimeProperty("0:0") (midnight).

      http://code.google.com/p/googleappengine/issues/detail?id=279

Version 1.1.4 - September 26, 2008

==================================

  - Fixed issue with incorrectly escaping static_files paths on Windows.

  - Workaround -inf not being supported on Windows in Datastore.

Version 1.1.3 - September 8, 2008

=================================

  - Added support for zipimport.

      http://code.google.com/p/googleappengine/issues/detail?id=70

      http://code.google.com/p/googleappengine/issues/detail?id=161

  - Added zipserve module for serving static content from a zip file.

      See google/appengine/ext/zipserve/__init__.py for more information.

  - Added a memcache viewer to the development console.

      http://code.google.com/appengine/docs/thedevwebserver.html#The_Development_Console

  - Added new follow_redirects flag to the URLFetch service.

      http://code.google.com/p/googleappengine/issues/detail?id=404

  - Fixed caching headers for static content.

  - Fixed an issue with incorrectly escaping paths on Windows.

  - Fixed an issue with the current directory while running applications.

Version 1.1.2 - August 20, 2008

===============================

  - Batch puts across Datastore entity groups.

  - Transaction retries reduced from 10 to 3.

  - Fixed certain transaction failures being silent.

  - Added support for indexes with a single repeated property.

Version 1.1.1 - July 21, 2008

=============================

  - Fixed DELETE for URLFetch on dev_appserver.

      http://code.google.com/p/googleappengine/issues/detail?id=566

  - Fixed PATH_INFO to be un-escaped version of the path.

      http://code.google.com/p/googleappengine/issues/detail?id=267

      http://code.google.com/p/googleappengine/issues/detail?id=457

  - Fixed order function testing for property on Expando class.

  - Support all mail attachment mime-types under Windows.

  - Added support for date and time objects to GQL.

      http://code.google.com/p/googleappengine/issues/detail?id=318

  - Fixed memcache KeyError problem.

      http://code.google.com/p/googleappengine/issues/detail?id=417

  - Default URLFetch POST content-type is x-www-form-urlencoded.

  - Fixed problems where global variables would be set to None

    when a request raised an exception or returned an error

    response.

  - Added support for GIFs and JPEG using PIL.

  - Added support for type conversion of literals to GQL.

  - Added support for pickling Expando instances.

      http://code.google.com/p/googleappengine/issues/detail?id=545

  - Added APPLICATION_ID environment variable to runtime.

  - Added support for key_name to djangoforms.

  - Added ability to put multiple transaction groups in one request

    outside of transactions.

  - Added support for downloading request logs using appcfg.

      http://code.google.com/p/googleappengine/issues/detail?id=76

  - Fixed DateProperty not supporting values before 1970 and beyond

    Jan. 19, 2038.

      http://code.google.com/p/googleappengine/issues/detail?id=352

  - Set cap of 5000 indexed properties per entity.

  - GoogleAppEngineLauncher now has context menus in the main project

    window.

  - UI improvements to GoogleAppEngineLauncher preferences window.

  - Fixed GoogleAppEngineLauncher broken symlink for bulk_uploadclient.

Version 1.1.0 - May 28, 2008

============================

  - Added an API for image manipulation.

      http://code.google.com/p/googleappengine/issues/detail?id=38

  - Added memcache API.

  - Fixed URLFetch for URLs with query strings.

      http://code.google.com/p/googleappengine/issues/detail?id=341

      http://code.google.com/p/googleappengine/issues/detail?id=346

      http://code.google.com/p/googleappengine/issues/detail?id=369

  - Added support for multiple values for the same filter string.

  - Fixed URLFetch's referrer to now set itself to the application's

    host-name.

  - Added --show_mail_body flag to dev_appserver.py.

  - Added support for IN and != to GQL.

  - Fixed URLFetch to accept strings as well as constant integers.

      http://code.google.com/p/googleappengine/issues/detail?id=234

  - Added CURRENT_VERSION_ID environment variable.

  - Fixed uploading issues affecting @googlemail.com developers.

      http://code.google.com/p/googleappengine/issues/detail?id=119

  - Fixed Datastore API to allow the assignment of [] to non-dynamic

    DB attributes.

      http://code.google.com/p/googleappengine/issues/detail?id=276

      http://code.google.com/p/googleappengine/issues/detail?id=254

  - Fixed NeedIndexError to include the index that the query needed.

Version 1.0.2 - May 15, 2008

============================

  - Fixed UTC timezone issue on Windows.

      http://code.google.com/p/googleappengine/issues/detail?id=131

  - Fixed webapp template cache bug.

      http://code.google.com/p/googleappengine/issues/detail?id=273

  - URLFetch service redirect behavior now matches deployed behavior.

      http://code.google.com/p/googleappengine/issues/detail?id=84

  - Better handling of bad HOMEDRIVE parameters on Windows.

      http://code.google.com/p/googleappengine/issues/detail?id=27

  - Fixed HTTP response header termination.

      http://code.google.com/p/googleappengine/issues/detail?id=209

  - Fixed behavior with source files that have Windows line-endings or

    missing line-endings.

      http://code.google.com/p/googleappengine/issues/detail?id=237

      http://code.google.com/p/googleappengine/issues/detail?id=258

  - Fixed C-Extension module loading issues.

      http://code.google.com/p/googleappengine/issues/detail?id=95

      http://code.google.com/p/googleappengine/issues/detail?id=83

  - Fixed Windows DLL extension loading issues.

      http://code.google.com/p/googleappengine/issues/detail?id=222

  - Added missing os.uname function.

      http://code.google.com/p/googleappengine/issues/detail?id=186

  - Windows installer can now over-install.

      http://code.google.com/p/googleappengine/issues/detail?id=241

  - Windows installer now allows installation even if it can't find Python.

      http://code.google.com/p/googleappengine/issues/detail?id=5

  - Fixed skip_files exception.

      http://code.google.com/p/googleappengine/issues/detail?id=80

  - Better error handling for cookie-file related problems.

  - User platform, SDK version, and Python version are now supplied to

    server-side on deployment; also supplied on dev_appserver start-up

    if the "nag" is enabled.

Version 1.0.1 - April 14, 2008

==============================

  - Fixed app.yaml static_dir attribute on Windows.

  - Fixed uploading large files on OSX.

  - Fixed recursion issue in webapp template rendering cache.

  - Fixed MacPorts installation.