### 导航 - [索引](# "总目录") - [下一页](# "许可证") | - [上一页](# "升级到最新版本") | - [Flask 0.10.1 文档](#) » # Flask Changelog Here you can see the full list of changes between each Flask release. ### Version 1.0 (release date to be announced, codename to be selected) - Added SESSION_REFRESH_EACH_REQUEST config key that controls theset-cookie behavior. If set to True a permanent session will berefreshed each request and get their lifetime extended, if set toFalse it will only be modified if the session actually modifies.Non permanent sessions are not affected by this and will alwaysexpire if the browser window closes. ### Version 0.10.2 (bugfix release, release date to be announced) - Fixed broken test_appcontext_signals() test case. - Raise an [AttributeError](http://docs.python.org/dev/library/exceptions.html#AttributeError "(在 Python v3.5)") [http://docs.python.org/dev/library/exceptions.html#AttributeError] in flask.helpers.find_package() with auseful message explaining why it is raised when a PEP 302 import hook is usedwithout an is_package() method. ### Version 0.10.1 (bugfix release, released on June 14th 2013) - Fixed an issue where |tojson was not quoting single quotes whichmade the filter not work properly in HTML attributes. Now it'spossible to use that filter in single quoted attributes. This shouldmake using that filter with angular.js easier. - Added support for byte strings back to the session system. This brokecompatibility with the common case of people putting binary data fortoken verification into the session. - Fixed an issue where registering the same method twice for the same endpointwould trigger an exception incorrectly. ### Version 0.10 Released on June 13nd 2013, codename Limoncello. - Changed default cookie serialization format from pickle to JSON tolimit the impact an attacker can do if the secret key leaks. See[*Version 0.10*](#) for more information. - Added template_test methods in addition to the already existingtemplate_filter method family. - Added template_global methods in addition to the already existingtemplate_filter method family. - Set the content-length header for x-sendfile. - tojson filter now does not escape script blocks in HTML5 parsers. - tojson used in templates is now safe by default due. This wasallowed due to the different escaping behavior. - Flask will now raise an error if you attempt to register a new functionon an already used endpoint. - Added wrapper module around simplejson and added default serializationof datetime objects. This allows much easier customization of howJSON is handled by Flask or any Flask extension. - Removed deprecated internal flask.session module alias. Useflask.sessions instead to get the session module. This is not tobe confused with flask.session the session proxy. - Templates can now be rendered without request context. The behavior isslightly different as the request, session and g objectswill not be available and blueprint's context processors are notcalled. - The config object is now available to the template as a real global andnot through a context processor which makes it available even in importedtemplates by default. - Added an option to generate non-ascii encoded JSON which should resultin less bytes being transmitted over the network. It's disabled bydefault to not cause confusion with existing libraries that might expectflask.json.dumps to return bytestrings by default. - flask.g is now stored on the app context instead of the requestcontext. - flask.g now gained a get() method for not erroring out on nonexisting items. - flask.g now can be used with the in operator to see what's definedand it now is iterable and will yield all attributes stored. - flask.Flask.request_globals_class got renamed toflask.Flask.app_ctx_globals_class which is a better name to what itdoes since 0.10. - request, session and g are now also added as proxies to the templatecontext which makes them available in imported templates. One has to bevery careful with those though because usage outside of macros mightcause caching. - Flask will no longer invoke the wrong error handlers if a proxyexception is passed through. - Added a workaround for chrome's cookies in localhost not workingas intended with domain names. - Changed logic for picking defaults for cookie values from sessionsto work better with Google Chrome. - Added message_flashed signal that simplifies flashing testing. - Added support for copying of request contexts for better working withgreenlets. - Removed custom JSON HTTP exception subclasses. If you were relying on themyou can reintroduce them again yourself trivially. Using them however isstrongly discouraged as the interface was flawed. - Python requirements changed: requiring Python 2.6 or 2.7 now to preparefor Python 3.3 port. - Changed how the teardown system is informed about exceptions. This is nowmore reliable in case something handles an exception halfway throughthe error handling process. - Request context preservation in debug mode now keeps the exceptioninformation around which means that teardown handlers are able todistinguish error from success cases. - Added the JSONIFY_PRETTYPRINT_REGULAR configuration variable. - Flask now orders JSON keys by default to not trash HTTP caches due todifferent hash seeds between different workers. - Added appcontext_pushed and appcontext_popped signals. - The builtin run method now takes the SERVER_NAME into account whenpicking the default port to run on. - Added flask.request.get_json() as a replacement for the oldflask.request.json property. ### Version 0.9 Released on July 1st 2012, codename Campari. - The [flask.Request.on_json_loading_failed()](# "flask.Request.on_json_loading_failed") now returns a JSON formattedresponse by default. - The [flask.url_for()](# "flask.url_for") function now can generate anchors to thegenerated links. - The [flask.url_for()](# "flask.url_for") function now can also explicitly generateURL rules specific to a given HTTP method. - Logger now only returns the debug log setting if it was not setexplicitly. - Unregister a circular dependency between the WSGI environment andthe request object when shutting down the request. This means thatenviron werkzeug.request will be None after the response wasreturned to the WSGI server but has the advantage that the garbagecollector is not needed on CPython to tear down the request unlessthe user created circular dependencies themselves. - Session is now stored after callbacks so that if the session payloadis stored in the session you can still modify it in an afterrequest callback. - The [flask.Flask](# "flask.Flask") class will avoid importing the provided import nameif it can (the required first parameter), to benefit tools which build Flaskinstances programmatically. The Flask class will fall back to using importon systems with custom module hooks, e.g. Google App Engine, or when theimport name is inside a zip archive (usually a .egg) prior to Python 2.7. - Blueprints now have a decorator to add custom template filters applicationwide, [flask.Blueprint.app_template_filter()](# "flask.Blueprint.app_template_filter"). - The Flask and Blueprint classes now have a non-decorator method for addingcustom template filters application wide,[flask.Flask.add_template_filter()](# "flask.Flask.add_template_filter") and[flask.Blueprint.add_app_template_filter()](# "flask.Blueprint.add_app_template_filter"). - The [flask.get_flashed_messages()](# "flask.get_flashed_messages") function now allows rendering flashedmessage categories in separate blocks, through a category_filterargument. - The [flask.Flask.run()](# "flask.Flask.run") method now accepts None for host and portarguments, using default values when None. This allows for calling runusing configuration values, e.g. app.run(app.config.get('MYHOST'),app.config.get('MYPORT')), with proper behavior whether or not a configfile is provided. - The [flask.render_template()](# "flask.render_template") method now accepts a either an iterable oftemplate names or a single template name. Previously, it only accepted asingle template name. On an iterable, the first template found is rendered. - Added [flask.Flask.app_context()](# "flask.Flask.app_context") which works very similar to therequest context but only provides access to the current application. Thisalso adds support for URL generation without an active request context. - View functions can now return a tuple with the first instance being aninstance of [flask.Response](# "flask.Response"). This allows for returningjsonify(error="errormsg"),400 from a view function. - [Flask](# "flask.Flask") and [Blueprint](# "flask.Blueprint") now provide a[get_send_file_max_age()](# "flask.Flask.get_send_file_max_age") hook for subclasses to overridebehavior of serving static files from Flask when using[flask.Flask.send_static_file()](# "flask.Flask.send_static_file") (used for the default static filehandler) and send_file(). This hook is provided afilename, which for example allows changing cache controls by file extension.The default max-age for send_file and static files can be configuredthrough a new SEND_FILE_MAX_AGE_DEFAULT configuration variable, which isused in the default get_send_file_max_age implementation. - Fixed an assumption in sessions implementation which could break messageflashing on sessions implementations which use external storage. - Changed the behavior of tuple return values from functions. They are nolonger arguments to the response object, they now have a defined meaning. - Added flask.Flask.request_globals_class to allow a specific class tobe used on creation of the [g](# "flask.g") instance of each request. - Added required_methods attribute to view functions to force-add methodson registration. - Added flask.after_this_request(). - Added [flask.stream_with_context()](# "flask.stream_with_context") and the ability to push contextsmultiple times without producing unexpected behavior. ### Version 0.8.1 Bugfix release, released on July 1st 2012 - Fixed an issue with the undocumented flask.session module to notwork properly on Python 2.5. It should not be used but did causesome problems for package managers. ### Version 0.8 Released on September 29th 2011, codename Rakija - Refactored session support into a session interface so thatthe implementation of the sessions can be changed withouthaving to override the Flask class. - Empty session cookies are now deleted properly automatically. - View functions can now opt out of getting the automaticOPTIONS implementation. - HTTP exceptions and Bad Request errors can now be trapped so that theyshow up normally in the traceback. - Flask in debug mode is now detecting some common problems and tries towarn you about them. - Flask in debug mode will now complain with an assertion error if a viewwas attached after the first request was handled. This gives earlierfeedback when users forget to import view code ahead of time. - Added the ability to register callbacks that are only triggered once atthe beginning of the first request. (Flask.before_first_request()) - Malformed JSON data will now trigger a bad request HTTP exception insteadof a value error which usually would result in a 500 internal servererror if not handled. This is a backwards incompatible change. - Applications now not only have a root path where the resources and modulesare located but also an instance path which is the designated place todrop files that are modified at runtime (uploads etc.). Also this isconceptionally only instance depending and outside version control so it'sthe perfect place to put configuration files etc. For more informationsee [*实例文件夹*](#). - Added the APPLICATION_ROOT configuration variable. - Implemented session_transaction() toeasily modify sessions from the test environment. - Refactored test client internally. The APPLICATION_ROOT configurationvariable as well as SERVER_NAME are now properly used by the test clientas defaults. - Added [flask.views.View.decorators](# "flask.views.View.decorators") to support simpler decorating ofpluggable (class-based) views. - Fixed an issue where the test client if used with the “with” statement did nottrigger the execution of the teardown handlers. - Added finer control over the session cookie parameters. - HEAD requests to a method view now automatically dispatch to the getmethod if no handler was implemented. - Implemented the virtual flask.ext package to import extensions from. - The context preservation on exceptions is now an integral component ofFlask itself and no longer of the test client. This cleaned up someinternal logic and lowers the odds of runaway request contexts in unittests. ### Version 0.7.3 Bugfix release, release date to be decided - Fixed the Jinja2 environment's list_templates method not returning thecorrect names when blueprints or modules were involved. ### Version 0.7.2 Bugfix release, released on July 6th 2011 - Fixed an issue with URL processors not properly working onblueprints. ### Version 0.7.1 Bugfix release, released on June 29th 2011 - Added missing future import that broke 2.5 compatibility. - Fixed an infinite redirect issue with blueprints. ### Version 0.7 Released on June 28th 2011, codename Grappa - Added [make_default_options_response()](# "flask.Flask.make_default_options_response")which can be used by subclasses to alter the defaultbehavior for OPTIONS responses. - Unbound locals now raise a proper [RuntimeError](http://docs.python.org/dev/library/exceptions.html#RuntimeError "(在 Python v3.5)") [http://docs.python.org/dev/library/exceptions.html#RuntimeError] insteadof an [AttributeError](http://docs.python.org/dev/library/exceptions.html#AttributeError "(在 Python v3.5)") [http://docs.python.org/dev/library/exceptions.html#AttributeError]. - Mimetype guessing and etag support based on file objects is nowdeprecated for [flask.send_file()](# "flask.send_file") because it was unreliable.Pass filenames instead or attach your own etags and provide aproper mimetype by hand. - Static file handling for modules now requires the name of thestatic folder to be supplied explicitly. The previous autodetectionwas not reliable and caused issues on Google's App Engine. Until1.0 the old behavior will continue to work but issue dependencywarnings. - fixed a problem for Flask to run on jython. - added a PROPAGATE_EXCEPTIONS configuration variable that can beused to flip the setting of exception propagation which previouslywas linked to DEBUG alone and is now linked to either DEBUG orTESTING. - Flask no longer internally depends on rules being added through theadd_url_rule function and can now also accept regular werkzeugrules added to the url map. - Added an endpoint method to the flask application object whichallows one to register a callback to an arbitrary endpoint witha decorator. - Use Last-Modified for static file sending instead of Date whichwas incorrectly introduced in 0.6. - Added create_jinja_loader to override the loader creation process. - Implemented a silent flag for config.from_pyfile. - Added teardown_request decorator, for functions that should run at the endof a request regardless of whether an exception occurred. Also the behaviorfor after_request was changed. It's now no longer executed when an exceptionis raised. See [*Upgrading to new Teardown Handling*](#) - Implemented [flask.has_request_context()](# "flask.has_request_context") - Deprecated init_jinja_globals. Override the[create_jinja_environment()](# "flask.Flask.create_jinja_environment") method instead toachieve the same functionality. - Added [flask.safe_join()](# "flask.safe_join") - The automatic JSON request data unpacking now looks at the charsetmimetype parameter. - Don't modify the session on [flask.get_flashed_messages()](# "flask.get_flashed_messages") if thereare no messages in the session. - before_request handlers are now able to abort requests with errors. - it is not possible to define user exception handlers. That way you canprovide custom error messages from a central hub for certain errors thatmight occur during request processing (for instance database connectionerrors, timeouts from remote resources etc.). - Blueprints can provide blueprint specific error handlers. - Implemented generic [*即插视图*](#) (class-based views). ### Version 0.6.1 Bugfix release, released on December 31st 2010 - Fixed an issue where the default OPTIONS response wasnot exposing all valid methods in the Allow header. - Jinja2 template loading syntax now allows ”./” in front ofa template load path. Previously this caused issues withmodule setups. - Fixed an issue where the subdomain setting for modules wasignored for the static folder. - Fixed a security problem that allowed clients to download arbitrary filesif the host server was a windows based operating system and the clientuses backslashes to escape the directory the files where exposed from. ### Version 0.6 Released on July 27th 2010, codename Whisky - after request functions are now called in reverse order ofregistration. - OPTIONS is now automatically implemented by Flask unless theapplication explicitly adds ‘OPTIONS' as method to the URL rule.In this case no automatic OPTIONS handling kicks in. - static rules are now even in place if there is no static folderfor the module. This was implemented to aid GAE which willremove the static folder if it's part of a mapping in the .ymlfile. - the [config](# "flask.Flask.config") is now available in the templatesas config. - context processors will no longer override values passed directlyto the render function. - added the ability to limit the incoming request data with thenew MAX_CONTENT_LENGTH configuration value. - the endpoint for the flask.Module.add_url_rule() methodis now optional to be consistent with the function of thesame name on the application object. - added a [flask.make_response()](# "flask.make_response") function that simplifiescreating response object instances in views. - added signalling support based on blinker. This feature is currentlyoptional and supposed to be used by extensions and applications. Ifyou want to use it, make sure to have [blinker](http://pypi.python.org/pypi/blinker) [http://pypi.python.org/pypi/blinker] installed. - refactored the way URL adapters are created. This process is nowfully customizable with the [create_url_adapter()](# "flask.Flask.create_url_adapter")method. - modules can now register for a subdomain instead of just an URLprefix. This makes it possible to bind a whole module to aconfigurable subdomain. ### Version 0.5.2 Bugfix Release, released on July 15th 2010 - fixed another issue with loading templates from directories whenmodules were used. ### Version 0.5.1 Bugfix Release, released on July 6th 2010 - fixes an issue with template loading from directories when moduleswhere used. ### Version 0.5 Released on July 6th 2010, codename Calvados - fixed a bug with subdomains that was caused by the inability tospecify the server name. The server name can now be set withthe SERVER_NAME config key. This key is now also used to setthe session cookie cross-subdomain wide. - autoescaping is no longer active for all templates. Instead itis only active for .html, .htm, .xml and .xhtml.Inside templates this behavior can be changed with theautoescape tag. - refactored Flask internally. It now consists of more than asingle file. - [flask.send_file()](# "flask.send_file") now emits etags and has the ability todo conditional responses builtin. - (temporarily) dropped support for zipped applications. This was ararely used feature and led to some confusing behavior. - added support for per-package template and static-file directories. - removed support for create_jinja_loader which is no longer usedin 0.5 due to the improved module support. - added a helper function to expose files from any directory. ### Version 0.4 Released on June 18th 2010, codename Rakia - added the ability to register application wide error handlersfrom modules. - [after_request()](# "flask.Flask.after_request") handlers are now also invokedif the request dies with an exception and an error handling pagekicks in. - test client has not the ability to preserve the request contextfor a little longer. This can also be used to trigger customrequests that do not pop the request stack for testing. - because the Python standard library caches loggers, the name ofthe logger is configurable now to better support unittests. - added TESTING switch that can activate unittesting helpers. - the logger switches to DEBUG mode now if debug is enabled. ### Version 0.3.1 Bugfix release, released on May 28th 2010 - fixed a error reporting bug with [flask.Config.from_envvar()](# "flask.Config.from_envvar") - removed some unused code from flask - release does no longer include development leftover files (.gitfolder for themes, built documentation in zip and pdf file andsome .pyc files) ### Version 0.3 Released on May 28th 2010, codename Schnaps - added support for categories for flashed messages. - the application now configures a logging.Handler and willlog request handling exceptions to that logger when not in debugmode. This makes it possible to receive mails on server errorsfor example. - added support for context binding that does not require the use ofthe with statement for playing in the console. - the request context is now available within the with statement makingit possible to further push the request context or pop it. - added support for configurations. ### Version 0.2 Released on May 12th 2010, codename Jägermeister - various bugfixes - integrated JSON support - added [get_template_attribute()](# "flask.get_template_attribute") helper function. - [add_url_rule()](# "flask.Flask.add_url_rule") can now also register aview function. - refactored internal request dispatching. - server listens on 127.0.0.1 by default now to fix issues with chrome. - added external URL support. - added support for [send_file()](# "flask.send_file") - module support and internal request handling refactoringto better support pluggable applications. - sessions can be set to be permanent now on a per-session basis. - better error reporting on missing secret keys. - added support for Google Appengine. ### Version 0.1 First public preview release. © 版权所有 2013, Armin Ronacher.