1.. currentmodule:: flask 2 3Version 2.0.2 4------------- 5 6Released 2021-10-04 7 8- Fix type annotation for ``teardown_*`` methods. :issue:`4093` 9- Fix type annotation for ``before_request`` and ``before_app_request`` 10 decorators. :issue:`4104` 11- Fixed the issue where typing requires template global 12 decorators to accept functions with no arguments. :issue:`4098` 13- Support View and MethodView instances with async handlers. :issue:`4112` 14- Enhance typing of ``app.errorhandler`` decorator. :issue:`4095` 15- Fix registering a blueprint twice with differing names. :issue:`4124` 16- Fix the type of ``static_folder`` to accept ``pathlib.Path``. 17 :issue:`4150` 18- ``jsonify`` handles ``decimal.Decimal`` by encoding to ``str``. 19 :issue:`4157` 20- Correctly handle raising deferred errors in CLI lazy loading. 21 :issue:`4096` 22- The CLI loader handles ``**kwargs`` in a ``create_app`` function. 23 :issue:`4170` 24- Fix the order of ``before_request`` and other callbacks that trigger 25 before the view returns. They are called from the app down to the 26 closest nested blueprint. :issue:`4229` 27 28 29Version 2.0.1 30------------- 31 32Released 2021-05-21 33 34- Re-add the ``filename`` parameter in ``send_from_directory``. The 35 ``filename`` parameter has been renamed to ``path``, the old name 36 is deprecated. :pr:`4019` 37- Mark top-level names as exported so type checking understands 38 imports in user projects. :issue:`4024` 39- Fix type annotation for ``g`` and inform mypy that it is a namespace 40 object that has arbitrary attributes. :issue:`4020` 41- Fix some types that weren't available in Python 3.6.0. :issue:`4040` 42- Improve typing for ``send_file``, ``send_from_directory``, and 43 ``get_send_file_max_age``. :issue:`4044`, :pr:`4026` 44- Show an error when a blueprint name contains a dot. The ``.`` has 45 special meaning, it is used to separate (nested) blueprint names and 46 the endpoint name. :issue:`4041` 47- Combine URL prefixes when nesting blueprints that were created with 48 a ``url_prefix`` value. :issue:`4037` 49- Roll back a change to the order that URL matching was done. The 50 URL is again matched after the session is loaded, so the session is 51 available in custom URL converters. :issue:`4053` 52- Re-add deprecated ``Config.from_json``, which was accidentally 53 removed early. :issue:`4078` 54- Improve typing for some functions using ``Callable`` in their type 55 signatures, focusing on decorator factories. :issue:`4060` 56- Nested blueprints are registered with their dotted name. This allows 57 different blueprints with the same name to be nested at different 58 locations. :issue:`4069` 59- ``register_blueprint`` takes a ``name`` option to change the 60 (pre-dotted) name the blueprint is registered with. This allows the 61 same blueprint to be registered multiple times with unique names for 62 ``url_for``. Registering the same blueprint with the same name 63 multiple times is deprecated. :issue:`1091` 64- Improve typing for ``stream_with_context``. :issue:`4052` 65 66 67Version 2.0.0 68------------- 69 70Released 2021-05-11 71 72- Drop support for Python 2 and 3.5. 73- Bump minimum versions of other Pallets projects: Werkzeug >= 2, 74 Jinja2 >= 3, MarkupSafe >= 2, ItsDangerous >= 2, Click >= 8. Be sure 75 to check the change logs for each project. For better compatibility 76 with other applications (e.g. Celery) that still require Click 7, 77 there is no hard dependency on Click 8 yet, but using Click 7 will 78 trigger a DeprecationWarning and Flask 2.1 will depend on Click 8. 79- JSON support no longer uses simplejson. To use another JSON module, 80 override ``app.json_encoder`` and ``json_decoder``. :issue:`3555` 81- The ``encoding`` option to JSON functions is deprecated. :pr:`3562` 82- Passing ``script_info`` to app factory functions is deprecated. This 83 was not portable outside the ``flask`` command. Use 84 ``click.get_current_context().obj`` if it's needed. :issue:`3552` 85- The CLI shows better error messages when the app failed to load 86 when looking up commands. :issue:`2741` 87- Add :meth:`sessions.SessionInterface.get_cookie_name` to allow 88 setting the session cookie name dynamically. :pr:`3369` 89- Add :meth:`Config.from_file` to load config using arbitrary file 90 loaders, such as ``toml.load`` or ``json.load``. 91 :meth:`Config.from_json` is deprecated in favor of this. :pr:`3398` 92- The ``flask run`` command will only defer errors on reload. Errors 93 present during the initial call will cause the server to exit with 94 the traceback immediately. :issue:`3431` 95- :func:`send_file` raises a :exc:`ValueError` when passed an 96 :mod:`io` object in text mode. Previously, it would respond with 97 200 OK and an empty file. :issue:`3358` 98- When using ad-hoc certificates, check for the cryptography library 99 instead of PyOpenSSL. :pr:`3492` 100- When specifying a factory function with ``FLASK_APP``, keyword 101 argument can be passed. :issue:`3553` 102- When loading a ``.env`` or ``.flaskenv`` file, the current working 103 directory is no longer changed to the location of the file. 104 :pr:`3560` 105- When returning a ``(response, headers)`` tuple from a view, the 106 headers replace rather than extend existing headers on the response. 107 For example, this allows setting the ``Content-Type`` for 108 ``jsonify()``. Use ``response.headers.extend()`` if extending is 109 desired. :issue:`3628` 110- The ``Scaffold`` class provides a common API for the ``Flask`` and 111 ``Blueprint`` classes. ``Blueprint`` information is stored in 112 attributes just like ``Flask``, rather than opaque lambda functions. 113 This is intended to improve consistency and maintainability. 114 :issue:`3215` 115- Include ``samesite`` and ``secure`` options when removing the 116 session cookie. :pr:`3726` 117- Support passing a ``pathlib.Path`` to ``static_folder``. :pr:`3579` 118- ``send_file`` and ``send_from_directory`` are wrappers around the 119 implementations in ``werkzeug.utils``. :pr:`3828` 120- Some ``send_file`` parameters have been renamed, the old names are 121 deprecated. ``attachment_filename`` is renamed to ``download_name``. 122 ``cache_timeout`` is renamed to ``max_age``. ``add_etags`` is 123 renamed to ``etag``. :pr:`3828, 3883` 124- ``send_file`` passes ``download_name`` even if 125 ``as_attachment=False`` by using ``Content-Disposition: inline``. 126 :pr:`3828` 127- ``send_file`` sets ``conditional=True`` and ``max_age=None`` by 128 default. ``Cache-Control`` is set to ``no-cache`` if ``max_age`` is 129 not set, otherwise ``public``. This tells browsers to validate 130 conditional requests instead of using a timed cache. :pr:`3828` 131- ``helpers.safe_join`` is deprecated. Use 132 ``werkzeug.utils.safe_join`` instead. :pr:`3828` 133- The request context does route matching before opening the session. 134 This could allow a session interface to change behavior based on 135 ``request.endpoint``. :issue:`3776` 136- Use Jinja's implementation of the ``|tojson`` filter. :issue:`3881` 137- Add route decorators for common HTTP methods. For example, 138 ``@app.post("/login")`` is a shortcut for 139 ``@app.route("/login", methods=["POST"])``. :pr:`3907` 140- Support async views, error handlers, before and after request, and 141 teardown functions. :pr:`3412` 142- Support nesting blueprints. :issue:`593, 1548`, :pr:`3923` 143- Set the default encoding to "UTF-8" when loading ``.env`` and 144 ``.flaskenv`` files to allow to use non-ASCII characters. :issue:`3931` 145- ``flask shell`` sets up tab and history completion like the default 146 ``python`` shell if ``readline`` is installed. :issue:`3941` 147- ``helpers.total_seconds()`` is deprecated. Use 148 ``timedelta.total_seconds()`` instead. :pr:`3962` 149- Add type hinting. :pr:`3973`. 150 151 152Version 1.1.4 153------------- 154 155Released 2021-05-13 156 157- Update ``static_folder`` to use ``_compat.fspath`` instead of 158 ``os.fspath`` to continue supporting Python < 3.6 :issue:`4050` 159 160 161Version 1.1.3 162------------- 163 164Released 2021-05-13 165 166- Set maximum versions of Werkzeug, Jinja, Click, and ItsDangerous. 167 :issue:`4043` 168- Re-add support for passing a ``pathlib.Path`` for ``static_folder``. 169 :pr:`3579` 170 171 172Version 1.1.2 173------------- 174 175Released 2020-04-03 176 177- Work around an issue when running the ``flask`` command with an 178 external debugger on Windows. :issue:`3297` 179- The static route will not catch all URLs if the ``Flask`` 180 ``static_folder`` argument ends with a slash. :issue:`3452` 181 182 183Version 1.1.1 184------------- 185 186Released 2019-07-08 187 188- The ``flask.json_available`` flag was added back for compatibility 189 with some extensions. It will raise a deprecation warning when used, 190 and will be removed in version 2.0.0. :issue:`3288` 191 192 193Version 1.1.0 194------------- 195 196Released 2019-07-04 197 198- Bump minimum Werkzeug version to >= 0.15. 199- Drop support for Python 3.4. 200- Error handlers for ``InternalServerError`` or ``500`` will always be 201 passed an instance of ``InternalServerError``. If they are invoked 202 due to an unhandled exception, that original exception is now 203 available as ``e.original_exception`` rather than being passed 204 directly to the handler. The same is true if the handler is for the 205 base ``HTTPException``. This makes error handler behavior more 206 consistent. :pr:`3266` 207 208 - :meth:`Flask.finalize_request` is called for all unhandled 209 exceptions even if there is no ``500`` error handler. 210 211- :attr:`Flask.logger` takes the same name as 212 :attr:`Flask.name` (the value passed as 213 ``Flask(import_name)``. This reverts 1.0's behavior of always 214 logging to ``"flask.app"``, in order to support multiple apps in the 215 same process. A warning will be shown if old configuration is 216 detected that needs to be moved. :issue:`2866` 217- :meth:`flask.RequestContext.copy` includes the current session 218 object in the request context copy. This prevents ``session`` 219 pointing to an out-of-date object. :issue:`2935` 220- Using built-in RequestContext, unprintable Unicode characters in 221 Host header will result in a HTTP 400 response and not HTTP 500 as 222 previously. :pr:`2994` 223- :func:`send_file` supports :class:`~os.PathLike` objects as 224 described in PEP 0519, to support :mod:`pathlib` in Python 3. 225 :pr:`3059` 226- :func:`send_file` supports :class:`~io.BytesIO` partial content. 227 :issue:`2957` 228- :func:`open_resource` accepts the "rt" file mode. This still does 229 the same thing as "r". :issue:`3163` 230- The :attr:`MethodView.methods` attribute set in a base class is used 231 by subclasses. :issue:`3138` 232- :attr:`Flask.jinja_options` is a ``dict`` instead of an 233 ``ImmutableDict`` to allow easier configuration. Changes must still 234 be made before creating the environment. :pr:`3190` 235- Flask's ``JSONMixin`` for the request and response wrappers was 236 moved into Werkzeug. Use Werkzeug's version with Flask-specific 237 support. This bumps the Werkzeug dependency to >= 0.15. 238 :issue:`3125` 239- The ``flask`` command entry point is simplified to take advantage 240 of Werkzeug 0.15's better reloader support. This bumps the Werkzeug 241 dependency to >= 0.15. :issue:`3022` 242- Support ``static_url_path`` that ends with a forward slash. 243 :issue:`3134` 244- Support empty ``static_folder`` without requiring setting an empty 245 ``static_url_path`` as well. :pr:`3124` 246- :meth:`jsonify` supports :class:`dataclasses.dataclass` objects. 247 :pr:`3195` 248- Allow customizing the :attr:`Flask.url_map_class` used for routing. 249 :pr:`3069` 250- The development server port can be set to 0, which tells the OS to 251 pick an available port. :issue:`2926` 252- The return value from :meth:`cli.load_dotenv` is more consistent 253 with the documentation. It will return ``False`` if python-dotenv is 254 not installed, or if the given path isn't a file. :issue:`2937` 255- Signaling support has a stub for the ``connect_via`` method when 256 the Blinker library is not installed. :pr:`3208` 257- Add an ``--extra-files`` option to the ``flask run`` CLI command to 258 specify extra files that will trigger the reloader on change. 259 :issue:`2897` 260- Allow returning a dictionary from a view function. Similar to how 261 returning a string will produce a ``text/html`` response, returning 262 a dict will call ``jsonify`` to produce a ``application/json`` 263 response. :pr:`3111` 264- Blueprints have a ``cli`` Click group like ``app.cli``. CLI commands 265 registered with a blueprint will be available as a group under the 266 ``flask`` command. :issue:`1357`. 267- When using the test client as a context manager (``with client:``), 268 all preserved request contexts are popped when the block exits, 269 ensuring nested contexts are cleaned up correctly. :pr:`3157` 270- Show a better error message when the view return type is not 271 supported. :issue:`3214` 272- ``flask.testing.make_test_environ_builder()`` has been deprecated in 273 favour of a new class ``flask.testing.EnvironBuilder``. :pr:`3232` 274- The ``flask run`` command no longer fails if Python is not built 275 with SSL support. Using the ``--cert`` option will show an 276 appropriate error message. :issue:`3211` 277- URL matching now occurs after the request context is pushed, rather 278 than when it's created. This allows custom URL converters to access 279 the app and request contexts, such as to query a database for an id. 280 :issue:`3088` 281 282 283Version 1.0.4 284------------- 285 286Released 2019-07-04 287 288- The key information for ``BadRequestKeyError`` is no longer cleared 289 outside debug mode, so error handlers can still access it. This 290 requires upgrading to Werkzeug 0.15.5. :issue:`3249` 291- ``send_file`` url quotes the ":" and "/" characters for more 292 compatible UTF-8 filename support in some browsers. :issue:`3074` 293- Fixes for PEP451 import loaders and pytest 5.x. :issue:`3275` 294- Show message about dotenv on stderr instead of stdout. :issue:`3285` 295 296 297Version 1.0.3 298------------- 299 300Released 2019-05-17 301 302- :func:`send_file` encodes filenames as ASCII instead of Latin-1 303 (ISO-8859-1). This fixes compatibility with Gunicorn, which is 304 stricter about header encodings than PEP 3333. :issue:`2766` 305- Allow custom CLIs using ``FlaskGroup`` to set the debug flag without 306 it always being overwritten based on environment variables. 307 :pr:`2765` 308- ``flask --version`` outputs Werkzeug's version and simplifies the 309 Python version. :pr:`2825` 310- :func:`send_file` handles an ``attachment_filename`` that is a 311 native Python 2 string (bytes) with UTF-8 coded bytes. :issue:`2933` 312- A catch-all error handler registered for ``HTTPException`` will not 313 handle ``RoutingException``, which is used internally during 314 routing. This fixes the unexpected behavior that had been introduced 315 in 1.0. :pr:`2986` 316- Passing the ``json`` argument to ``app.test_client`` does not 317 push/pop an extra app context. :issue:`2900` 318 319 320Version 1.0.2 321------------- 322 323Released 2018-05-02 324 325- Fix more backwards compatibility issues with merging slashes between 326 a blueprint prefix and route. :pr:`2748` 327- Fix error with ``flask routes`` command when there are no routes. 328 :issue:`2751` 329 330 331Version 1.0.1 332------------- 333 334Released 2018-04-29 335 336- Fix registering partials (with no ``__name__``) as view functions. 337 :pr:`2730` 338- Don't treat lists returned from view functions the same as tuples. 339 Only tuples are interpreted as response data. :issue:`2736` 340- Extra slashes between a blueprint's ``url_prefix`` and a route URL 341 are merged. This fixes some backwards compatibility issues with the 342 change in 1.0. :issue:`2731`, :issue:`2742` 343- Only trap ``BadRequestKeyError`` errors in debug mode, not all 344 ``BadRequest`` errors. This allows ``abort(400)`` to continue 345 working as expected. :issue:`2735` 346- The ``FLASK_SKIP_DOTENV`` environment variable can be set to ``1`` 347 to skip automatically loading dotenv files. :issue:`2722` 348 349 350Version 1.0 351----------- 352 353Released 2018-04-26 354 355- Python 2.6 and 3.3 are no longer supported. 356- Bump minimum dependency versions to the latest stable versions: 357 Werkzeug >= 0.14, Jinja >= 2.10, itsdangerous >= 0.24, Click >= 5.1. 358 :issue:`2586` 359- Skip :meth:`app.run <Flask.run>` when a Flask application is run 360 from the command line. This avoids some behavior that was confusing 361 to debug. 362- Change the default for :data:`JSONIFY_PRETTYPRINT_REGULAR` to 363 ``False``. :func:`~json.jsonify` returns a compact format by 364 default, and an indented format in debug mode. :pr:`2193` 365- :meth:`Flask.__init__ <Flask>` accepts the ``host_matching`` 366 argument and sets it on :attr:`~Flask.url_map`. :issue:`1559` 367- :meth:`Flask.__init__ <Flask>` accepts the ``static_host`` argument 368 and passes it as the ``host`` argument when defining the static 369 route. :issue:`1559` 370- :func:`send_file` supports Unicode in ``attachment_filename``. 371 :pr:`2223` 372- Pass ``_scheme`` argument from :func:`url_for` to 373 :meth:`~Flask.handle_url_build_error`. :pr:`2017` 374- :meth:`~Flask.add_url_rule` accepts the 375 ``provide_automatic_options`` argument to disable adding the 376 ``OPTIONS`` method. :pr:`1489` 377- :class:`~views.MethodView` subclasses inherit method handlers from 378 base classes. :pr:`1936` 379- Errors caused while opening the session at the beginning of the 380 request are handled by the app's error handlers. :pr:`2254` 381- Blueprints gained :attr:`~Blueprint.json_encoder` and 382 :attr:`~Blueprint.json_decoder` attributes to override the app's 383 encoder and decoder. :pr:`1898` 384- :meth:`Flask.make_response` raises ``TypeError`` instead of 385 ``ValueError`` for bad response types. The error messages have been 386 improved to describe why the type is invalid. :pr:`2256` 387- Add ``routes`` CLI command to output routes registered on the 388 application. :pr:`2259` 389- Show warning when session cookie domain is a bare hostname or an IP 390 address, as these may not behave properly in some browsers, such as 391 Chrome. :pr:`2282` 392- Allow IP address as exact session cookie domain. :pr:`2282` 393- ``SESSION_COOKIE_DOMAIN`` is set if it is detected through 394 ``SERVER_NAME``. :pr:`2282` 395- Auto-detect zero-argument app factory called ``create_app`` or 396 ``make_app`` from ``FLASK_APP``. :pr:`2297` 397- Factory functions are not required to take a ``script_info`` 398 parameter to work with the ``flask`` command. If they take a single 399 parameter or a parameter named ``script_info``, the 400 :class:`~cli.ScriptInfo` object will be passed. :pr:`2319` 401- ``FLASK_APP`` can be set to an app factory, with arguments if 402 needed, for example ``FLASK_APP=myproject.app:create_app('dev')``. 403 :pr:`2326` 404- ``FLASK_APP`` can point to local packages that are not installed in 405 editable mode, although ``pip install -e`` is still preferred. 406 :pr:`2414` 407- The :class:`~views.View` class attribute 408 :attr:`~views.View.provide_automatic_options` is set in 409 :meth:`~views.View.as_view`, to be detected by 410 :meth:`~Flask.add_url_rule`. :pr:`2316` 411- Error handling will try handlers registered for ``blueprint, code``, 412 ``app, code``, ``blueprint, exception``, ``app, exception``. 413 :pr:`2314` 414- ``Cookie`` is added to the response's ``Vary`` header if the session 415 is accessed at all during the request (and not deleted). :pr:`2288` 416- :meth:`~Flask.test_request_context` accepts ``subdomain`` and 417 ``url_scheme`` arguments for use when building the base URL. 418 :pr:`1621` 419- Set :data:`APPLICATION_ROOT` to ``'/'`` by default. This was already 420 the implicit default when it was set to ``None``. 421- :data:`TRAP_BAD_REQUEST_ERRORS` is enabled by default in debug mode. 422 ``BadRequestKeyError`` has a message with the bad key in debug mode 423 instead of the generic bad request message. :pr:`2348` 424- Allow registering new tags with 425 :class:`~json.tag.TaggedJSONSerializer` to support storing other 426 types in the session cookie. :pr:`2352` 427- Only open the session if the request has not been pushed onto the 428 context stack yet. This allows :func:`~stream_with_context` 429 generators to access the same session that the containing view uses. 430 :pr:`2354` 431- Add ``json`` keyword argument for the test client request methods. 432 This will dump the given object as JSON and set the appropriate 433 content type. :pr:`2358` 434- Extract JSON handling to a mixin applied to both the 435 :class:`Request` and :class:`Response` classes. This adds the 436 :meth:`~Response.is_json` and :meth:`~Response.get_json` methods to 437 the response to make testing JSON response much easier. :pr:`2358` 438- Removed error handler caching because it caused unexpected results 439 for some exception inheritance hierarchies. Register handlers 440 explicitly for each exception if you want to avoid traversing the 441 MRO. :pr:`2362` 442- Fix incorrect JSON encoding of aware, non-UTC datetimes. :pr:`2374` 443- Template auto reloading will honor debug mode even even if 444 :attr:`~Flask.jinja_env` was already accessed. :pr:`2373` 445- The following old deprecated code was removed. :issue:`2385` 446 447 - ``flask.ext`` - import extensions directly by their name instead 448 of through the ``flask.ext`` namespace. For example, 449 ``import flask.ext.sqlalchemy`` becomes 450 ``import flask_sqlalchemy``. 451 - ``Flask.init_jinja_globals`` - extend 452 :meth:`Flask.create_jinja_environment` instead. 453 - ``Flask.error_handlers`` - tracked by 454 :attr:`Flask.error_handler_spec`, use :meth:`Flask.errorhandler` 455 to register handlers. 456 - ``Flask.request_globals_class`` - use 457 :attr:`Flask.app_ctx_globals_class` instead. 458 - ``Flask.static_path`` - use :attr:`Flask.static_url_path` 459 instead. 460 - ``Request.module`` - use :attr:`Request.blueprint` instead. 461 462- The :attr:`Request.json` property is no longer deprecated. 463 :issue:`1421` 464- Support passing a :class:`~werkzeug.test.EnvironBuilder` or ``dict`` 465 to :meth:`test_client.open <werkzeug.test.Client.open>`. :pr:`2412` 466- The ``flask`` command and :meth:`Flask.run` will load environment 467 variables from ``.env`` and ``.flaskenv`` files if python-dotenv is 468 installed. :pr:`2416` 469- When passing a full URL to the test client, the scheme in the URL is 470 used instead of :data:`PREFERRED_URL_SCHEME`. :pr:`2430` 471- :attr:`Flask.logger` has been simplified. ``LOGGER_NAME`` and 472 ``LOGGER_HANDLER_POLICY`` config was removed. The logger is always 473 named ``flask.app``. The level is only set on first access, it 474 doesn't check :attr:`Flask.debug` each time. Only one format is 475 used, not different ones depending on :attr:`Flask.debug`. No 476 handlers are removed, and a handler is only added if no handlers are 477 already configured. :pr:`2436` 478- Blueprint view function names may not contain dots. :pr:`2450` 479- Fix a ``ValueError`` caused by invalid ``Range`` requests in some 480 cases. :issue:`2526` 481- The development server uses threads by default. :pr:`2529` 482- Loading config files with ``silent=True`` will ignore 483 :data:`~errno.ENOTDIR` errors. :pr:`2581` 484- Pass ``--cert`` and ``--key`` options to ``flask run`` to run the 485 development server over HTTPS. :pr:`2606` 486- Added :data:`SESSION_COOKIE_SAMESITE` to control the ``SameSite`` 487 attribute on the session cookie. :pr:`2607` 488- Added :meth:`~flask.Flask.test_cli_runner` to create a Click runner 489 that can invoke Flask CLI commands for testing. :pr:`2636` 490- Subdomain matching is disabled by default and setting 491 :data:`SERVER_NAME` does not implicitly enable it. It can be enabled 492 by passing ``subdomain_matching=True`` to the ``Flask`` constructor. 493 :pr:`2635` 494- A single trailing slash is stripped from the blueprint 495 ``url_prefix`` when it is registered with the app. :pr:`2629` 496- :meth:`Request.get_json` doesn't cache the result if parsing fails 497 when ``silent`` is true. :issue:`2651` 498- :func:`Request.get_json` no longer accepts arbitrary encodings. 499 Incoming JSON should be encoded using UTF-8 per :rfc:`8259`, but 500 Flask will autodetect UTF-8, -16, or -32. :pr:`2691` 501- Added :data:`MAX_COOKIE_SIZE` and :attr:`Response.max_cookie_size` 502 to control when Werkzeug warns about large cookies that browsers may 503 ignore. :pr:`2693` 504- Updated documentation theme to make docs look better in small 505 windows. :pr:`2709` 506- Rewrote the tutorial docs and example project to take a more 507 structured approach to help new users avoid common pitfalls. 508 :pr:`2676` 509 510 511Version 0.12.5 512-------------- 513 514Released 2020-02-10 515 516- Pin Werkzeug to < 1.0.0. :issue:`3497` 517 518 519Version 0.12.4 520-------------- 521 522Released 2018-04-29 523 524- Repackage 0.12.3 to fix package layout issue. :issue:`2728` 525 526 527Version 0.12.3 528-------------- 529 530Released 2018-04-26 531 532- :func:`Request.get_json` no longer accepts arbitrary encodings. 533 Incoming JSON should be encoded using UTF-8 per :rfc:`8259`, but 534 Flask will autodetect UTF-8, -16, or -32. :issue:`2692` 535- Fix a Python warning about imports when using ``python -m flask``. 536 :issue:`2666` 537- Fix a ``ValueError`` caused by invalid ``Range`` requests in some 538 cases. 539 540 541Version 0.12.2 542-------------- 543 544Released 2017-05-16 545 546- Fix a bug in ``safe_join`` on Windows. 547 548 549Version 0.12.1 550-------------- 551 552Released 2017-03-31 553 554- Prevent ``flask run`` from showing a ``NoAppException`` when an 555 ``ImportError`` occurs within the imported application module. 556- Fix encoding behavior of ``app.config.from_pyfile`` for Python 3. 557 :issue:`2118` 558- Use the ``SERVER_NAME`` config if it is present as default values 559 for ``app.run``. :issue:`2109`, :pr:`2152` 560- Call ``ctx.auto_pop`` with the exception object instead of ``None``, 561 in the event that a ``BaseException`` such as ``KeyboardInterrupt`` 562 is raised in a request handler. 563 564 565Version 0.12 566------------ 567 568Released 2016-12-21, codename Punsch 569 570- The cli command now responds to ``--version``. 571- Mimetype guessing and ETag generation for file-like objects in 572 ``send_file`` has been removed. :issue:`104`, :pr`1849` 573- Mimetype guessing in ``send_file`` now fails loudly and doesn't fall 574 back to ``application/octet-stream``. :pr:`1988` 575- Make ``flask.safe_join`` able to join multiple paths like 576 ``os.path.join`` :pr:`1730` 577- Revert a behavior change that made the dev server crash instead of 578 returning an Internal Server Error. :pr:`2006` 579- Correctly invoke response handlers for both regular request 580 dispatching as well as error handlers. 581- Disable logger propagation by default for the app logger. 582- Add support for range requests in ``send_file``. 583- ``app.test_client`` includes preset default environment, which can 584 now be directly set, instead of per ``client.get``. 585- Fix crash when running under PyPy3. :pr:`1814` 586 587 588Version 0.11.1 589-------------- 590 591Released 2016-06-07 592 593- Fixed a bug that prevented ``FLASK_APP=foobar/__init__.py`` from 594 working. :pr:`1872` 595 596 597Version 0.11 598------------ 599 600Released 2016-05-29, codename Absinthe 601 602- Added support to serializing top-level arrays to 603 :func:`flask.jsonify`. This introduces a security risk in ancient 604 browsers. 605- Added before_render_template signal. 606- Added ``**kwargs`` to :meth:`flask.Test.test_client` to support 607 passing additional keyword arguments to the constructor of 608 :attr:`flask.Flask.test_client_class`. 609- Added ``SESSION_REFRESH_EACH_REQUEST`` config key that controls the 610 set-cookie behavior. If set to ``True`` a permanent session will be 611 refreshed each request and get their lifetime extended, if set to 612 ``False`` it will only be modified if the session actually modifies. 613 Non permanent sessions are not affected by this and will always 614 expire if the browser window closes. 615- Made Flask support custom JSON mimetypes for incoming data. 616- Added support for returning tuples in the form ``(response, 617 headers)`` from a view function. 618- Added :meth:`flask.Config.from_json`. 619- Added :attr:`flask.Flask.config_class`. 620- Added :meth:`flask.Config.get_namespace`. 621- Templates are no longer automatically reloaded outside of debug 622 mode. This can be configured with the new ``TEMPLATES_AUTO_RELOAD`` 623 config key. 624- Added a workaround for a limitation in Python 3.3's namespace 625 loader. 626- Added support for explicit root paths when using Python 3.3's 627 namespace packages. 628- Added :command:`flask` and the ``flask.cli`` module to start the 629 local debug server through the click CLI system. This is recommended 630 over the old ``flask.run()`` method as it works faster and more 631 reliable due to a different design and also replaces 632 ``Flask-Script``. 633- Error handlers that match specific classes are now checked first, 634 thereby allowing catching exceptions that are subclasses of HTTP 635 exceptions (in ``werkzeug.exceptions``). This makes it possible for 636 an extension author to create exceptions that will by default result 637 in the HTTP error of their choosing, but may be caught with a custom 638 error handler if desired. 639- Added :meth:`flask.Config.from_mapping`. 640- Flask will now log by default even if debug is disabled. The log 641 format is now hardcoded but the default log handling can be disabled 642 through the ``LOGGER_HANDLER_POLICY`` configuration key. 643- Removed deprecated module functionality. 644- Added the ``EXPLAIN_TEMPLATE_LOADING`` config flag which when 645 enabled will instruct Flask to explain how it locates templates. 646 This should help users debug when the wrong templates are loaded. 647- Enforce blueprint handling in the order they were registered for 648 template loading. 649- Ported test suite to py.test. 650- Deprecated ``request.json`` in favour of ``request.get_json()``. 651- Add "pretty" and "compressed" separators definitions in jsonify() 652 method. Reduces JSON response size when 653 ``JSONIFY_PRETTYPRINT_REGULAR=False`` by removing unnecessary white 654 space included by default after separators. 655- JSON responses are now terminated with a newline character, because 656 it is a convention that UNIX text files end with a newline and some 657 clients don't deal well when this newline is missing. This came up 658 originally as a part of 659 https://github.com/postmanlabs/httpbin/issues/168. :pr:`1262` 660- The automatically provided ``OPTIONS`` method is now correctly 661 disabled if the user registered an overriding rule with the 662 lowercase-version ``options``. :issue:`1288` 663- ``flask.json.jsonify`` now supports the ``datetime.date`` type. 664 :pr:`1326` 665- Don't leak exception info of already caught exceptions to context 666 teardown handlers. :pr:`1393` 667- Allow custom Jinja environment subclasses. :pr:`1422` 668- Updated extension dev guidelines. 669- ``flask.g`` now has ``pop()`` and ``setdefault`` methods. 670- Turn on autoescape for ``flask.templating.render_template_string`` 671 by default. :pr:`1515` 672- ``flask.ext`` is now deprecated. :pr:`1484` 673- ``send_from_directory`` now raises BadRequest if the filename is 674 invalid on the server OS. :pr:`1763` 675- Added the ``JSONIFY_MIMETYPE`` configuration variable. :pr:`1728` 676- Exceptions during teardown handling will no longer leave bad 677 application contexts lingering around. 678- Fixed broken ``test_appcontext_signals()`` test case. 679- Raise an :exc:`AttributeError` in :func:`flask.helpers.find_package` 680 with a useful message explaining why it is raised when a PEP 302 681 import hook is used without an ``is_package()`` method. 682- Fixed an issue causing exceptions raised before entering a request 683 or app context to be passed to teardown handlers. 684- Fixed an issue with query parameters getting removed from requests 685 in the test client when absolute URLs were requested. 686- Made ``@before_first_request`` into a decorator as intended. 687- Fixed an etags bug when sending a file streams with a name. 688- Fixed ``send_from_directory`` not expanding to the application root 689 path correctly. 690- Changed logic of before first request handlers to flip the flag 691 after invoking. This will allow some uses that are potentially 692 dangerous but should probably be permitted. 693- Fixed Python 3 bug when a handler from 694 ``app.url_build_error_handlers`` reraises the ``BuildError``. 695 696 697Version 0.10.1 698-------------- 699 700Released 2013-06-14 701 702- Fixed an issue where ``|tojson`` was not quoting single quotes which 703 made the filter not work properly in HTML attributes. Now it's 704 possible to use that filter in single quoted attributes. This should 705 make using that filter with angular.js easier. 706- Added support for byte strings back to the session system. This 707 broke compatibility with the common case of people putting binary 708 data for token verification into the session. 709- Fixed an issue where registering the same method twice for the same 710 endpoint would trigger an exception incorrectly. 711 712 713Version 0.10 714------------ 715 716Released 2013-06-13, codename Limoncello 717 718- Changed default cookie serialization format from pickle to JSON to 719 limit the impact an attacker can do if the secret key leaks. 720- Added ``template_test`` methods in addition to the already existing 721 ``template_filter`` method family. 722- Added ``template_global`` methods in addition to the already 723 existing ``template_filter`` method family. 724- Set the content-length header for x-sendfile. 725- ``tojson`` filter now does not escape script blocks in HTML5 726 parsers. 727- ``tojson`` used in templates is now safe by default due. This was 728 allowed due to the different escaping behavior. 729- Flask will now raise an error if you attempt to register a new 730 function on an already used endpoint. 731- Added wrapper module around simplejson and added default 732 serialization of datetime objects. This allows much easier 733 customization of how JSON is handled by Flask or any Flask 734 extension. 735- Removed deprecated internal ``flask.session`` module alias. Use 736 ``flask.sessions`` instead to get the session module. This is not to 737 be confused with ``flask.session`` the session proxy. 738- Templates can now be rendered without request context. The behavior 739 is slightly different as the ``request``, ``session`` and ``g`` 740 objects will not be available and blueprint's context processors are 741 not called. 742- The config object is now available to the template as a real global 743 and not through a context processor which makes it available even in 744 imported templates by default. 745- Added an option to generate non-ascii encoded JSON which should 746 result in less bytes being transmitted over the network. It's 747 disabled by default to not cause confusion with existing libraries 748 that might expect ``flask.json.dumps`` to return bytes by default. 749- ``flask.g`` is now stored on the app context instead of the request 750 context. 751- ``flask.g`` now gained a ``get()`` method for not erroring out on 752 non existing items. 753- ``flask.g`` now can be used with the ``in`` operator to see what's 754 defined and it now is iterable and will yield all attributes stored. 755- ``flask.Flask.request_globals_class`` got renamed to 756 ``flask.Flask.app_ctx_globals_class`` which is a better name to what 757 it does since 0.10. 758- ``request``, ``session`` and ``g`` are now also added as proxies to 759 the template context which makes them available in imported 760 templates. One has to be very careful with those though because 761 usage outside of macros might cause caching. 762- Flask will no longer invoke the wrong error handlers if a proxy 763 exception is passed through. 764- Added a workaround for chrome's cookies in localhost not working as 765 intended with domain names. 766- Changed logic for picking defaults for cookie values from sessions 767 to work better with Google Chrome. 768- Added ``message_flashed`` signal that simplifies flashing testing. 769- Added support for copying of request contexts for better working 770 with greenlets. 771- Removed custom JSON HTTP exception subclasses. If you were relying 772 on them you can reintroduce them again yourself trivially. Using 773 them however is strongly discouraged as the interface was flawed. 774- Python requirements changed: requiring Python 2.6 or 2.7 now to 775 prepare for Python 3.3 port. 776- Changed how the teardown system is informed about exceptions. This 777 is now more reliable in case something handles an exception halfway 778 through the error handling process. 779- Request context preservation in debug mode now keeps the exception 780 information around which means that teardown handlers are able to 781 distinguish error from success cases. 782- Added the ``JSONIFY_PRETTYPRINT_REGULAR`` configuration variable. 783- Flask now orders JSON keys by default to not trash HTTP caches due 784 to different hash seeds between different workers. 785- Added ``appcontext_pushed`` and ``appcontext_popped`` signals. 786- The builtin run method now takes the ``SERVER_NAME`` into account 787 when picking the default port to run on. 788- Added ``flask.request.get_json()`` as a replacement for the old 789 ``flask.request.json`` property. 790 791 792Version 0.9 793----------- 794 795Released 2012-07-01, codename Campari 796 797- The :func:`flask.Request.on_json_loading_failed` now returns a JSON 798 formatted response by default. 799- The :func:`flask.url_for` function now can generate anchors to the 800 generated links. 801- The :func:`flask.url_for` function now can also explicitly generate 802 URL rules specific to a given HTTP method. 803- Logger now only returns the debug log setting if it was not set 804 explicitly. 805- Unregister a circular dependency between the WSGI environment and 806 the request object when shutting down the request. This means that 807 environ ``werkzeug.request`` will be ``None`` after the response was 808 returned to the WSGI server but has the advantage that the garbage 809 collector is not needed on CPython to tear down the request unless 810 the user created circular dependencies themselves. 811- Session is now stored after callbacks so that if the session payload 812 is stored in the session you can still modify it in an after request 813 callback. 814- The :class:`flask.Flask` class will avoid importing the provided 815 import name if it can (the required first parameter), to benefit 816 tools which build Flask instances programmatically. The Flask class 817 will fall back to using import on systems with custom module hooks, 818 e.g. Google App Engine, or when the import name is inside a zip 819 archive (usually a .egg) prior to Python 2.7. 820- Blueprints now have a decorator to add custom template filters 821 application wide, :meth:`flask.Blueprint.app_template_filter`. 822- The Flask and Blueprint classes now have a non-decorator method for 823 adding custom template filters application wide, 824 :meth:`flask.Flask.add_template_filter` and 825 :meth:`flask.Blueprint.add_app_template_filter`. 826- The :func:`flask.get_flashed_messages` function now allows rendering 827 flashed message categories in separate blocks, through a 828 ``category_filter`` argument. 829- The :meth:`flask.Flask.run` method now accepts ``None`` for ``host`` 830 and ``port`` arguments, using default values when ``None``. This 831 allows for calling run using configuration values, e.g. 832 ``app.run(app.config.get('MYHOST'), app.config.get('MYPORT'))``, 833 with proper behavior whether or not a config file is provided. 834- The :meth:`flask.render_template` method now accepts a either an 835 iterable of template names or a single template name. Previously, it 836 only accepted a single template name. On an iterable, the first 837 template found is rendered. 838- Added :meth:`flask.Flask.app_context` which works very similar to 839 the request context but only provides access to the current 840 application. This also adds support for URL generation without an 841 active request context. 842- View functions can now return a tuple with the first instance being 843 an instance of :class:`flask.Response`. This allows for returning 844 ``jsonify(error="error msg"), 400`` from a view function. 845- :class:`~flask.Flask` and :class:`~flask.Blueprint` now provide a 846 :meth:`~flask.Flask.get_send_file_max_age` hook for subclasses to 847 override behavior of serving static files from Flask when using 848 :meth:`flask.Flask.send_static_file` (used for the default static 849 file handler) and :func:`~flask.helpers.send_file`. This hook is 850 provided a filename, which for example allows changing cache 851 controls by file extension. The default max-age for ``send_file`` 852 and static files can be configured through a new 853 ``SEND_FILE_MAX_AGE_DEFAULT`` configuration variable, which is used 854 in the default ``get_send_file_max_age`` implementation. 855- Fixed an assumption in sessions implementation which could break 856 message flashing on sessions implementations which use external 857 storage. 858- Changed the behavior of tuple return values from functions. They are 859 no longer arguments to the response object, they now have a defined 860 meaning. 861- Added :attr:`flask.Flask.request_globals_class` to allow a specific 862 class to be used on creation of the :data:`~flask.g` instance of 863 each request. 864- Added ``required_methods`` attribute to view functions to force-add 865 methods on registration. 866- Added :func:`flask.after_this_request`. 867- Added :func:`flask.stream_with_context` and the ability to push 868 contexts multiple times without producing unexpected behavior. 869 870 871Version 0.8.1 872------------- 873 874Released 2012-07-01 875 876- Fixed an issue with the undocumented ``flask.session`` module to not 877 work properly on Python 2.5. It should not be used but did cause 878 some problems for package managers. 879 880 881Version 0.8 882----------- 883 884Released 2011-09-29, codename Rakija 885 886- Refactored session support into a session interface so that the 887 implementation of the sessions can be changed without having to 888 override the Flask class. 889- Empty session cookies are now deleted properly automatically. 890- View functions can now opt out of getting the automatic OPTIONS 891 implementation. 892- HTTP exceptions and Bad Request errors can now be trapped so that 893 they show up normally in the traceback. 894- Flask in debug mode is now detecting some common problems and tries 895 to warn you about them. 896- Flask in debug mode will now complain with an assertion error if a 897 view was attached after the first request was handled. This gives 898 earlier feedback when users forget to import view code ahead of 899 time. 900- Added the ability to register callbacks that are only triggered once 901 at the beginning of the first request. 902 (:meth:`Flask.before_first_request`) 903- Malformed JSON data will now trigger a bad request HTTP exception 904 instead of a value error which usually would result in a 500 905 internal server error if not handled. This is a backwards 906 incompatible change. 907- Applications now not only have a root path where the resources and 908 modules are located but also an instance path which is the 909 designated place to drop files that are modified at runtime (uploads 910 etc.). Also this is conceptually only instance depending and outside 911 version control so it's the perfect place to put configuration files 912 etc. 913- Added the ``APPLICATION_ROOT`` configuration variable. 914- Implemented :meth:`~flask.testing.TestClient.session_transaction` to 915 easily modify sessions from the test environment. 916- Refactored test client internally. The ``APPLICATION_ROOT`` 917 configuration variable as well as ``SERVER_NAME`` are now properly 918 used by the test client as defaults. 919- Added :attr:`flask.views.View.decorators` to support simpler 920 decorating of pluggable (class-based) views. 921- Fixed an issue where the test client if used with the "with" 922 statement did not trigger the execution of the teardown handlers. 923- Added finer control over the session cookie parameters. 924- HEAD requests to a method view now automatically dispatch to the 925 ``get`` method if no handler was implemented. 926- Implemented the virtual :mod:`flask.ext` package to import 927 extensions from. 928- The context preservation on exceptions is now an integral component 929 of Flask itself and no longer of the test client. This cleaned up 930 some internal logic and lowers the odds of runaway request contexts 931 in unittests. 932- Fixed the Jinja2 environment's ``list_templates`` method not 933 returning the correct names when blueprints or modules were 934 involved. 935 936 937Version 0.7.2 938------------- 939 940Released 2011-07-06 941 942- Fixed an issue with URL processors not properly working on 943 blueprints. 944 945 946Version 0.7.1 947------------- 948 949Released 2011-06-29 950 951- Added missing future import that broke 2.5 compatibility. 952- Fixed an infinite redirect issue with blueprints. 953 954 955Version 0.7 956----------- 957 958Released 2011-06-28, codename Grappa 959 960- Added :meth:`~flask.Flask.make_default_options_response` which can 961 be used by subclasses to alter the default behavior for ``OPTIONS`` 962 responses. 963- Unbound locals now raise a proper :exc:`RuntimeError` instead of an 964 :exc:`AttributeError`. 965- Mimetype guessing and etag support based on file objects is now 966 deprecated for :func:`flask.send_file` because it was unreliable. 967 Pass filenames instead or attach your own etags and provide a proper 968 mimetype by hand. 969- Static file handling for modules now requires the name of the static 970 folder to be supplied explicitly. The previous autodetection was not 971 reliable and caused issues on Google's App Engine. Until 1.0 the old 972 behavior will continue to work but issue dependency warnings. 973- Fixed a problem for Flask to run on jython. 974- Added a ``PROPAGATE_EXCEPTIONS`` configuration variable that can be 975 used to flip the setting of exception propagation which previously 976 was linked to ``DEBUG`` alone and is now linked to either ``DEBUG`` 977 or ``TESTING``. 978- Flask no longer internally depends on rules being added through the 979 ``add_url_rule`` function and can now also accept regular werkzeug 980 rules added to the url map. 981- Added an ``endpoint`` method to the flask application object which 982 allows one to register a callback to an arbitrary endpoint with a 983 decorator. 984- Use Last-Modified for static file sending instead of Date which was 985 incorrectly introduced in 0.6. 986- Added ``create_jinja_loader`` to override the loader creation 987 process. 988- Implemented a silent flag for ``config.from_pyfile``. 989- Added ``teardown_request`` decorator, for functions that should run 990 at the end of a request regardless of whether an exception occurred. 991 Also the behavior for ``after_request`` was changed. It's now no 992 longer executed when an exception is raised. 993- Implemented :func:`flask.has_request_context` 994- Deprecated ``init_jinja_globals``. Override the 995 :meth:`~flask.Flask.create_jinja_environment` method instead to 996 achieve the same functionality. 997- Added :func:`flask.safe_join` 998- The automatic JSON request data unpacking now looks at the charset 999 mimetype parameter. 1000- Don't modify the session on :func:`flask.get_flashed_messages` if 1001 there are no messages in the session. 1002- ``before_request`` handlers are now able to abort requests with 1003 errors. 1004- It is not possible to define user exception handlers. That way you 1005 can provide custom error messages from a central hub for certain 1006 errors that might occur during request processing (for instance 1007 database connection errors, timeouts from remote resources etc.). 1008- Blueprints can provide blueprint specific error handlers. 1009- Implemented generic class-based views. 1010 1011 1012Version 0.6.1 1013------------- 1014 1015Released 2010-12-31 1016 1017- Fixed an issue where the default ``OPTIONS`` response was not 1018 exposing all valid methods in the ``Allow`` header. 1019- Jinja2 template loading syntax now allows "./" in front of a 1020 template load path. Previously this caused issues with module 1021 setups. 1022- Fixed an issue where the subdomain setting for modules was ignored 1023 for the static folder. 1024- Fixed a security problem that allowed clients to download arbitrary 1025 files if the host server was a windows based operating system and 1026 the client uses backslashes to escape the directory the files where 1027 exposed from. 1028 1029 1030Version 0.6 1031----------- 1032 1033Released 2010-07-27, codename Whisky 1034 1035- After request functions are now called in reverse order of 1036 registration. 1037- OPTIONS is now automatically implemented by Flask unless the 1038 application explicitly adds 'OPTIONS' as method to the URL rule. In 1039 this case no automatic OPTIONS handling kicks in. 1040- Static rules are now even in place if there is no static folder for 1041 the module. This was implemented to aid GAE which will remove the 1042 static folder if it's part of a mapping in the .yml file. 1043- The :attr:`~flask.Flask.config` is now available in the templates as 1044 ``config``. 1045- Context processors will no longer override values passed directly to 1046 the render function. 1047- Added the ability to limit the incoming request data with the new 1048 ``MAX_CONTENT_LENGTH`` configuration value. 1049- The endpoint for the :meth:`flask.Module.add_url_rule` method is now 1050 optional to be consistent with the function of the same name on the 1051 application object. 1052- Added a :func:`flask.make_response` function that simplifies 1053 creating response object instances in views. 1054- Added signalling support based on blinker. This feature is currently 1055 optional and supposed to be used by extensions and applications. If 1056 you want to use it, make sure to have `blinker`_ installed. 1057- Refactored the way URL adapters are created. This process is now 1058 fully customizable with the :meth:`~flask.Flask.create_url_adapter` 1059 method. 1060- Modules can now register for a subdomain instead of just an URL 1061 prefix. This makes it possible to bind a whole module to a 1062 configurable subdomain. 1063 1064.. _blinker: https://pypi.org/project/blinker/ 1065 1066 1067Version 0.5.2 1068------------- 1069 1070Released 2010-07-15 1071 1072- Fixed another issue with loading templates from directories when 1073 modules were used. 1074 1075 1076Version 0.5.1 1077------------- 1078 1079Released 2010-07-06 1080 1081- Fixes an issue with template loading from directories when modules 1082 where used. 1083 1084 1085Version 0.5 1086----------- 1087 1088Released 2010-07-06, codename Calvados 1089 1090- Fixed a bug with subdomains that was caused by the inability to 1091 specify the server name. The server name can now be set with the 1092 ``SERVER_NAME`` config key. This key is now also used to set the 1093 session cookie cross-subdomain wide. 1094- Autoescaping is no longer active for all templates. Instead it is 1095 only active for ``.html``, ``.htm``, ``.xml`` and ``.xhtml``. Inside 1096 templates this behavior can be changed with the ``autoescape`` tag. 1097- Refactored Flask internally. It now consists of more than a single 1098 file. 1099- :func:`flask.send_file` now emits etags and has the ability to do 1100 conditional responses builtin. 1101- (temporarily) dropped support for zipped applications. This was a 1102 rarely used feature and led to some confusing behavior. 1103- Added support for per-package template and static-file directories. 1104- Removed support for ``create_jinja_loader`` which is no longer used 1105 in 0.5 due to the improved module support. 1106- Added a helper function to expose files from any directory. 1107 1108 1109Version 0.4 1110----------- 1111 1112Released 2010-06-18, codename Rakia 1113 1114- Added the ability to register application wide error handlers from 1115 modules. 1116- :meth:`~flask.Flask.after_request` handlers are now also invoked if 1117 the request dies with an exception and an error handling page kicks 1118 in. 1119- Test client has not the ability to preserve the request context for 1120 a little longer. This can also be used to trigger custom requests 1121 that do not pop the request stack for testing. 1122- Because the Python standard library caches loggers, the name of the 1123 logger is configurable now to better support unittests. 1124- Added ``TESTING`` switch that can activate unittesting helpers. 1125- The logger switches to ``DEBUG`` mode now if debug is enabled. 1126 1127 1128Version 0.3.1 1129------------- 1130 1131Released 2010-05-28 1132 1133- Fixed a error reporting bug with :meth:`flask.Config.from_envvar` 1134- Removed some unused code from flask 1135- Release does no longer include development leftover files (.git 1136 folder for themes, built documentation in zip and pdf file and some 1137 .pyc files) 1138 1139 1140Version 0.3 1141----------- 1142 1143Released 2010-05-28, codename Schnaps 1144 1145- Added support for categories for flashed messages. 1146- The application now configures a :class:`logging.Handler` and will 1147 log request handling exceptions to that logger when not in debug 1148 mode. This makes it possible to receive mails on server errors for 1149 example. 1150- Added support for context binding that does not require the use of 1151 the with statement for playing in the console. 1152- The request context is now available within the with statement 1153 making it possible to further push the request context or pop it. 1154- Added support for configurations. 1155 1156 1157Version 0.2 1158----------- 1159 1160Released 2010-05-12, codename J?germeister 1161 1162- Various bugfixes 1163- Integrated JSON support 1164- Added :func:`~flask.get_template_attribute` helper function. 1165- :meth:`~flask.Flask.add_url_rule` can now also register a view 1166 function. 1167- Refactored internal request dispatching. 1168- Server listens on 127.0.0.1 by default now to fix issues with 1169 chrome. 1170- Added external URL support. 1171- Added support for :func:`~flask.send_file` 1172- Module support and internal request handling refactoring to better 1173 support pluggable applications. 1174- Sessions can be set to be permanent now on a per-session basis. 1175- Better error reporting on missing secret keys. 1176- Added support for Google Appengine. 1177 1178 1179Version 0.1 1180----------- 1181 1182Released 2010-04-16 1183 1184- First public preview release. 1185