Flask-marshmallow

******************

Bug fixes:

* Fix `File` field when it receives an empty value (:pr:`301`, :issue:`apiflask/apiflask551`).
Thanks :user:`uncle-lv`.
* Fix `validate.FileSize` to handle `SpooledTemporaryFile` (:pr:`300`).
Thanks again :user:`uncle-lv`.

******************

Features:

* Performance improvement to `validate.FileSize` (:pr:`293`).
Thanks :user:`uncle-lv`.

******************

Features:

* Add type coverage (:pr:`290`).

******************

Features:

* Add field ``fields.File``, ``validate.FileType``, and ``validate.FileSize``
for deserializing uploaded files (:issue:`280`, :pr:`282`).
Thanks :user:`uncle-lv` for the PR
* Add field ``Config`` for serializing Flask configuration values (:issue:`280`, :pr:`281`).
Thanks :user:`greyli` for the PR.

Support:

* Support marshmallow-sqlalchemy>=0.29.0.
* Test against Python 3.12.
* Drop support for Python 3.7.

Other changes:

* *Backwards-incompatible*: Remove flask_marshmallow.__version__``
and ``flask_marshmallow.__version_info__`` attributes (:pr:`284`).
Use feature detection or ``importlib.metadata.version("flask-marshmallow")`` instead.

*******************

* Changes to supported software versions.

* python3.6 or later and marshmallow>=3.0.0 are now required
* Add support for python3.11
* For ``sqlalchemy`` integration, marshmallow-sqlalchemy>=0.28.2 and
flask-sqlalchemy>=3.0.0 are now required

* *Backwards-incompatible*: ``URLFor`` and ``AbsoluteURLFor`` now do not accept
parameters for ``flask.url_for`` as top-level parameters. They must always be
passed in the ``values`` dictionary, as explained in the v0.14.0 changelog.

Bug fixes:

* Address distutils deprecation warning in Python 3.10 (:pr:`242`).
Thanks :user:`GabrielLins64` for the PR.

*******************

* Add ``values`` argument to ``URLFor`` and ``AbsoluteURLFor`` for passing values to ``flask.url_for``.
This prevents unrelated parameters from getting passed (:issue:`52`, :issue:`67`).
Thanks :user:`AlrasheedA` for the PR.

Deprecation:

* Passing params to ``flask.url_for`` via ``URLFor``'s and ``AbsoluteURLFor``'s constructor
params is deprecated. Pass ``values`` instead.

.. code-block:: python

flask-marshmallow<0.14.0


class UserSchema(ma.Schema):
_links = ma.Hyperlinks(
{
"self": ma.URLFor("user_detail", id="<id>"),
}
)


flask-marshmallow>=0.14.0


class UserSchema(ma.Schema):
_links = ma.Hyperlinks(
{
"self": ma.URLFor("user_detail", values=dict(id="<id>")),
}
)