Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Initial Update #2

merged 14 commits into from Dec 12, 2017


Copy link

commented Dec 11, 2017

This is my first visit to this fine repo so I have bundled all updates in a single pull request to make things easier for you to merge.

Close this pull request and delete the branch if you want me to start with single pull requests right away

Here's the executive summary:


Here's a list of all the updates bundled in this pull request. I've added some links to make it easier for you to find all the information you need.

ordereddict 1.1 » 1.1 PyPI | Homepage
flask 0.12.2 » 0.12.2 PyPI | Changelog | Repo
flask-login 0.4.1 » 0.4.1 PyPI | Changelog | Repo | Docs
flask-openid 1.2.5 » 1.2.5 PyPI | Changelog | Repo | Docs
flask-mail 0.9.1 » 0.9.1 PyPI | Repo | Docs
flask-sqlalchemy 2.3.2 » 2.3.2 PyPI | Changelog | Repo | Docs
sqlalchemy-migrate 0.11.0 » 0.11.0 PyPI | Homepage | Docs
flask-whooshalchemy 0.56 » 0.56 PyPI | Repo | Docs
flask-wtf 0.14.2 » 0.14.2 PyPI | Changelog | Repo | Docs
flask-babel 0.11.2 » 0.11.2 PyPI | Repo | Docs
guess_language 0.2 » 0.2 PyPI | Homepage
flipflop 1.0 » 1.0 PyPI | Repo
coverage 4.4.2 » 4.4.2 PyPI | Changelog | Repo
rauth 0.7.3 » 0.7.3 PyPI | Changelog | Repo | Docs


flask -> 0.12.2


Released on May 16 2017

  • Fix a bug in safe_join on Windows.


Bugfix release, released on March 31st 2017

  • 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. Fix
  • Use the SERVER_NAME config if it is present as default values for 2109, 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.


Released on December 21st 2016, codename Punsch.

  • the cli command now responds to --version.
  • Mimetype guessing and ETag generation for file-like objects in send_file
    has been removed, as per issue 104. See pull request 1849.
  • Mimetype guessing in send_file now fails loudly and doesn't fall back to
    application/octet-stream. See pull request 1988.
  • Make flask.safe_join able to join multiple paths like os.path.join
    (pull request 1730).
  • Revert a behavior change that made the dev server crash instead of returning
    a Internal Server Error (pull request 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.


Bugfix release, unreleased

  • Fix crash when running under PyPy3, see pull request 1814.


Bugfix release, released on June 7th 2016.

  • Fixed a bug that prevented FLASK_APP=foobar/ from working. See
    pull request 1872.


Released on May 29th 2016, 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.
  • Added before_render_template signal.
  • Added **kwargs to :meth:flask.Test.test_client to support passing
    additional keyword arguments to the constructor of
  • 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.
    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.
  • Templates are no longer automatically reloaded outside of debug 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 loader.
  • Added support for explicit root paths when using Python 3.3's namespace
  • 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 method as it works faster and more reliable due to a
    different design and also replaces 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 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.
  • 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.
  • Removed deprecated module functionality.
  • 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
  • Ported test suite to py.test.
  • 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 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. See
    pallets/flask#1262 -- this came up originally as a
    part of postmanlabs/httpbin#168
  • 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 type (pull request
  • Don't leak exception info of already catched exceptions to context teardown
    handlers (pull request 1393).
  • Allow custom Jinja environment subclasses (pull request 1422).
  • flask.g now has pop() and setdefault methods.
  • Turn on autoescape for flask.templating.render_template_string by default
    (pull request 1515).
  • flask.ext is now deprecated (pull request 1484).
  • send_from_directory now raises BadRequest if the filename is invalid on
    the server OS (pull request 1763).
  • Added the JSONIFY_MIMETYPE configuration variable (pull request 1728).
  • Exceptions during teardown handling will no longer leave bad application
    contexts lingering around.


(bugfix release, release date to be announced)

  • 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.
  • 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.
  • Fixed an etags bug when sending a file streams with a name.
  • Fixed send_from_directory not expanding to the application root path
  • 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.


(bugfix release, released on June 14th 2013)

  • 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 broke
    compatibility with the common case of people putting binary data for
    token verification into the session.
  • Fixed an issue where registering the same method twice for the same endpoint
    would trigger an exception incorrectly.


Released on June 13th 2013, 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.
  • Set the content-length header for x-sendfile.
  • tojson filter now does not escape script blocks in HTML5 parsers.
  • tojson used in templates is now safe by default due. This 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.
  • Added wrapper module around simplejson and added default 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.
  • 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 not
  • 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 disabled by
    default to not cause confusion with existing libraries 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 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 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 it
    does since 0.10.
  • 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 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 support for copying of request contexts for better working with
  • Removed custom JSON HTTP exception subclasses. If you were relying on them
    you can reintroduce them again yourself trivially. Using them however is
    strongly discouraged as the interface was flawed.
  • Python requirements changed: requiring Python 2.6 or 2.7 now to prepare
    for Python 3.3 port.
  • Changed how the teardown system is informed about exceptions. This is now
    more reliable in case something handles an exception halfway through
    the error handling process.
  • 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.
  • 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 when
    picking the default port to run on.
  • Added flask.request.get_json() as a replacement for the old
    flask.request.json property.


Released on July 1st 2012, codename Campari.

  • 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
    generated links.
  • 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
  • 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
    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 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.
  • 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
  • The :func:flask.get_flashed_messages function now allows rendering flashed
    message categories in separate blocks, through a category_filter
  • The method now accepts None for host and port
    arguments, using default values when None. This allows for calling run
    using configuration values, e.g.'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 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 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 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 provided a
    filename, which for example allows changing cache 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.
  • 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 each request.
  • 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 contexts
    multiple times without producing unexpected behavior.


Bugfix release, released on July 1st 2012

  • 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.


Released on September 29th 2011, codename Rakija

  • Refactored session support into a session interface so that
    the implementation of the sessions can be changed without
    having to override the Flask class.
  • Empty session cookies are now deleted properly automatically.
  • View functions can now opt out of getting the automatic
    OPTIONS implementation.
  • HTTP exceptions and Bad Request errors can now be trapped so that they
    show up normally in the traceback.
  • Flask in debug mode is now detecting some common problems and tries to
    warn you about them.
  • Flask in debug mode will now complain with an assertion error if a view
    was attached after the first request was handled. This gives earlier
    feedback when users forget to import view code ahead of time.
  • Added the ability to register callbacks that are only triggered once at
    the beginning of the 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 incompatible change.
  • Applications now not only have a root path where the resources and 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
    easily modify sessions from the test environment.
  • 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 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 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.


Bugfix release, release date to be decided

  • Fixed the Jinja2 environment's list_templates method not returning the
    correct names when blueprints or modules were involved.


Bugfix release, released on July 6th 2011

  • Fixed an issue with URL processors not properly working on


Bugfix release, released on June 29th 2011

  • Added missing future import that broke 2.5 compatibility.
  • Fixed an infinite redirect issue with blueprints.


Released on June 28th 2011, codename Grappa

  • 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.
  • Mimetype guessing and etag support based on file objects is now
    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 behavior will continue to work but issue dependency
  • fixed a problem for Flask to run on jython.
  • 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
  • Flask no longer internally depends on rules being added through the
    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
    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 process.
  • 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 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
    achieve the same functionality.
  • 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 there
    are no messages in the session.
  • before_request handlers are now able to abort requests with errors.
  • it is not possible to define user exception handlers. That way you 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).


Bugfix release, released on December 31st 2010

  • 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.
  • Fixed an issue where the subdomain setting for modules was
    ignored for the static folder.
  • Fixed a security problem that allowed clients to download arbitrary files
    if the host server was a windows based operating system and the client
    uses backslashes to escape the directory the files where exposed from.


Released on July 27th 2010, codename Whisky

  • after request functions are now called in reverse order of
  • OPTIONS is now automatically implemented by Flask unless the
    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
  • 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 optional to be consistent with the function of the
    same name on the application object.
  • 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.
  • refactored the way URL adapters are created. This process is now
    fully customizable with the :meth:~flask.Flask.create_url_adapter
  • modules can now register for a subdomain instead of just an URL
    prefix. This makes it possible to bind a whole module to a
    configurable subdomain.

.. _blinker:


Bugfix Release, released on July 15th 2010

  • fixed another issue with loading templates from directories when
    modules were used.


Bugfix Release, released on July 6th 2010

  • fixes an issue with template loading from directories when modules
    where used.


Released on July 6th 2010, 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 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.
  • 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 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
    in 0.5 due to the improved module support.
  • added a helper function to expose files from any directory.


Released on June 18th 2010, codename Rakia

  • added the ability to register application wide error handlers
    from modules.
  • :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 a little longer. This can also be used to trigger custom
    requests 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.


Bugfix release, released on May 28th 2010

  • 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 .pyc files)


Released on May 28th 2010, codename Schnaps

  • added support for categories for flashed messages.
  • 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.
  • added support for context binding that does not require the use of
    the with statement for playing in the console.
  • the request context is now available within the with statement making
    it possible to further push the request context or pop it.
  • added support for configurations.


Released on May 12th 2010, 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 function.
  • refactored internal request dispatching.
  • server listens on by default now to fix issues with chrome.
  • added external URL support.
  • 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.
  • better error reporting on missing secret keys.
  • added support for Google Appengine.


First public preview release.

flask-login -> 0.4.1



  • New config option USE_SESSION_FOR_NEXT to enable storing next url in session
    instead of url. 330
  • Accept int seconds along with timedelta for REMEMBER_COOKIE_DURATION. 370
  • New config option FORCE_HOST_FOR_REDIRECTS to force host for redirects. 371


Released on October 26th, 2016

  • Fixes OPTIONS exemption from login. 244
  • Fixes use of MD5 by replacing with SHA512. 264
  • BREAKING: The login_manager.token_handler function, get_auth_token method
    on the User class, and the utils.make_secure_token utility function have
    been removed to prevent users from creating insecure auth implementations.
    Use the Alternative Tokens example from the docs instead. 291


Released on October 8th, 2015

  • Fixes Python 2.6 compatibility.
  • Updates SESSION_KEYS to include "remember".


Released on September 30th, 2015

  • Fixes removal of non-Flask-Login keys from session object when using 'strong'


Released on September 10th, 2015

  • Fixes handling of X-Forward-For header.
  • Update to use SHA512 instead of MD5 for session identifier creation.
  • Fixes session creation for every view.
  • BREAKING: UTC used to set cookie duration.
  • BREAKING: Non-fresh logins now returns HTTP 401.
  • Support unicode user IDs in cookie.
  • Fixes user_logged_out signal invocation.
  • Support for per-Blueprint login views.
  • BREAKING: The is_authenticated, is_active, and is_anonymous members of
    the user class are now properties, not methods. Applications should update
    their user classes accordingly.
  • Various other improvements including documentation and code clean up.


Released on May 19th, 2014

  • Fixes missing request loader invocation when authorization header exists.


Released on March 9th, 2014

  • Generalized request_loader introduced; ability to log users in via
    customized callback over request.
  • Fixes request context dependency by explicitly checking has_request_context.
  • Fixes remember me issues since lazy user loading changes.


Released on December 28th, 2013

  • Fixes anonymous user assignment.
  • Fixes localization in Python 3.


Released on December 21st 2013

  • Support login via authorization header. This allows login via Basic Auth, for
    example. Useful in an API presentation context.
  • Ability to override user ID method name. This is useful if the ID getter is
    named differently than the default.
  • Session data is now only read when the user is requested. This can be
    beneficial for cookie and caching control when differenting between
    requests that use user information for rendering and ones where all users
    (including anonymous) get the same result (e.g. static pages)
  • BREAKING: User must always be accessed through the current_user
    local. This breaks any previous direct access to
    This is because user is not loaded until current_user is accessed.
  • Fixes unnecessary access to the session when the user is anonymous
    and session protection is active.
    see maxcountryman/flask-login#120
  • Fixes issue where order dependency of applying the login manager
    before dependent applications was required.
    see mattupstate/flask-principal#22
  • Fixes Python 3 UserMixin hashing.
  • Fixes incorrect documentation.

Previous Versions

Prior to 0.2.8, no proper changelog was kept.

flask-openid -> 1.2.5



  • Added support for immediate mode requests. [Patrick Uiterwijk]
  • Fixed grammar error in docs. [Yuval Langer]
  • Fixed import path to url_quote. [Bluevalor]
  • Base64 encoding and decoding internal data. [Patrick Steele]



  • Support using the url_root as trust_root. [Patrick Uiterwijk]



  • Added shebang to example to make it easier to run. [Patrick Uiterwijk]


  • Fix compatibility issue with python<2.7 introduced in 1.2.2. [Patrick Uiterwijk]



  • Make it easier to start the example by removing init_db. [Patrick Uiterwijk]
  • Make OpenID errors more descriptive. [Patrick Uiterwijk]


  • First try to utf8 encode, but skip for python3. [evgen]
  • Make the checks for string type work. [Patrick Uiterwijk, Sergey]



  • Using print() for python 3 compatibility. [Jon Chen]
  • Make ask_for_optional optional in debug if ask_for is specified. [Samuel Miller]



  • Added support for python 3. [Dennis Glindhart, Patrick Uiterwijk]
  • Added support for python-openid extensions. [Pierre-Yves Chibon, Jeff Miller, Patrick Uiterwijk]
  • Added support for optional sreg keys. [Shay Erlichmen, Patrick Uiterwijk]
  • Added the option to declare which URL roots are safe to redirect to [Patrick Uiterwijk]


  • Small typo fix in documentation. [David Vincelli]
  • Fix the import name in the documentation. [William Ting, Amanjeev Sethi]
  • Fix pickle.loads crashing on non-ASCII chars. [Shay Erlichmen]

flask-sqlalchemy -> 2.3.2


Released on October 11, 2017

  • Don't mask the parent table for single-table inheritance models. (561_)

.. _561: pallets/flask-sqlalchemy#561


Released on October 5, 2017

  • If a model has a table name that matches an existing table in the metadata,
    use that table. Fixes a regression where reflected tables were not picked up
    by models. (551_)
  • Raise the correct error when a model has a table name but no primary key.
  • Fix repr on models that don't have an identity because they have not been
    flushed yet. (555_)
  • Allow specifying a max_per_page limit for pagination, to avoid users
    specifying high values in the request args. (542_)
  • For paginate with error_out=False, the minimum value for page is
    1 and per_page is 0. (558_)

.. _542: pallets/flask-sqlalchemy#542
.. _551: pallets/flask-sqlalchemy#551
.. _555: pallets/flask-sqlalchemy#555
.. _556: pallets/flask-sqlalchemy#556
.. _558: pallets/flask-sqlalchemy#558


Released on September 28, 2017

  • Multiple bugs with __tablename__ generation are fixed. Names will be
    generated for models that define a primary key, but not for single-table
    inheritance subclasses. Names will not override a declared_attr.
    PrimaryKeyConstraint is detected. (541_)
  • Passing an existing declarative_base() as model_class to
    SQLAlchemy.__init__ will use this as the base class instead of creating
    one. This allows customizing the metaclass used to construct the base.
  • The undocumented DeclarativeMeta internals that the extension uses for
    binds and table name generation have been refactored to work as mixins.
    Documentation is added about how to create a custom metaclass that does not
    do table name generation. (546_)
  • Model and metaclass code has been moved to a new models module.
    _BoundDeclarativeMeta is renamed to DefaultMeta; the old name will be
    removed in 3.0. (546_)
  • Models have a default repr that shows the model name and primary key.
  • Fixed a bug where using init_app would cause connectors to always use the
    current_app rather than the app they were created for. This caused issues
    when multiple apps were registered with the extension. (547_)

.. _530: pallets/flask-sqlalchemy#530
.. _541: pallets/flask-sqlalchemy#541
.. _546: pallets/flask-sqlalchemy#546
.. _547: pallets/flask-sqlalchemy#547


Released on February 27, 2017, codename Dubnium

  • Minimum SQLAlchemy version is 0.8 due to use of sqlalchemy.inspect.
  • Added support for custom query_class and model_class as args
    to the SQLAlchemy constructor. (328_)
  • Allow listening to SQLAlchemy events on db.session. (364_)
  • Allow __bind_key__ on abstract models. (373_)
  • Allow SQLALCHEMY_ECHO to be a string. (409_)
  • Warn when SQLALCHEMY_DATABASE_URI is not set. (443_)
  • Don't let pagination generate invalid page numbers. (460_)
  • Drop support of Flask < 0.10. This means the db session is always tied to
    the app context and its teardown event. (461_)
  • Tablename generation logic no longer accesses class properties unless they
    are declared_attr. (467_)

.. _328: pallets/flask-sqlalchemy#328
.. _364: pallets/flask-sqlalchemy#364
.. _373: pallets/flask-sqlalchemy#373
.. _409: pallets/flask-sqlalchemy#409
.. _443: pallets/flask-sqlalchemy#443
.. _460: pallets/flask-sqlalchemy#460
.. _461: pallets/flask-sqlalchemy#461
.. _467: pallets/flask-sqlalchemy#467


Released on October 23rd 2015, codename Caesium

  • Table names are automatically generated in more cases, including
    subclassing mixins and abstract models.
  • Allow using a custom MetaData object.
  • Add support for binds parameter to session.


Released on August 29th 2014, codename Bohrium

  • Changed how the builtin signals are subscribed to skip non Flask-SQLAlchemy
    sessions. This will also fix the attribute error about model changes
    not existing.
  • Added a way to control how signals for model modifications are tracked.
  • Made the SignallingSession a public interface and added a hook
    for customizing session creation.
  • If the bind parameter is given to the signalling session it will no
    longer cause an error that a parameter is given twice.
  • Added working table reflection support.
  • Enabled autoflush by default.
  • Consider SQLALCHEMY_COMMIT_ON_TEARDOWN harmful and remove from docs.


Released on July 20th 2013, codename Aurum

  • Added Python 3.3 support.
  • Dropped 2.5 compatibility.
  • Various bugfixes
  • Changed versioning format to do major releases for each update now.


  • New distribution format (flask_sqlalchemy)
  • Added support for Flask 0.9 specifics.


  • Added session support for multiple databases


  • Make relative sqlite paths relative to the application root.


  • Fixed an issue with Flask-SQLAlchemy not selecting the correct binds.


  • Added support for multiple databases.
  • Expose Flask-SQLAlchemy's BaseQuery as db.Query.
  • Set default query_class for db.relation, db.relationship, and
    db.dynamic_loader to Flask-SQLAlchemy's BaseQuery.
  • Improved compatibility with Flask 0.7.


  • Fixed a bug introduced in 0.10 with alternative table constructors.


  • Added support for signals.
  • Table names are now automatically set from the class name unless
  • Model.query now always works for applications directly passed to
    the SQLAlchemy constructor. Furthermore the property now raises
    an RuntimeError instead of being None.
  • added session options to constructor.
  • fixed a broken __repr__
  • db.Table is now a factor function that creates table objects.
    This makes it possible to omit the metadata.


  • applied changes to pass the Flask extension approval process.


  • added a few configuration keys for creating connections.
  • automatically activate connection recycling for MySQL connections.
  • added support for the Flask testing mode.


  • Initial public release

flask-wtf -> 0.14.2


Released 2017-01-10

  • Fix bug where FlaskForm assumed meta argument was not None if it
    was passed. (278_)

.. _278: lepture/flask-wtf#278


Released 2017-01-10

  • Fix bug where the file validators would incorrectly identify an empty file as
    valid data. (276, 277)
  • FileField is no longer deprecated. The data is checked during
    processing and only set if it's a valid file.
  • has_file is deprecated; it's now equivalent to bool(
  • FileRequired and FileAllowed work with both the Flask-WTF and
    WTForms FileField classes.
  • The Optional validator now works with FileField.

.. _276: lepture/flask-wtf#276
.. _277: lepture/flask-wtf#277


Released 2017-01-06

  • Use itsdangerous to sign CSRF tokens and check expiration instead of doing it
    ourselves. (264_)
  • All tokens are URL safe, removing the url_safe parameter from
    generate_csrf. (206_)
  • All tokens store a timestamp, which is checked in validate_csrf. The
    time_limit parameter of generate_csrf is removed.
  • Remove the app attribute from CsrfProtect, use current_app.
  • CsrfProtect protects the DELETE method by default. (264_)
  • The same CSRF token is generated for the lifetime of a request. It is exposed
    as g.csrf_token for use during testing. (227, 264)
  • CsrfProtect.error_handler is deprecated. (264_)
  • Handlers that return a response work in addition to those that raise an
    error. The behavior was not clear in previous docs.
  • (200, 209, 243, 252)
  • Use Form.Meta instead of deprecated SecureForm for CSRF (and
    everything else). (216, 271)
  • csrf_enabled parameter is still recognized but deprecated. All other
    attributes and methods from SecureForm are removed. (271_)
  • Provide WTF_CSRF_FIELD_NAME to configure the name of the CSRF token.
  • validate_csrf raises wtforms.ValidationError with specific messages
    instead of returning True or False. This breaks anything that was
    calling the method directly. (239, 271)
  • CSRF errors are logged as well as raised. (239_)
  • CsrfProtect is renamed to CSRFProtect. A deprecation warning is issued
    when using the old name. CsrfError is renamed to CSRFError without
    deprecation. (271_)
  • FileField is deprecated because it no longer provides functionality over
    the provided validators. Use wtforms.FileField directly. (272_)

.. _200: lepture/flask-wtf#200
.. _209: lepture/flask-wtf#209
.. _216: lepture/flask-wtf#216
.. _227: lepture/flask-wtf#227
.. _239: lepture/flask-wtf#239
.. _243: lepture/flask-wtf#243
.. _252: lepture/flask-wtf#252
.. _264: lepture/flask-wtf#264
.. _271: lepture/flask-wtf#271
.. _272: lepture/flask-wtf#272


Released 2016/10/6

  • Deprecation warning for Form is shown during __init__ instead of immediately when subclassing. (262_)
  • Don't use pkg_resources to get version, for compatibility with GAE. (261_)

.. _261: lepture/flask-wtf#261
.. _262: lepture/flask-wtf#262


Released 2016/09/29

  • Form is renamed to FlaskForm in order to avoid name collision with WTForms's base class. Using Form will show a deprecation warning. (250_)
  • hidden_tag no longer wraps the hidden inputs in a hidden div. This is valid HTML5 and any modern HTML parser will behave correctly. (217, 193)
  • flask_wtf.html5 is deprecated. Import directly from wtforms.fields.html5. (251_)
  • is_submitted is true for PATCH and DELETE in addition to POST and PUT. (187_)
  • generate_csrf takes a token_key parameter to specify the key stored in the session. (206_)
  • generate_csrf takes a url_safe parameter to allow the token to be used in URLs. (206_)
  • can be accessed multiple times without raising an exception. (248_)
  • File extension with multiple parts (.tar.gz) can be used in the FileAllowed validator. (201_)

.. _187: lepture/flask-wtf#187
.. _193: lepture/flask-wtf#193
.. _201: lepture/flask-wtf#201
.. _206: lepture/flask-wtf#206
.. _217: lepture/flask-wtf#217
.. _248: lepture/flask-wtf#248
.. _250: lepture/flask-wtf#250
.. _251: lepture/flask-wtf#251


Released 2015/07/09

  • Abstract protect_csrf() into a separate method
  • Update reCAPTCHA configuration
  • Fix reCAPTCHA error handle


Released 2015/01/21

  • Use the new reCAPTCHA API via 164_.

.. _164: lepture/flask-wtf#164


Released 2014/11/16

  • Add configuration: WTF_CSRF_HEADERS via 159_.
  • Support customize hidden tags via 150_.
  • And many more bug fixes

.. _150: lepture/flask-wtf#150
.. _159: lepture/flask-wtf#159


Released 2014/09/03

  • Update translation for reCaptcha via 146_.

.. _146: lepture/flask-wtf#146


Released 2014/08/26

  • Update RECAPTCHA API SERVER URL via 145_.
  • Update requirement Werkzeug>=0.9.5
  • Fix CsrfProtect exempt for blueprints via 143_.

.. _145: lepture/flask-wtf#145
.. _143: lepture/flask-wtf#143


Released 2014/07/16

  • Add configuration: WTF_CSRF_METHODS
  • Support WTForms 2.0 now
  • Fix csrf validation without time limit (time_limit=False)
  • CSRF exempt supports blueprint 111_.

.. _111: lepture/flask-wtf#111


Released 2014/03/21

  • csrf_token for all template types 112_.
  • Make FileRequired a subclass of InputRequired 108_.

.. _108: lepture/flask-wtf#108
.. _112: lepture/flask-wtf#112


Released 2013/12/20

  • Bugfix for csrf module when form has a prefix
  • Compatible support for wtforms2
  • Remove file API for FileField


Released 2013/10/02

  • Fix validation of recaptcha when app in testing mode 89_.
  • Bugfix for csrf module 91_

.. _89: lepture/flask-wtf#89
.. _91: lepture/flask-wtf#91


Released 2013/9/11

  • Upgrade wtforms to 1.0.5.
  • No lazy string for i18n 77_.
  • No DateInput widget in html5 81_.
  • PUT and PATCH for CSRF 86_.

.. _77: lepture/flask-wtf#77
.. _81: lepture/flask-wtf#81
.. _86: lepture/flask-wtf#86


Released 2013/8/21

This is a patch version for backward compitable for Flask<0.10 82_.

.. _82: lepture/flask-wtf#82


Released 2013/8/15

  • Add i18n support (issue 65)
  • Use default html5 widgets and fields provided by wtforms
  • Python 3.3+ support
  • Redesign form, replace SessionSecureForm
  • CSRF protection solution
  • Drop wtforms imports
  • Fix recaptcha i18n support
  • Fix recaptcha validator for python 3
  • More test cases, it's 90%+ coverage now
  • Redesign documentation


Released 2013/3/28

  • Recaptcha Validator now returns provided message (issue 66)
  • Minor doc fixes
  • Fixed issue with tests barking because of nose/multiprocessing issue.


Released 2013/3/13

  • Update documentation to indicate pending deprecation of WTForms namespace
  • PEP8 fixes (issue 64)
  • Fix Recaptcha widget (issue 49)


Initial development by Dan Jacob and Ron Duplain. 0.8.2 and prior there was not
a change log.

coverage -> 4.4.2


  • Support for Python 3.7. In some cases, class and module docstrings are no
    longer counted in statement totals, which could slightly change your total
  • Specifying both --source and --include no longer silently ignores the
    include setting, instead it displays a warning. Thanks, Loïc Dachary. Closes
    issue 265_ and issue 101_.
  • Fixed a race condition when saving data and multiple threads are tracing
    (issue 581_). It could produce a "dictionary changed size during iteration"
    RuntimeError. I believe this mostly but not entirely fixes the race
    condition. A true fix would likely be too expensive. Thanks, Peter Baughman
    for the debugging, and Olivier Grisel for the fix with tests.
  • Configuration values which are file paths will now apply tilde-expansion,
    closing issue 589_.
  • Now secondary config files like tox.ini and setup.cfg can be specified
    explicitly, and prefixed sections like [coverage:run] will be read. Fixes
    issue 588_.
  • Be more flexible about the command name displayed by help, fixing
    issue 600_. Thanks, Ben Finney.

.. _issue 101:
.. _issue 581:
.. _issue 588:
.. _issue 589:
.. _issue 600:

.. _changes_441:


  • No code changes: just corrected packaging for Python 2.7 Linux wheels.

.. _changes_44:


  • Reports could produce the wrong file names for packages, reporting
    instead of the correct pkg/ This is now fixed. Thanks, Dirk
  • XML reports could produce &lt;source&gt; and &lt;class&gt; lines that together
    didn't specify a valid source file path. This is now fixed. (issue 526_)
  • Namespace packages are no longer warned as having no code. (issue 572_)
  • Code that uses sys.settrace(sys.gettrace()) in a file that wasn't being
    coverage-measured would prevent correct coverage measurement in following
    code. An example of this was running doctests programmatically. This is now
    fixed. (issue 575_)
  • Errors printed by the coverage command now go to stderr instead of
  • Running coverage xml in a directory named with non-ASCII characters would
    fail under Python 2. This is now fixed. (issue 573_)

.. _issue 526:
.. _issue 572:
.. _issue 573:
.. _issue 575:


  • Some warnings can now be individually disabled. Warnings that can be
    disabled have a short name appended. The [run] disable_warnings setting
    takes a list of these warning names to disable. Closes both issue 96_ and
    issue 355_.
  • The XML report now includes attributes from version 4 of the Cobertura XML
    format, fixing issue 570_.
  • In previous versions, calling a method that used collected data would prevent
    further collection. For example, save(), report(), html_report(), and
    others would all stop collection. An explicit start() was needed to get it
    going again. This is no longer true. Now you can use the collected data and
    also continue measurement. Both issue 79_ and issue 448_ described this
    problem, and have been fixed.
  • Plugins can now find unexecuted files if they choose, by implementing the
    find_executable_files method. Thanks, Emil Madsen.
  • Minimal IronPython support. You should be able to run IronPython programs
    under coverage run, though you will still have to do the reporting phase
    with CPython.
  • has long had a special hack to support CPython's need to measure
    the coverage of the standard library tests. This code was not installed by
    kitted versions of Now it is.

.. _issue 79:
.. _issue 96:
.. _issue 355:
.. _issue 448:
.. _issue 570:

.. _changes_434:


  • Fixing 2.6 in version 4.3.3 broke other things, because the too-tricky
    exception wasn't properly derived from Exception, described in issue 556_.
    A newb mistake; it hasn't been a good few days.

.. _issue 556:

.. _changes_433:


  • Python 2.6 support was broken due to a testing exception imported for the
    benefit of the test suite. Properly conditionalizing it fixed
    issue 554_ so that Python 2.6 works again.

.. _issue 554:

.. _changes_432:


  • Using the --skip-covered option on an HTML report with 100% coverage
    would cause a "No data to report" error, as reported in issue 549_. This is
    now fixed; thanks, Loïc Dachary.
  • If-statements can be optimized away during compilation, for example, if 0:
    or if __debug__:. had problems properly understanding these
    statements which existed in the source, but not in the compiled bytecode.
    This problem, reported in issue 522_, is now fixed.
  • If you specified --source as a directory, then would look for
    importable Python files in that directory, and could identify ones that had
    never been executed at all. But if you specified it as a package name, that
    detection wasn't performed. Now it is, closing issue 426_. Thanks to Loïc
    Dachary for the fix.
  • If you started and stopped coverage measurement thousands of times in your
    process, you could crash Python with a "Fatal Python error: deallocating
    None" error. This is now fixed. Thanks to Alex Groce for the bug report.
  • On PyPy, measuring coverage in subprocesses could produce a warning: "Trace
    function changed, measurement is likely wrong: None". This was spurious, and
    has been suppressed.
  • Previously, couldn't start on Jython, due to that implementation
    missing the multiprocessing module (issue 551). This problem has now been
    fixed. Also, issue 322
    about not being able to invoke coverage
    conveniently, seems much better: jython -m coverage run works
  • Let's say you ran the HTML report over and over again in the same output
    directory, with --skip-covered. And imagine due to your heroic
    test-writing efforts, a file just acheived the goal of 100% coverage. With 4.3, the old HTML file with the less-than-100% coverage would be
    left behind. This file is now properly deleted.

.. _issue 322:
.. issue 426:
.. issue 522:

.. _issue 549:
.. _issue 551:

.. _changes_431:


  • Some environments couldn't install 4.3, as described in issue 540_. This is
    now fixed.
  • The check for conflicting --source and --include was too simple in a
    few different ways, breaking a few perfectly reasonable use cases, described
    in issue 541. The check has been reverted while we re-think the fix for
    issue 265

.. _issue 540:
.. _issue 541:

.. _changes_43:


Special thanks to Loïc Dachary, who took an extraordinary interest in and contributed a number of improvements in this release.

  • Subprocesses that are measured with automatic subprocess measurement_ used
    to read in any pre-existing data file. This meant data would be incorrectly
    carried forward from run to run. Now those files are not read, so each
    subprocess only writes its own data. Fixes issue 510_.
  • The coverage combine command will now

@JLevski JLevski merged commit 692eae8 into master Dec 12, 2017

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
None yet
2 participants
You can’t perform that action at this time.