diff --git a/CHANGES.rst b/CHANGES.rst index eaa5d262..cfb00714 100644 --- a/CHANGES.rst +++ b/CHANGES.rst @@ -7,81 +7,91 @@ Unreleased - Bump minimum Werkzeug version to >= 0.15. - Drop support for Python 3.4. -- Error handlers for ``InternalServerError`` or ``500`` will always be - passed an instance of ``InternalServerError``. If they are invoked +- Error handlers for ÁÁInternalServerErrorÁÁ or ÁÁ500ÁÁ will always be + passed an instance of ÁÁInternalServerErrorÁÁ. If they are invoked due to an unhandled exception, that original exception is now - available as ``e.original_exception`` rather than being passed + available as ÁÁe.original_exceptionÁÁ rather than being passed directly to the handler. The same is true if the handler is for the - base ``HTTPException``. This makes error handler behavior more - consistent. :pr:`3266` + base ÁÁHTTPExceptionÁÁ. This makes error handler behavior more + consistent. :pr:Á3266Á - - :meth:`Flask.finalize_request` is called for all unhandled - exceptions even if there is no ``500`` error handler. + - :meth:ÁFlask.finalize_requestÁ is called for all unhandled + exceptions even if there is no ÁÁ500ÁÁ error handler. -- :meth:`flask.RequestContext.copy` includes the current session - object in the request context copy. This prevents ``session`` - pointing to an out-of-date object. :issue:`2935` +- :meth:Áflask.RequestContext.copyÁ includes the current session + object in the request context copy. This prevents ÁÁsessionÁÁ + pointing to an out-of-date object. :issue:Á2935Á - Using built-in RequestContext, unprintable Unicode characters in Host header will result in a HTTP 400 response and not HTTP 500 as - previously. :pr:`2994` -- :func:`send_file` supports :class:`~os.PathLike` objects as - described in PEP 0519, to support :mod:`pathlib` in Python 3. - :pr:`3059` -- :func:`send_file` supports :class:`~io.BytesIO` partial content. - :issue:`2957` -- :func:`open_resource` accepts the "rt" file mode. This still does - the same thing as "r". :issue:`3163` -- The :attr:`MethodView.methods` attribute set in a base class is used - by subclasses. :issue:`3138` -- :attr:`Flask.jinja_options` is a ``dict`` instead of an - ``ImmutableDict`` to allow easier configuration. Changes must still - be made before creating the environment. :pr:`3190` -- Flask's ``JSONMixin`` for the request and response wrappers was - moved into Werkzeug. Use Werkzeug's version with Flask-specific + previously. :pr:Á2994Á +- :func:Ásend_fileÁ supports :class:Á~os.PathLikeÁ objects as + described in PEP 0519, to support :mod:ÁpathlibÁ in Python 3. + :pr:Á3059Á +- :func:Ásend_fileÁ supports :class:Á~io.BytesIOÁ partial content. + :issue:Á2957Á +- :func:Áopen_resourceÁ accepts the "rt" file mode. This still does + the same thing as "r". :issue:Á3163Á +- The :attr:ÁMethodView.methodsÁ attribute set in a base class is used + by subclasses. :issue:Á3138Á +- :attr:ÁFlask.jinja_optionsÁ is a ÁÁdictÁÁ instead of an + ÁÁImmutableDictÁÁ to allow easier configuration. Changes must still + be made before creating the environment. :pr:Á3190Á +- Flask©s ÁÁJSONMixinÁÁ for the request and response wrappers was + moved into Werkzeug. Use Werkzeug©s version with Flask-specific support. This bumps the Werkzeug dependency to >= 0.15. - :issue:`3125` -- The ``flask`` command entry point is simplified to take advantage - of Werkzeug 0.15's better reloader support. This bumps the Werkzeug - dependency to >= 0.15. :issue:`3022` -- Support ``static_url_path`` that ends with a forward slash. - :issue:`3134` -- Support empty ``static_folder`` without requiring setting an empty - ``static_url_path`` as well. :pr:`3124` -- :meth:`jsonify` supports :class:`dataclasses.dataclass` objects. - :pr:`3195` -- Allow customizing the :attr:`Flask.url_map_class` used for routing. - :pr:`3069` + :issue:Á3125Á +- The ÁÁflaskÁÁ command entry point is simplified to take advantage + of Werkzeug 0.15©s better reloader support. This bumps the Werkzeug + dependency to >= 0.15. :issue:Á3022Á +- Support ÁÁstatic_url_pathÁÁ that ends with a forward slash. + :issue:Á3134Á +- Support empty ÁÁstatic_folderÁÁ without requiring setting an empty + ÁÁstatic_url_pathÁÁ as well. :pr:Á3124Á +- :meth:ÁjsonifyÁ supports :class:Ádataclasses.dataclassÁ objects. + :pr:Á3195Á +- Allow customizing the :attr:ÁFlask.url_map_classÁ used for routing. + :pr:Á3069Á - The development server port can be set to 0, which tells the OS to - pick an available port. :issue:`2926` -- The return value from :meth:`cli.load_dotenv` is more consistent - with the documentation. It will return ``False`` if python-dotenv is - not installed, or if the given path isn't a file. :issue:`2937` -- Signaling support has a stub for the ``connect_via`` method when - the Blinker library is not installed. :pr:`3208` -- Add an ``--extra-files`` option to the ``flask run`` CLI command to + pick an available port. :issue:Á2926Á +- The return value from :meth:Ácli.load_dotenvÁ is more consistent + with the documentation. It will return ÁÁFalseÁÁ if python-dotenv is + not installed, or if the given path isn©t a file. :issue:Á2937Á +- Signaling support has a stub for the ÁÁconnect_viaÁÁ method when + the Blinker library is not installed. :pr:Á3208Á +- Add an ÁÁ--extra-filesÁÁ option to the ÁÁflask runÁÁ CLI command to specify extra files that will trigger the reloader on change. - :issue:`2897` + :issue:Á2897Á - Allow returning a dictionary from a view function. Similar to how - returning a string will produce a ``text/html`` response, returning - a dict will call ``jsonify`` to produce a ``application/json`` - response. :pr:`3111` -- Blueprints have a ``cli`` Click group like ``app.cli``. CLI commands + returning a string will produce a ÁÁtext/htmlÁÁ response, returning + a dict will call ÁÁjsonifyÁÁ to produce a ÁÁapplication/jsonÁÁ + response. :pr:Á3111Á +- Blueprints have a ÁÁcliÁÁ Click group like ÁÁapp.cliÁÁ. CLI commands registered with a blueprint will be available as a group under the - ``flask`` command. :issue:`1357`. -- When using the test client as a context manager (``with client:``), + ÁÁflaskÁÁ command. :issue:Á1357Á. +- When using the test client as a context manager (ÁÁwith client:ÁÁ), all preserved request contexts are popped when the block exits, - ensuring nested contexts are cleaned up correctly. :pr:`3157` + ensuring nested contexts are cleaned up correctly. :pr:Á3157Á - Show a better error message when the view return type is not - supported. :issue:`3214` -- ``flask.testing.make_test_environ_builder()`` has been deprecated in - favour of a new class ``flask.testing.EnvironBuilder``. :pr:`3232` -- The ``flask run`` command no longer fails if Python is not built - with SSL support. Using the ``--cert`` option will show an - appropriate error message. :issue:`3211` + supported. :issue:Á3214Á +- ÁÁflask.testing.make_test_environ_builder()ÁÁ has been deprecated in + favour of a new class ÁÁflask.testing.EnvironBuilderÁÁ. :pr:Á3232Á +- The ÁÁflask runÁÁ command no longer fails if Python is not built + with SSL support. Using the ÁÁ--certÁÁ option will show an + appropriate error message. :issue:Á3211Á - URL matching now occurs after the request context is pushed, rather - than when it's created. This allows custom URL converters to access + than when it©s created. This allows custom URL converters to access the app and request contexts, such as to query a database for an id. - :issue:`3088` + :issue:Á3088Á + + +Version 1.0.4 +------------- + +Unreleased + +- The key information for ÁÁBadRequestKeyErrorÁÁ is no longer cleared + outside debug mode, so error handlers can still access it. This + requires upgrading to Werkzeug 0.15.5. :issue:Á3249Á Version 1.0.3 @@ -89,22 +99,22 @@ Version 1.0.3 Released 2019-05-17 -- :func:`send_file` encodes filenames as ASCII instead of Latin-1 +- :func:Ásend_fileÁ encodes filenames as ASCII instead of Latin-1 (ISO-8859-1). This fixes compatibility with Gunicorn, which is - stricter about header encodings than PEP 3333. :issue:`2766` -- Allow custom CLIs using ``FlaskGroup`` to set the debug flag without + stricter about header encodings than PEP 3333. :issue:Á2766Á +- Allow custom CLIs using ÁÁFlaskGroupÁÁ to set the debug flag without it always being overwritten based on environment variables. - :pr:`2765` -- ``flask --version`` outputs Werkzeug's version and simplifies the - Python version. :pr:`2825` -- :func:`send_file` handles an ``attachment_filename`` that is a - native Python 2 string (bytes) with UTF-8 coded bytes. :issue:`2933` -- A catch-all error handler registered for ``HTTPException`` will not - handle ``RoutingException``, which is used internally during + :pr:Á2765Á +- ÁÁflask --versionÁÁ outputs Werkzeug©s version and simplifies the + Python version. :pr:Á2825Á +- :func:Ásend_fileÁ handles an ÁÁattachment_filenameÁÁ that is a + native Python 2 string (bytes) with UTF-8 coded bytes. :issue:Á2933Á +- A catch-all error handler registered for ÁÁHTTPExceptionÁÁ will not + handle ÁÁRoutingExceptionÁÁ, which is used internally during routing. This fixes the unexpected behavior that had been introduced - in 1.0. :pr:`2986` -- Passing the ``json`` argument to ``app.test_client`` does not - push/pop an extra app context. :issue:`2900` + in 1.0. :pr:Á2986Á +- Passing the ÁÁjsonÁÁ argument to ÁÁapp.test_clientÁÁ does not + push/pop an extra app context. :issue:Á2900Á Version 1.0.2 @@ -113,9 +123,9 @@ Version 1.0.2 Released 2018-05-02 - Fix more backwards compatibility issues with merging slashes between - a blueprint prefix and route. :pr:`2748` -- Fix error with ``flask routes`` command when there are no routes. - :issue:`2751` + a blueprint prefix and route. :pr:Á2748Á +- Fix error with ÁÁflask routesÁÁ command when there are no routes. + :issue:Á2751Á Version 1.0.1 @@ -123,18 +133,18 @@ Version 1.0.1 Released 2018-04-29 -- Fix registering partials (with no ``__name__``) as view functions. - :pr:`2730` -- Don't treat lists returned from view functions the same as tuples. - Only tuples are interpreted as response data. :issue:`2736` -- Extra slashes between a blueprint's ``url_prefix`` and a route URL +- Fix registering partials (with no ÁÁ__name__ÁÁ) as view functions. + :pr:Á2730Á +- Don©t treat lists returned from view functions the same as tuples. + Only tuples are interpreted as response data. :issue:Á2736Á +- Extra slashes between a blueprint©s ÁÁurl_prefixÁÁ and a route URL are merged. This fixes some backwards compatibility issues with the - change in 1.0. :issue:`2731`, :issue:`2742` -- Only trap ``BadRequestKeyError`` errors in debug mode, not all - ``BadRequest`` errors. This allows ``abort(400)`` to continue - working as expected. :issue:`2735` -- The ``FLASK_SKIP_DOTENV`` environment variable can be set to ``1`` - to skip automatically loading dotenv files. :issue:`2722` + change in 1.0. :issue:Á2731Á, :issue:Á2742Á +- Only trap ÁÁBadRequestKeyErrorÁÁ errors in debug mode, not all + ÁÁBadRequestÁÁ errors. This allows ÁÁabort(400)ÁÁ to continue + working as expected. :issue:Á2735Á +- The ÁÁFLASK_SKIP_DOTENVÁÁ environment variable can be set to ÁÁ1ÁÁ + to skip automatically loading dotenv files. :issue:Á2722Á Version 1.0 @@ -145,157 +155,157 @@ Released 2018-04-26 - Python 2.6 and 3.3 are no longer supported. - Bump minimum dependency versions to the latest stable versions: Werkzeug >= 0.14, Jinja >= 2.10, itsdangerous >= 0.24, Click >= 5.1. - :issue:`2586` -- Skip :meth:`app.run ` when a Flask application is run + :issue:Á2586Á +- Skip :meth:Áapp.run Á when a Flask application is run from the command line. This avoids some behavior that was confusing to debug. -- Change the default for :data:`JSONIFY_PRETTYPRINT_REGULAR` to - ``False``. :func:`~json.jsonify` returns a compact format by - default, and an indented format in debug mode. :pr:`2193` -- :meth:`Flask.__init__ ` accepts the ``host_matching`` - argument and sets it on :attr:`~Flask.url_map`. :issue:`1559` -- :meth:`Flask.__init__ ` accepts the ``static_host`` argument - and passes it as the ``host`` argument when defining the static - route. :issue:`1559` -- :func:`send_file` supports Unicode in ``attachment_filename``. - :pr:`2223` -- Pass ``_scheme`` argument from :func:`url_for` to - :meth:`~Flask.handle_url_build_error`. :pr:`2017` -- :meth:`~Flask.add_url_rule` accepts the - ``provide_automatic_options`` argument to disable adding the - ``OPTIONS`` method. :pr:`1489` -- :class:`~views.MethodView` subclasses inherit method handlers from - base classes. :pr:`1936` +- Change the default for :data:ÁJSONIFY_PRETTYPRINT_REGULARÁ to + ÁÁFalseÁÁ. :func:Á~json.jsonifyÁ returns a compact format by + default, and an indented format in debug mode. :pr:Á2193Á +- :meth:ÁFlask.__init__ Á accepts the ÁÁhost_matchingÁÁ + argument and sets it on :attr:Á~Flask.url_mapÁ. :issue:Á1559Á +- :meth:ÁFlask.__init__ Á accepts the ÁÁstatic_hostÁÁ argument + and passes it as the ÁÁhostÁÁ argument when defining the static + route. :issue:Á1559Á +- :func:Ásend_fileÁ supports Unicode in ÁÁattachment_filenameÁÁ. + :pr:Á2223Á +- Pass ÁÁ_schemeÁÁ argument from :func:Áurl_forÁ to + :meth:Á~Flask.handle_url_build_errorÁ. :pr:Á2017Á +- :meth:Á~Flask.add_url_ruleÁ accepts the + ÁÁprovide_automatic_optionsÁÁ argument to disable adding the + ÁÁOPTIONSÁÁ method. :pr:Á1489Á +- :class:Á~views.MethodViewÁ subclasses inherit method handlers from + base classes. :pr:Á1936Á - Errors caused while opening the session at the beginning of the - request are handled by the app's error handlers. :pr:`2254` -- Blueprints gained :attr:`~Blueprint.json_encoder` and - :attr:`~Blueprint.json_decoder` attributes to override the app's - encoder and decoder. :pr:`1898` -- :meth:`Flask.make_response` raises ``TypeError`` instead of - ``ValueError`` for bad response types. The error messages have been - improved to describe why the type is invalid. :pr:`2256` -- Add ``routes`` CLI command to output routes registered on the - application. :pr:`2259` + request are handled by the app©s error handlers. :pr:Á2254Á +- Blueprints gained :attr:Á~Blueprint.json_encoderÁ and + :attr:Á~Blueprint.json_decoderÁ attributes to override the app©s + encoder and decoder. :pr:Á1898Á +- :meth:ÁFlask.make_responseÁ raises ÁÁTypeErrorÁÁ instead of + ÁÁValueErrorÁÁ for bad response types. The error messages have been + improved to describe why the type is invalid. :pr:Á2256Á +- Add ÁÁroutesÁÁ CLI command to output routes registered on the + application. :pr:Á2259Á - Show warning when session cookie domain is a bare hostname or an IP address, as these may not behave properly in some browsers, such as - Chrome. :pr:`2282` -- Allow IP address as exact session cookie domain. :pr:`2282` -- ``SESSION_COOKIE_DOMAIN`` is set if it is detected through - ``SERVER_NAME``. :pr:`2282` -- Auto-detect zero-argument app factory called ``create_app`` or - ``make_app`` from ``FLASK_APP``. :pr:`2297` -- Factory functions are not required to take a ``script_info`` - parameter to work with the ``flask`` command. If they take a single - parameter or a parameter named ``script_info``, the - :class:`~cli.ScriptInfo` object will be passed. :pr:`2319` -- ``FLASK_APP`` can be set to an app factory, with arguments if - needed, for example ``FLASK_APP=myproject.app:create_app('dev')``. - :pr:`2326` -- ``FLASK_APP`` can point to local packages that are not installed in - editable mode, although ``pip install -e`` is still preferred. - :pr:`2414` -- The :class:`~views.View` class attribute - :attr:`~views.View.provide_automatic_options` is set in - :meth:`~views.View.as_view`, to be detected by - :meth:`~Flask.add_url_rule`. :pr:`2316` -- Error handling will try handlers registered for ``blueprint, code``, - ``app, code``, ``blueprint, exception``, ``app, exception``. - :pr:`2314` -- ``Cookie`` is added to the response's ``Vary`` header if the session - is accessed at all during the request (and not deleted). :pr:`2288` -- :meth:`~Flask.test_request_context` accepts ``subdomain`` and - ``url_scheme`` arguments for use when building the base URL. - :pr:`1621` -- Set :data:`APPLICATION_ROOT` to ``'/'`` by default. This was already - the implicit default when it was set to ``None``. -- :data:`TRAP_BAD_REQUEST_ERRORS` is enabled by default in debug mode. - ``BadRequestKeyError`` has a message with the bad key in debug mode - instead of the generic bad request message. :pr:`2348` + Chrome. :pr:Á2282Á +- Allow IP address as exact session cookie domain. :pr:Á2282Á +- ÁÁSESSION_COOKIE_DOMAINÁÁ is set if it is detected through + ÁÁSERVER_NAMEÁÁ. :pr:Á2282Á +- Auto-detect zero-argument app factory called ÁÁcreate_appÁÁ or + ÁÁmake_appÁÁ from ÁÁFLASK_APPÁÁ. :pr:Á2297Á +- Factory functions are not required to take a ÁÁscript_infoÁÁ + parameter to work with the ÁÁflaskÁÁ command. If they take a single + parameter or a parameter named ÁÁscript_infoÁÁ, the + :class:Á~cli.ScriptInfoÁ object will be passed. :pr:Á2319Á +- ÁÁFLASK_APPÁÁ can be set to an app factory, with arguments if + needed, for example ÁÁFLASK_APP=myproject.app:create_app(©dev©)ÁÁ. + :pr:Á2326Á +- ÁÁFLASK_APPÁÁ can point to local packages that are not installed in + editable mode, although ÁÁpip install -eÁÁ is still preferred. + :pr:Á2414Á +- The :class:Á~views.ViewÁ class attribute + :attr:Á~views.View.provide_automatic_optionsÁ is set in + :meth:Á~views.View.as_viewÁ, to be detected by + :meth:Á~Flask.add_url_ruleÁ. :pr:Á2316Á +- Error handling will try handlers registered for ÁÁblueprint, codeÁÁ, + ÁÁapp, codeÁÁ, ÁÁblueprint, exceptionÁÁ, ÁÁapp, exceptionÁÁ. + :pr:Á2314Á +- ÁÁCookieÁÁ is added to the response©s ÁÁVaryÁÁ header if the session + is accessed at all during the request (and not deleted). :pr:Á2288Á +- :meth:Á~Flask.test_request_contextÁ accepts ÁÁsubdomainÁÁ and + ÁÁurl_schemeÁÁ arguments for use when building the base URL. + :pr:Á1621Á +- Set :data:ÁAPPLICATION_ROOTÁ to ÁÁ©/©ÁÁ by default. This was already + the implicit default when it was set to ÁÁNoneÁÁ. +- :data:ÁTRAP_BAD_REQUEST_ERRORSÁ is enabled by default in debug mode. + ÁÁBadRequestKeyErrorÁÁ has a message with the bad key in debug mode + instead of the generic bad request message. :pr:Á2348Á - Allow registering new tags with - :class:`~json.tag.TaggedJSONSerializer` to support storing other - types in the session cookie. :pr:`2352` + :class:Á~json.tag.TaggedJSONSerializerÁ to support storing other + types in the session cookie. :pr:Á2352Á - Only open the session if the request has not been pushed onto the - context stack yet. This allows :func:`~stream_with_context` + context stack yet. This allows :func:Á~stream_with_contextÁ generators to access the same session that the containing view uses. - :pr:`2354` -- Add ``json`` keyword argument for the test client request methods. + :pr:Á2354Á +- Add ÁÁjsonÁÁ keyword argument for the test client request methods. This will dump the given object as JSON and set the appropriate - content type. :pr:`2358` + content type. :pr:Á2358Á - Extract JSON handling to a mixin applied to both the - :class:`Request` and :class:`Response` classes. This adds the - :meth:`~Response.is_json` and :meth:`~Response.get_json` methods to - the response to make testing JSON response much easier. :pr:`2358` + :class:ÁRequestÁ and :class:ÁResponseÁ classes. This adds the + :meth:Á~Response.is_jsonÁ and :meth:Á~Response.get_jsonÁ methods to + the response to make testing JSON response much easier. :pr:Á2358Á - Removed error handler caching because it caused unexpected results for some exception inheritance hierarchies. Register handlers explicitly for each exception if you want to avoid traversing the - MRO. :pr:`2362` -- Fix incorrect JSON encoding of aware, non-UTC datetimes. :pr:`2374` + MRO. :pr:Á2362Á +- Fix incorrect JSON encoding of aware, non-UTC datetimes. :pr:Á2374Á - Template auto reloading will honor debug mode even even if - :attr:`~Flask.jinja_env` was already accessed. :pr:`2373` -- The following old deprecated code was removed. :issue:`2385` + :attr:Á~Flask.jinja_envÁ was already accessed. :pr:Á2373Á +- The following old deprecated code was removed. :issue:Á2385Á - - ``flask.ext`` - import extensions directly by their name instead - of through the ``flask.ext`` namespace. For example, - ``import flask.ext.sqlalchemy`` becomes - ``import flask_sqlalchemy``. - - ``Flask.init_jinja_globals`` - extend - :meth:`Flask.create_jinja_environment` instead. - - ``Flask.error_handlers`` - tracked by - :attr:`Flask.error_handler_spec`, use :meth:`Flask.errorhandler` + - ÁÁflask.extÁÁ - import extensions directly by their name instead + of through the ÁÁflask.extÁÁ namespace. For example, + ÁÁimport flask.ext.sqlalchemyÁÁ becomes + ÁÁimport flask_sqlalchemyÁÁ. + - ÁÁFlask.init_jinja_globalsÁÁ - extend + :meth:ÁFlask.create_jinja_environmentÁ instead. + - ÁÁFlask.error_handlersÁÁ - tracked by + :attr:ÁFlask.error_handler_specÁ, use :meth:ÁFlask.errorhandlerÁ to register handlers. - - ``Flask.request_globals_class`` - use - :attr:`Flask.app_ctx_globals_class` instead. - - ``Flask.static_path`` - use :attr:`Flask.static_url_path` + - ÁÁFlask.request_globals_classÁÁ - use + :attr:ÁFlask.app_ctx_globals_classÁ instead. + - ÁÁFlask.static_pathÁÁ - use :attr:ÁFlask.static_url_pathÁ instead. - - ``Request.module`` - use :attr:`Request.blueprint` instead. + - ÁÁRequest.moduleÁÁ - use :attr:ÁRequest.blueprintÁ instead. -- The :attr:`Request.json` property is no longer deprecated. - :issue:`1421` -- Support passing a :class:`~werkzeug.test.EnvironBuilder` or ``dict`` - to :meth:`test_client.open `. :pr:`2412` -- The ``flask`` command and :meth:`Flask.run` will load environment - variables from ``.env`` and ``.flaskenv`` files if python-dotenv is - installed. :pr:`2416` +- The :attr:ÁRequest.jsonÁ property is no longer deprecated. + :issue:Á1421Á +- Support passing a :class:Á~werkzeug.test.EnvironBuilderÁ or ÁÁdictÁÁ + to :meth:Átest_client.open Á. :pr:Á2412Á +- The ÁÁflaskÁÁ command and :meth:ÁFlask.runÁ will load environment + variables from ÁÁ.envÁÁ and ÁÁ.flaskenvÁÁ files if python-dotenv is + installed. :pr:Á2416Á - When passing a full URL to the test client, the scheme in the URL is - used instead of :data:`PREFERRED_URL_SCHEME`. :pr:`2430` -- :attr:`Flask.logger` has been simplified. ``LOGGER_NAME`` and - ``LOGGER_HANDLER_POLICY`` config was removed. The logger is always - named ``flask.app``. The level is only set on first access, it - doesn't check :attr:`Flask.debug` each time. Only one format is - used, not different ones depending on :attr:`Flask.debug`. No + used instead of :data:ÁPREFERRED_URL_SCHEMEÁ. :pr:Á2430Á +- :attr:ÁFlask.loggerÁ has been simplified. ÁÁLOGGER_NAMEÁÁ and + ÁÁLOGGER_HANDLER_POLICYÁÁ config was removed. The logger is always + named ÁÁflask.appÁÁ. The level is only set on first access, it + doesn©t check :attr:ÁFlask.debugÁ each time. Only one format is + used, not different ones depending on :attr:ÁFlask.debugÁ. No handlers are removed, and a handler is only added if no handlers are - already configured. :pr:`2436` -- Blueprint view function names may not contain dots. :pr:`2450` -- Fix a ``ValueError`` caused by invalid ``Range`` requests in some - cases. :issue:`2526` -- The development server uses threads by default. :pr:`2529` -- Loading config files with ``silent=True`` will ignore - :data:`~errno.ENOTDIR` errors. :pr:`2581` -- Pass ``--cert`` and ``--key`` options to ``flask run`` to run the - development server over HTTPS. :pr:`2606` -- Added :data:`SESSION_COOKIE_SAMESITE` to control the ``SameSite`` - attribute on the session cookie. :pr:`2607` -- Added :meth:`~flask.Flask.test_cli_runner` to create a Click runner - that can invoke Flask CLI commands for testing. :pr:`2636` + already configured. :pr:Á2436Á +- Blueprint view function names may not contain dots. :pr:Á2450Á +- Fix a ÁÁValueErrorÁÁ caused by invalid ÁÁRangeÁÁ requests in some + cases. :issue:Á2526Á +- The development server uses threads by default. :pr:Á2529Á +- Loading config files with ÁÁsilent=TrueÁÁ will ignore + :data:Á~errno.ENOTDIRÁ errors. :pr:Á2581Á +- Pass ÁÁ--certÁÁ and ÁÁ--keyÁÁ options to ÁÁflask runÁÁ to run the + development server over HTTPS. :pr:Á2606Á +- Added :data:ÁSESSION_COOKIE_SAMESITEÁ to control the ÁÁSameSiteÁÁ + attribute on the session cookie. :pr:Á2607Á +- Added :meth:Á~flask.Flask.test_cli_runnerÁ to create a Click runner + that can invoke Flask CLI commands for testing. :pr:Á2636Á - Subdomain matching is disabled by default and setting - :data:`SERVER_NAME` does not implicitly enable it. It can be enabled - by passing ``subdomain_matching=True`` to the ``Flask`` constructor. - :pr:`2635` + :data:ÁSERVER_NAMEÁ does not implicitly enable it. It can be enabled + by passing ÁÁsubdomain_matching=TrueÁÁ to the ÁÁFlaskÁÁ constructor. + :pr:Á2635Á - A single trailing slash is stripped from the blueprint - ``url_prefix`` when it is registered with the app. :pr:`2629` -- :meth:`Request.get_json` doesn't cache the result if parsing fails - when ``silent`` is true. :issue:`2651` -- :func:`Request.get_json` no longer accepts arbitrary encodings. - Incoming JSON should be encoded using UTF-8 per :rfc:`8259`, but - Flask will autodetect UTF-8, -16, or -32. :pr:`2691` -- Added :data:`MAX_COOKIE_SIZE` and :attr:`Response.max_cookie_size` + ÁÁurl_prefixÁÁ when it is registered with the app. :pr:Á2629Á +- :meth:ÁRequest.get_jsonÁ doesn©t cache the result if parsing fails + when ÁÁsilentÁÁ is true. :issue:Á2651Á +- :func:ÁRequest.get_jsonÁ no longer accepts arbitrary encodings. + Incoming JSON should be encoded using UTF-8 per :rfc:Á8259Á, but + Flask will autodetect UTF-8, -16, or -32. :pr:Á2691Á +- Added :data:ÁMAX_COOKIE_SIZEÁ and :attr:ÁResponse.max_cookie_sizeÁ to control when Werkzeug warns about large cookies that browsers may - ignore. :pr:`2693` + ignore. :pr:Á2693Á - Updated documentation theme to make docs look better in small - windows. :pr:`2709` + windows. :pr:Á2709Á - Rewrote the tutorial docs and example project to take a more structured approach to help new users avoid common pitfalls. - :pr:`2676` + :pr:Á2676Á Version 0.12.4 @@ -303,7 +313,7 @@ Version 0.12.4 Released 2018-04-29 -- Repackage 0.12.3 to fix package layout issue. :issue:`2728` +- Repackage 0.12.3 to fix package layout issue. :issue:Á2728Á Version 0.12.3 @@ -311,12 +321,12 @@ Version 0.12.3 Released 2018-04-26 -- :func:`Request.get_json` no longer accepts arbitrary encodings. - Incoming JSON should be encoded using UTF-8 per :rfc:`8259`, but - Flask will autodetect UTF-8, -16, or -32. :issue:`2692` -- Fix a Python warning about imports when using ``python -m flask``. - :issue:`2666` -- Fix a ``ValueError`` caused by invalid ``Range`` requests in some +- :func:ÁRequest.get_jsonÁ no longer accepts arbitrary encodings. + Incoming JSON should be encoded using UTF-8 per :rfc:Á8259Á, but + Flask will autodetect UTF-8, -16, or -32. :issue:Á2692Á +- Fix a Python warning about imports when using ÁÁpython -m flaskÁÁ. + :issue:Á2666Á +- Fix a ÁÁValueErrorÁÁ caused by invalid ÁÁRangeÁÁ requests in some cases. @@ -325,7 +335,7 @@ Version 0.12.2 Released 2017-05-16 -- Fix a bug in ``safe_join`` on Windows. +- Fix a bug in ÁÁsafe_joinÁÁ on Windows. Version 0.12.1 @@ -333,14 +343,14 @@ Version 0.12.1 Released 2017-03-31 -- Prevent ``flask run`` from showing a ``NoAppException`` when an - ``ImportError`` occurs within the imported application module. -- Fix encoding behavior of ``app.config.from_pyfile`` for Python 3. - :issue:`2118` -- Use the ``SERVER_NAME`` config if it is present as default values - for ``app.run``. :issue:`2109`, :pr:`2152` -- Call ``ctx.auto_pop`` with the exception object instead of ``None``, - in the event that a ``BaseException`` such as ``KeyboardInterrupt`` +- Prevent ÁÁflask runÁÁ from showing a ÁÁNoAppExceptionÁÁ when an + ÁÁImportErrorÁÁ occurs within the imported application module. +- Fix encoding behavior of ÁÁapp.config.from_pyfileÁÁ for Python 3. + :issue:Á2118Á +- Use the ÁÁSERVER_NAMEÁÁ config if it is present as default values + for ÁÁapp.runÁÁ. :issue:Á2109Á, :pr:Á2152Á +- Call ÁÁctx.auto_popÁÁ with the exception object instead of ÁÁNoneÁÁ, + in the event that a ÁÁBaseExceptionÁÁ such as ÁÁKeyboardInterruptÁÁ is raised in a request handler. @@ -349,22 +359,22 @@ Version 0.12 Released 2016-12-21, codename Punsch -- The cli command now responds to ``--version``. +- The cli command now responds to ÁÁ--versionÁÁ. - Mimetype guessing and ETag generation for file-like objects in - ``send_file`` has been removed. :issue:`104`, :pr`1849` -- Mimetype guessing in ``send_file`` now fails loudly and doesn't fall - back to ``application/octet-stream``. :pr:`1988` -- Make ``flask.safe_join`` able to join multiple paths like - ``os.path.join`` :pr:`1730` + ÁÁsend_fileÁÁ has been removed. :issue:Á104Á, :prÁ1849Á +- Mimetype guessing in ÁÁsend_fileÁÁ now fails loudly and doesn©t fall + back to ÁÁapplication/octet-streamÁÁ. :pr:Á1988Á +- Make ÁÁflask.safe_joinÁÁ able to join multiple paths like + ÁÁos.path.joinÁÁ :pr:Á1730Á - Revert a behavior change that made the dev server crash instead of - returning an Internal Server Error. :pr:`2006` + returning an Internal Server Error. :pr:Á2006Á - Correctly invoke response handlers for both regular request dispatching as well as error handlers. - Disable logger propagation by default for the app logger. -- Add support for range requests in ``send_file``. -- ``app.test_client`` includes preset default environment, which can - now be directly set, instead of per ``client.get``. -- Fix crash when running under PyPy3. :pr:`1814` +- Add support for range requests in ÁÁsend_fileÁÁ. +- ÁÁapp.test_clientÁÁ includes preset default environment, which can + now be directly set, instead of per ÁÁclient.getÁÁ. +- Fix crash when running under PyPy3. :pr:Á1814Á Version 0.11.1 @@ -372,8 +382,8 @@ Version 0.11.1 Released 2016-06-07 -- Fixed a bug that prevented ``FLASK_APP=foobar/__init__.py`` from - working. :pr:`1872` +- Fixed a bug that prevented ÁÁFLASK_APP=foobar/__init__.pyÁÁ from + working. :pr:Á1872Á Version 0.11 @@ -382,98 +392,98 @@ Version 0.11 Released 2016-05-29, codename Absinthe - Added support to serializing top-level arrays to - :func:`flask.jsonify`. This introduces a security risk in ancient - browsers. See :ref:`json-security` for details. + :func:Áflask.jsonifyÁ. This introduces a security risk in ancient + browsers. See :ref:Ájson-securityÁ for details. - Added before_render_template signal. -- Added ``**kwargs`` to :meth:`flask.Test.test_client` to support +- Added ÁÁ**kwargsÁÁ to :meth:Áflask.Test.test_clientÁ to support passing additional keyword arguments to the constructor of - :attr:`flask.Flask.test_client_class`. -- Added ``SESSION_REFRESH_EACH_REQUEST`` config key that controls the - set-cookie behavior. If set to ``True`` a permanent session will be + :attr:Áflask.Flask.test_client_classÁ. +- Added ÁÁSESSION_REFRESH_EACH_REQUESTÁÁ config key that controls the + set-cookie behavior. If set to ÁÁTrueÁÁ a permanent session will be refreshed each request and get their lifetime extended, if set to - ``False`` it will only be modified if the session actually modifies. + ÁÁFalseÁÁ it will only be modified if the session actually modifies. Non permanent sessions are not affected by this and will always expire if the browser window closes. - Made Flask support custom JSON mimetypes for incoming data. -- Added support for returning tuples in the form ``(response, - headers)`` from a view function. -- Added :meth:`flask.Config.from_json`. -- Added :attr:`flask.Flask.config_class`. -- Added :meth:`flask.Config.get_namespace`. +- Added support for returning tuples in the form ÁÁ(response, + headers)ÁÁ from a view function. +- Added :meth:Áflask.Config.from_jsonÁ. +- Added :attr:Áflask.Flask.config_classÁ. +- Added :meth:Áflask.Config.get_namespaceÁ. - Templates are no longer automatically reloaded outside of debug - mode. This can be configured with the new ``TEMPLATES_AUTO_RELOAD`` + mode. This can be configured with the new ÁÁTEMPLATES_AUTO_RELOADÁÁ config key. -- Added a workaround for a limitation in Python 3.3's namespace +- Added a workaround for a limitation in Python 3.3©s namespace loader. -- Added support for explicit root paths when using Python 3.3's +- Added support for explicit root paths when using Python 3.3©s namespace packages. -- Added :command:`flask` and the ``flask.cli`` module to start the +- Added :command:ÁflaskÁ and the ÁÁflask.cliÁÁ module to start the local debug server through the click CLI system. This is recommended - over the old ``flask.run()`` method as it works faster and more + over the old ÁÁflask.run()ÁÁ method as it works faster and more reliable due to a different design and also replaces - ``Flask-Script``. + ÁÁFlask-ScriptÁÁ. - Error handlers that match specific classes are now checked first, thereby allowing catching exceptions that are subclasses of HTTP - exceptions (in ``werkzeug.exceptions``). This makes it possible for + exceptions (in ÁÁwerkzeug.exceptionsÁÁ). This makes it possible for an extension author to create exceptions that will by default result in the HTTP error of their choosing, but may be caught with a custom error handler if desired. -- Added :meth:`flask.Config.from_mapping`. +- Added :meth:Áflask.Config.from_mappingÁ. - Flask will now log by default even if debug is disabled. The log format is now hardcoded but the default log handling can be disabled - through the ``LOGGER_HANDLER_POLICY`` configuration key. + through the ÁÁLOGGER_HANDLER_POLICYÁÁ configuration key. - Removed deprecated module functionality. -- Added the ``EXPLAIN_TEMPLATE_LOADING`` config flag which when +- Added the ÁÁEXPLAIN_TEMPLATE_LOADINGÁÁ config flag which when enabled will instruct Flask to explain how it locates templates. This should help users debug when the wrong templates are loaded. - Enforce blueprint handling in the order they were registered for template loading. - Ported test suite to py.test. -- Deprecated ``request.json`` in favour of ``request.get_json()``. +- Deprecated ÁÁrequest.jsonÁÁ in favour of ÁÁrequest.get_json()ÁÁ. - Add "pretty" and "compressed" separators definitions in jsonify() method. Reduces JSON response size when - ``JSONIFY_PRETTYPRINT_REGULAR=False`` by removing unnecessary white + ÁÁJSONIFY_PRETTYPRINT_REGULAR=FalseÁÁ by removing unnecessary white space included by default after separators. - JSON responses are now terminated with a newline character, because it is a convention that UNIX text files end with a newline and some - clients don't deal well when this newline is missing. This came up + clients don©t deal well when this newline is missing. This came up originally as a part of - https://github.com/postmanlabs/httpbin/issues/168. :pr:`1262` -- The automatically provided ``OPTIONS`` method is now correctly + https://github.com/postmanlabs/httpbin/issues/168. :pr:Á1262Á +- The automatically provided ÁÁOPTIONSÁÁ method is now correctly disabled if the user registered an overriding rule with the - lowercase-version ``options``. :issue:`1288` -- ``flask.json.jsonify`` now supports the ``datetime.date`` type. - :pr:`1326` -- Don't leak exception info of already caught exceptions to context - teardown handlers. :pr:`1393` -- Allow custom Jinja environment subclasses. :pr:`1422` + lowercase-version ÁÁoptionsÁÁ. :issue:Á1288Á +- ÁÁflask.json.jsonifyÁÁ now supports the ÁÁdatetime.dateÁÁ type. + :pr:Á1326Á +- Don©t leak exception info of already caught exceptions to context + teardown handlers. :pr:Á1393Á +- Allow custom Jinja environment subclasses. :pr:Á1422Á - Updated extension dev guidelines. -- ``flask.g`` now has ``pop()`` and ``setdefault`` methods. -- Turn on autoescape for ``flask.templating.render_template_string`` - by default. :pr:`1515` -- ``flask.ext`` is now deprecated. :pr:`1484` -- ``send_from_directory`` now raises BadRequest if the filename is - invalid on the server OS. :pr:`1763` -- Added the ``JSONIFY_MIMETYPE`` configuration variable. :pr:`1728` +- ÁÁflask.gÁÁ now has ÁÁpop()ÁÁ and ÁÁsetdefaultÁÁ methods. +- Turn on autoescape for ÁÁflask.templating.render_template_stringÁÁ + by default. :pr:Á1515Á +- ÁÁflask.extÁÁ is now deprecated. :pr:Á1484Á +- ÁÁsend_from_directoryÁÁ now raises BadRequest if the filename is + invalid on the server OS. :pr:Á1763Á +- Added the ÁÁJSONIFY_MIMETYPEÁÁ configuration variable. :pr:Á1728Á - Exceptions during teardown handling will no longer leave bad application contexts lingering around. -- Fixed broken ``test_appcontext_signals()`` test case. -- Raise an :exc:`AttributeError` in :func:`flask.helpers.find_package` +- Fixed broken ÁÁtest_appcontext_signals()ÁÁ test case. +- Raise an :exc:ÁAttributeErrorÁ in :func:Áflask.helpers.find_packageÁ with a useful message explaining why it is raised when a PEP 302 - import hook is used without an ``is_package()`` method. + import hook is used without an ÁÁis_package()ÁÁ method. - Fixed an issue causing exceptions raised before entering a request or app context to be passed to teardown handlers. - Fixed an issue with query parameters getting removed from requests in the test client when absolute URLs were requested. -- Made ``@before_first_request`` into a decorator as intended. +- Made ÁÁ@before_first_requestÁÁ into a decorator as intended. - Fixed an etags bug when sending a file streams with a name. -- Fixed ``send_from_directory`` not expanding to the application root +- Fixed ÁÁsend_from_directoryÁÁ not expanding to the application root path correctly. - Changed logic of before first request handlers to flip the flag after invoking. This will allow some uses that are potentially dangerous but should probably be permitted. - Fixed Python 3 bug when a handler from - ``app.url_build_error_handlers`` reraises the ``BuildError``. + ÁÁapp.url_build_error_handlersÁÁ reraises the ÁÁBuildErrorÁÁ. Version 0.10.1 @@ -481,8 +491,8 @@ Version 0.10.1 Released 2013-06-14 -- Fixed an issue where ``|tojson`` was not quoting single quotes which - made the filter not work properly in HTML attributes. Now it's +- Fixed an issue where ÁÁ|tojsonÁÁ was not quoting single quotes which + made the filter not work properly in HTML attributes. Now it©s possible to use that filter in single quoted attributes. This should make using that filter with angular.js easier. - Added support for byte strings back to the session system. This @@ -499,15 +509,15 @@ Released 2013-06-13, codename Limoncello - Changed default cookie serialization format from pickle to JSON to limit the impact an attacker can do if the secret key leaks. See - :ref:`upgrading-to-010` for more information. -- Added ``template_test`` methods in addition to the already existing - ``template_filter`` method family. -- Added ``template_global`` methods in addition to the already - existing ``template_filter`` method family. + :ref:Áupgrading-to-010Á for more information. +- Added ÁÁtemplate_testÁÁ methods in addition to the already existing + ÁÁtemplate_filterÁÁ method family. +- Added ÁÁtemplate_globalÁÁ methods in addition to the already + existing ÁÁtemplate_filterÁÁ method family. - Set the content-length header for x-sendfile. -- ``tojson`` filter now does not escape script blocks in HTML5 +- ÁÁtojsonÁÁ filter now does not escape script blocks in HTML5 parsers. -- ``tojson`` used in templates is now safe by default due. This was +- ÁÁtojsonÁÁ used in templates is now safe by default due. This was allowed due to the different escaping behavior. - Flask will now raise an error if you attempt to register a new function on an already used endpoint. @@ -515,41 +525,41 @@ Released 2013-06-13, codename Limoncello serialization of datetime objects. This allows much easier customization of how JSON is handled by Flask or any Flask extension. -- Removed deprecated internal ``flask.session`` module alias. Use - ``flask.sessions`` instead to get the session module. This is not to - be confused with ``flask.session`` the session proxy. +- Removed deprecated internal ÁÁflask.sessionÁÁ module alias. Use + ÁÁflask.sessionsÁÁ instead to get the session module. This is not to + be confused with ÁÁflask.sessionÁÁ the session proxy. - Templates can now be rendered without request context. The behavior - is slightly different as the ``request``, ``session`` and ``g`` - objects will not be available and blueprint's context processors are + is slightly different as the ÁÁrequestÁÁ, ÁÁsessionÁÁ and ÁÁgÁÁ + objects will not be available and blueprint©s context processors are not called. - The config object is now available to the template as a real global and not through a context processor which makes it available even in imported templates by default. - Added an option to generate non-ascii encoded JSON which should - result in less bytes being transmitted over the network. It's + result in less bytes being transmitted over the network. It©s disabled by default to not cause confusion with existing libraries - that might expect ``flask.json.dumps`` to return bytestrings by + that might expect ÁÁflask.json.dumpsÁÁ to return bytestrings by default. -- ``flask.g`` is now stored on the app context instead of the request +- ÁÁflask.gÁÁ is now stored on the app context instead of the request context. -- ``flask.g`` now gained a ``get()`` method for not erroring out on +- ÁÁflask.gÁÁ now gained a ÁÁget()ÁÁ method for not erroring out on non existing items. -- ``flask.g`` now can be used with the ``in`` operator to see what's +- ÁÁflask.gÁÁ now can be used with the ÁÁinÁÁ operator to see what©s defined and it now is iterable and will yield all attributes stored. -- ``flask.Flask.request_globals_class`` got renamed to - ``flask.Flask.app_ctx_globals_class`` which is a better name to what +- ÁÁflask.Flask.request_globals_classÁÁ got renamed to + ÁÁflask.Flask.app_ctx_globals_classÁÁ which is a better name to what it does since 0.10. -- ``request``, ``session`` and ``g`` are now also added as proxies to +- ÁÁrequestÁÁ, ÁÁsessionÁÁ and ÁÁgÁÁ are now also added as proxies to the template context which makes them available in imported templates. One has to be very careful with those though because usage outside of macros might cause caching. - Flask will no longer invoke the wrong error handlers if a proxy exception is passed through. -- Added a workaround for chrome's cookies in localhost not working as +- Added a workaround for chrome©s cookies in localhost not working as intended with domain names. - Changed logic for picking defaults for cookie values from sessions to work better with Google Chrome. -- Added ``message_flashed`` signal that simplifies flashing testing. +- Added ÁÁmessage_flashedÁÁ signal that simplifies flashing testing. - Added support for copying of request contexts for better working with greenlets. - Removed custom JSON HTTP exception subclasses. If you were relying @@ -563,14 +573,14 @@ Released 2013-06-13, codename Limoncello - Request context preservation in debug mode now keeps the exception information around which means that teardown handlers are able to distinguish error from success cases. -- Added the ``JSONIFY_PRETTYPRINT_REGULAR`` configuration variable. +- Added the ÁÁJSONIFY_PRETTYPRINT_REGULARÁÁ configuration variable. - Flask now orders JSON keys by default to not trash HTTP caches due to different hash seeds between different workers. -- Added ``appcontext_pushed`` and ``appcontext_popped`` signals. -- The builtin run method now takes the ``SERVER_NAME`` into account +- Added ÁÁappcontext_pushedÁÁ and ÁÁappcontext_poppedÁÁ signals. +- The builtin run method now takes the ÁÁSERVER_NAMEÁÁ into account when picking the default port to run on. -- Added ``flask.request.get_json()`` as a replacement for the old - ``flask.request.json`` property. +- Added ÁÁflask.request.get_json()ÁÁ as a replacement for the old + ÁÁflask.request.jsonÁÁ property. Version 0.9 @@ -578,77 +588,77 @@ Version 0.9 Released 2012-07-01, codename Campari -- The :func:`flask.Request.on_json_loading_failed` now returns a JSON +- The :func:Áflask.Request.on_json_loading_failedÁ now returns a JSON formatted response by default. -- The :func:`flask.url_for` function now can generate anchors to the +- The :func:Áflask.url_forÁ function now can generate anchors to the generated links. -- The :func:`flask.url_for` function now can also explicitly generate +- The :func:Áflask.url_forÁ function now can also explicitly generate URL rules specific to a given HTTP method. - Logger now only returns the debug log setting if it was not set explicitly. - Unregister a circular dependency between the WSGI environment and the request object when shutting down the request. This means that - environ ``werkzeug.request`` will be ``None`` after the response was + environ ÁÁwerkzeug.requestÁÁ will be ÁÁNoneÁÁ after the response was returned to the WSGI server but has the advantage that the garbage collector is not needed on CPython to tear down the request unless the user created circular dependencies themselves. - Session is now stored after callbacks so that if the session payload is stored in the session you can still modify it in an after request callback. -- The :class:`flask.Flask` class will avoid importing the provided +- The :class:Áflask.FlaskÁ class will avoid importing the provided import name if it can (the required first parameter), to benefit tools which build Flask instances programmatically. The Flask class will fall back to using import on systems with custom module hooks, e.g. Google App Engine, or when the import name is inside a zip archive (usually a .egg) prior to Python 2.7. - Blueprints now have a decorator to add custom template filters - application wide, :meth:`flask.Blueprint.app_template_filter`. + application wide, :meth:Áflask.Blueprint.app_template_filterÁ. - The Flask and Blueprint classes now have a non-decorator method for adding custom template filters application wide, - :meth:`flask.Flask.add_template_filter` and - :meth:`flask.Blueprint.add_app_template_filter`. -- The :func:`flask.get_flashed_messages` function now allows rendering + :meth:Áflask.Flask.add_template_filterÁ and + :meth:Áflask.Blueprint.add_app_template_filterÁ. +- The :func:Áflask.get_flashed_messagesÁ function now allows rendering flashed message categories in separate blocks, through a - ``category_filter`` argument. -- The :meth:`flask.Flask.run` method now accepts ``None`` for ``host`` - and ``port`` arguments, using default values when ``None``. This + ÁÁcategory_filterÁÁ argument. +- The :meth:Áflask.Flask.runÁ method now accepts ÁÁNoneÁÁ for ÁÁhostÁÁ + and ÁÁportÁÁ arguments, using default values when ÁÁNoneÁÁ. This allows for calling run using configuration values, e.g. - ``app.run(app.config.get('MYHOST'), app.config.get('MYPORT'))``, + ÁÁapp.run(app.config.get(©MYHOST©), app.config.get(©MYPORT©))ÁÁ, with proper behavior whether or not a config file is provided. -- The :meth:`flask.render_template` method now accepts a either an +- The :meth:Áflask.render_templateÁ method now accepts a either an iterable of template names or a single template name. Previously, it only accepted a single template name. On an iterable, the first template found is rendered. -- Added :meth:`flask.Flask.app_context` which works very similar to +- Added :meth:Áflask.Flask.app_contextÁ which works very similar to the request context but only provides access to the current application. This also adds support for URL generation without an active request context. - View functions can now return a tuple with the first instance being - an instance of :class:`flask.Response`. This allows for returning - ``jsonify(error="error msg"), 400`` from a view function. -- :class:`~flask.Flask` and :class:`~flask.Blueprint` now provide a - :meth:`~flask.Flask.get_send_file_max_age` hook for subclasses to + an instance of :class:Áflask.ResponseÁ. This allows for returning + ÁÁjsonify(error="error msg"), 400ÁÁ from a view function. +- :class:Á~flask.FlaskÁ and :class:Á~flask.BlueprintÁ now provide a + :meth:Á~flask.Flask.get_send_file_max_ageÁ hook for subclasses to override behavior of serving static files from Flask when using - :meth:`flask.Flask.send_static_file` (used for the default static - file handler) and :func:`~flask.helpers.send_file`. This hook is + :meth:Áflask.Flask.send_static_fileÁ (used for the default static + file handler) and :func:Á~flask.helpers.send_fileÁ. This hook is provided a filename, which for example allows changing cache - controls by file extension. The default max-age for ``send_file`` + controls by file extension. The default max-age for ÁÁsend_fileÁÁ and static files can be configured through a new - ``SEND_FILE_MAX_AGE_DEFAULT`` configuration variable, which is used - in the default ``get_send_file_max_age`` implementation. + ÁÁSEND_FILE_MAX_AGE_DEFAULTÁÁ configuration variable, which is used + in the default ÁÁget_send_file_max_ageÁÁ implementation. - Fixed an assumption in sessions implementation which could break message flashing on sessions implementations which use external storage. - Changed the behavior of tuple return values from functions. They are no longer arguments to the response object, they now have a defined meaning. -- Added :attr:`flask.Flask.request_globals_class` to allow a specific - class to be used on creation of the :data:`~flask.g` instance of +- Added :attr:Áflask.Flask.request_globals_classÁ to allow a specific + class to be used on creation of the :data:Á~flask.gÁ instance of each request. -- Added ``required_methods`` attribute to view functions to force-add +- Added ÁÁrequired_methodsÁÁ attribute to view functions to force-add methods on registration. -- Added :func:`flask.after_this_request`. -- Added :func:`flask.stream_with_context` and the ability to push +- Added :func:Áflask.after_this_requestÁ. +- Added :func:Áflask.stream_with_contextÁ and the ability to push contexts multiple times without producing unexpected behavior. @@ -657,7 +667,7 @@ Version 0.8.1 Released 2012-07-01 -- Fixed an issue with the undocumented ``flask.session`` module to not +- Fixed an issue with the undocumented ÁÁflask.sessionÁÁ module to not work properly on Python 2.5. It should not be used but did cause some problems for package managers. @@ -683,7 +693,7 @@ Released 2011-09-29, codename Rakija time. - Added the ability to register callbacks that are only triggered once at the beginning of the first request. - (:meth:`Flask.before_first_request`) + (:meth:ÁFlask.before_first_requestÁ) - Malformed JSON data will now trigger a bad request HTTP exception instead of a value error which usually would result in a 500 internal server error if not handled. This is a backwards @@ -692,28 +702,28 @@ Released 2011-09-29, codename Rakija modules are located but also an instance path which is the designated place to drop files that are modified at runtime (uploads etc.). Also this is conceptually only instance depending and outside - version control so it's the perfect place to put configuration files - etc. For more information see :ref:`instance-folders`. -- Added the ``APPLICATION_ROOT`` configuration variable. -- Implemented :meth:`~flask.testing.TestClient.session_transaction` to + version control so it©s the perfect place to put configuration files + etc. For more information see :ref:Áinstance-foldersÁ. +- Added the ÁÁAPPLICATION_ROOTÁÁ configuration variable. +- Implemented :meth:Á~flask.testing.TestClient.session_transactionÁ to easily modify sessions from the test environment. -- Refactored test client internally. The ``APPLICATION_ROOT`` - configuration variable as well as ``SERVER_NAME`` are now properly +- Refactored test client internally. The ÁÁAPPLICATION_ROOTÁÁ + configuration variable as well as ÁÁSERVER_NAMEÁÁ are now properly used by the test client as defaults. -- Added :attr:`flask.views.View.decorators` to support simpler +- Added :attr:Áflask.views.View.decoratorsÁ to support simpler decorating of pluggable (class-based) views. - Fixed an issue where the test client if used with the "with" statement did not trigger 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 - ``get`` method if no handler was implemented. -- Implemented the virtual :mod:`flask.ext` package to import + ÁÁgetÁÁ method if no handler was implemented. +- Implemented the virtual :mod:Áflask.extÁ package to import extensions from. - The context preservation on exceptions is now an integral component of Flask itself and no longer of the test client. This cleaned up some internal logic and lowers the odds of runaway request contexts in unittests. -- Fixed the Jinja2 environment's ``list_templates`` method not +- Fixed the Jinja2 environment©s ÁÁlist_templatesÁÁ method not returning the correct names when blueprints or modules were involved. @@ -741,57 +751,57 @@ Version 0.7 Released 2011-06-28, codename Grappa -- Added :meth:`~flask.Flask.make_default_options_response` which can - be used by subclasses to alter the default behavior for ``OPTIONS`` +- Added :meth:Á~flask.Flask.make_default_options_responseÁ which can + be used by subclasses to alter the default behavior for ÁÁOPTIONSÁÁ responses. -- Unbound locals now raise a proper :exc:`RuntimeError` instead of an - :exc:`AttributeError`. +- Unbound locals now raise a proper :exc:ÁRuntimeErrorÁ instead of an + :exc:ÁAttributeErrorÁ. - Mimetype guessing and etag support based on file objects is now - deprecated for :func:`flask.send_file` because it was unreliable. + deprecated for :func:Áflask.send_fileÁ because it was unreliable. Pass filenames instead or attach your own etags and provide a proper mimetype by hand. - Static file handling for modules now requires the name of the static folder to be supplied explicitly. The previous autodetection was not - reliable and caused issues on Google's App Engine. Until 1.0 the old + reliable and caused issues on Google©s App Engine. Until 1.0 the old behavior will continue to work but issue dependency warnings. - Fixed a problem for Flask to run on jython. -- Added a ``PROPAGATE_EXCEPTIONS`` configuration variable that can be +- Added a ÁÁPROPAGATE_EXCEPTIONSÁÁ configuration variable that can be used to flip the setting of exception propagation which previously - was linked to ``DEBUG`` alone and is now linked to either ``DEBUG`` - or ``TESTING``. + was linked to ÁÁDEBUGÁÁ alone and is now linked to either ÁÁDEBUGÁÁ + or ÁÁTESTINGÁÁ. - Flask no longer internally depends on rules being added through the - ``add_url_rule`` function and can now also accept regular werkzeug + ÁÁadd_url_ruleÁÁ function and can now also accept regular werkzeug rules added to the url map. -- Added an ``endpoint`` method to the flask application object which +- Added an ÁÁendpointÁÁ method to the flask application object which allows one to register a callback to an arbitrary endpoint with a decorator. - Use Last-Modified for static file sending instead of Date which was incorrectly introduced in 0.6. -- Added ``create_jinja_loader`` to override the loader creation +- 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 +- Implemented a silent flag for ÁÁconfig.from_pyfileÁÁ. +- Added ÁÁteardown_requestÁÁ decorator, for functions that should run at the end of a request regardless of whether an exception occurred. - Also the behavior for ``after_request`` was changed. It's now no + Also the behavior for ÁÁafter_requestÁÁ was changed. It©s now no longer executed when an exception is raised. See - :ref:`upgrading-to-new-teardown-handling` -- Implemented :func:`flask.has_request_context` -- Deprecated ``init_jinja_globals``. Override the - :meth:`~flask.Flask.create_jinja_environment` method instead to + :ref:Áupgrading-to-new-teardown-handlingÁ +- Implemented :func:Áflask.has_request_contextÁ +- Deprecated ÁÁinit_jinja_globalsÁÁ. Override the + :meth:Á~flask.Flask.create_jinja_environmentÁ method instead to achieve the same functionality. -- Added :func:`flask.safe_join` +- Added :func:Áflask.safe_joinÁ - The automatic JSON request data unpacking now looks at the charset mimetype parameter. -- Don't modify the session on :func:`flask.get_flashed_messages` if +- Don©t modify the session on :func:Áflask.get_flashed_messagesÁ if there are no messages in the session. -- ``before_request`` handlers are now able to abort requests with +- ÁÁbefore_requestÁÁ handlers are now able to abort requests with errors. - It is not possible to define user exception handlers. That way you can provide custom error messages from a central hub for certain errors that might occur during request processing (for instance database connection errors, timeouts from remote resources etc.). - Blueprints can provide blueprint specific error handlers. -- Implemented generic :ref:`views` (class-based views). +- Implemented generic :ref:ÁviewsÁ (class-based views). Version 0.6.1 @@ -799,8 +809,8 @@ Version 0.6.1 Released 2010-12-31 -- Fixed an issue where the default ``OPTIONS`` response was not - exposing all valid methods in the ``Allow`` header. +- Fixed an issue where the default ÁÁOPTIONSÁÁ response was not + exposing all valid methods in the ÁÁAllowÁÁ header. - Jinja2 template loading syntax now allows "./" in front of a template load path. Previously this caused issues with module setups. @@ -820,27 +830,27 @@ Released 2010-07-27, codename Whisky - After request functions are now called in reverse order of registration. - OPTIONS is now automatically implemented by Flask unless the - application explicitly adds 'OPTIONS' as method to the URL rule. In + application 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 folder for the module. This was implemented to aid GAE which will remove the - static folder if it's part of a mapping in the .yml file. -- The :attr:`~flask.Flask.config` is now available in the templates as - ``config``. + static folder if it©s part of a mapping in the .yml file. +- The :attr:Á~flask.Flask.configÁ is now available in the templates as + ÁÁconfigÁÁ. - Context processors will no longer override values passed directly to the render function. - Added the ability to limit the incoming request data with the new - ``MAX_CONTENT_LENGTH`` configuration value. -- The endpoint for the :meth:`flask.Module.add_url_rule` method is now + ÁÁMAX_CONTENT_LENGTHÁÁ configuration value. +- The endpoint for the :meth:Áflask.Module.add_url_ruleÁ method is now optional to be consistent with the function of the same name on the application object. -- Added a :func:`flask.make_response` function that simplifies +- Added a :func:Áflask.make_responseÁ function that simplifies creating response object instances in views. - Added signalling support based on blinker. This feature is currently optional and supposed to be used by extensions and applications. If - you want to use it, make sure to have `blinker`_ installed. + you want to use it, make sure to have ÁblinkerÁ_ installed. - Refactored the way URL adapters are created. This process is now - fully customizable with the :meth:`~flask.Flask.create_url_adapter` + fully customizable with the :meth:Á~flask.Flask.create_url_adapterÁ method. - Modules can now register for a subdomain instead of just an URL prefix. This makes it possible to bind a whole module to a @@ -874,19 +884,19 @@ Released 2010-07-06, codename Calvados - Fixed a bug with subdomains that was caused by the inability to specify the server name. The server name can now be set with the - ``SERVER_NAME`` config key. This key is now also used to set the + ÁÁSERVER_NAMEÁÁ config key. This key is now also used to set the session cookie cross-subdomain wide. - Autoescaping is no longer active for all templates. Instead it is - only active for ``.html``, ``.htm``, ``.xml`` and ``.xhtml``. Inside - templates this behavior can be changed with the ``autoescape`` tag. + only active for ÁÁ.htmlÁÁ, ÁÁ.htmÁÁ, ÁÁ.xmlÁÁ and ÁÁ.xhtmlÁÁ. Inside + templates this behavior can be changed with the ÁÁautoescapeÁÁ tag. - Refactored Flask internally. It now consists of more than a single file. -- :func:`flask.send_file` now emits etags and has the ability to do +- :func:Áflask.send_fileÁ now emits etags and has the ability to do conditional responses builtin. - (temporarily) dropped support for zipped applications. This was a rarely 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 used +- Removed support for ÁÁcreate_jinja_loaderÁÁ which is no longer used in 0.5 due to the improved module support. - Added a helper function to expose files from any directory. @@ -898,7 +908,7 @@ Released 2010-06-18, codename Rakia - Added the ability to register application wide error handlers from modules. -- :meth:`~flask.Flask.after_request` handlers are now also invoked if +- :meth:Á~flask.Flask.after_requestÁ handlers are now also invoked if the request dies with an exception and an error handling page kicks in. - Test client has not the ability to preserve the request context for @@ -906,8 +916,8 @@ Released 2010-06-18, codename Rakia that do not pop the request stack for testing. - Because the Python standard library caches loggers, the name of the 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. +- Added ÁÁTESTINGÁÁ switch that can activate unittesting helpers. +- The logger switches to ÁÁDEBUGÁÁ mode now if debug is enabled. Version 0.3.1 @@ -915,7 +925,7 @@ Version 0.3.1 Released 2010-05-28 -- Fixed a error reporting bug with :meth:`flask.Config.from_envvar` +- Fixed a error reporting bug with :meth:Áflask.Config.from_envvarÁ - Removed some unused code from flask - Release does no longer include development leftover files (.git folder for themes, built documentation in zip and pdf file and some @@ -928,7 +938,7 @@ Version 0.3 Released 2010-05-28, codename Schnaps - Added support for categories for flashed messages. -- The application now configures a :class:`logging.Handler` and will +- The application now configures a :class:Álogging.HandlerÁ and will log request handling exceptions to that logger when not in debug mode. This makes it possible to receive mails on server errors for example. @@ -942,18 +952,18 @@ Released 2010-05-28, codename Schnaps Version 0.2 ----------- -Released 2010-05-12, codename Jägermeister +Released 2010-05-12, codename J?germeister - Various bugfixes - Integrated JSON support -- Added :func:`~flask.get_template_attribute` helper function. -- :meth:`~flask.Flask.add_url_rule` can now also register a view +- Added :func:Á~flask.get_template_attributeÁ helper function. +- :meth:Á~flask.Flask.add_url_ruleÁ can now also register a view 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 :func:`~flask.send_file` +- Added support for :func:Á~flask.send_fileÁ - Module support and internal request handling refactoring to better support pluggable applications. - Sessions can be set to be permanent now on a per-session basis. diff --git a/src/flask/app.py b/src/flask/app.py index 878f7756..cead46d7 100644 --- a/src/flask/app.py +++ b/src/flask/app.py @@ -1797,14 +1797,14 @@ class Flask(_PackageBoundObject): if isinstance(e, BadRequestKeyError): if self.debug or self.config["TRAP_BAD_REQUEST_ERRORS"]: + e.show_exception = True + # Werkzeug < 0.15 doesn't add the KeyError to the 400 # message, add it in manually. - description = e.get_description() - - if e.args[0] not in description: + # TODO: clean up once Werkzeug >= 0.15.5 is required + if e.args[0] not in e.get_description(): e.description = "KeyError: '{}'".format(*e.args) - else: - # Werkzeug >= 0.15 does add it, remove it in production + elif not hasattr(BadRequestKeyError, "show_exception"): e.args = () if isinstance(e, HTTPException) and not self.trap_http_exception(e):