flask-marshmallow 1.2.0__py3-none-any.whl → 1.2.1__py3-none-any.whl

flask_marshmallow/__init__.py

@@ -1,10 +1,11 @@
 """
-    flask_marshmallow
-    ~~~~~~~~~~~~~~~~~
+flask_marshmallow
+~~~~~~~~~~~~~~~~~
 
-    Integrates the marshmallow serialization/deserialization library
-    with your Flask application.
+Integrates the marshmallow serialization/deserialization library
+with your Flask application.
 """
+
 import typing
 import warnings
 
@@ -75,14 +76,16 @@ class Marshmallow:
 
         class BookSchema(ma.Schema):
             class Meta:
-                fields = ('id', 'title', 'author', 'links')
+                fields = ("id", "title", "author", "links")
 
             author = ma.Nested(AuthorSchema)
 
-            links = ma.Hyperlinks({
-                'self': ma.URLFor('book_detail', values=dict(id='<id>')),
-                'collection': ma.URLFor('book_list')
-            })
+            links = ma.Hyperlinks(
+                {
+                    "self": ma.URLFor("book_detail", values=dict(id="<id>")),
+                    "collection": ma.URLFor("book_list"),
+                }
+            )
 
 
     In order to integrate with Flask-SQLAlchemy, this extension must be initialized

flask_marshmallow/fields.py

@@ -1,14 +1,16 @@
 """
-    flask_marshmallow.fields
-    ~~~~~~~~~~~~~~~~~~~~~~~~
+flask_marshmallow.fields
+~~~~~~~~~~~~~~~~~~~~~~~~
 
-    Custom, Flask-specific fields.
+Custom, Flask-specific fields.
 
-    See the `marshmallow.fields` module for the list of all fields available from the
-    marshmallow library.
+See the `marshmallow.fields` module for the list of all fields available from the
+marshmallow library.
 """
+
 import re
 import typing
+from collections.abc import Sequence
 
 from flask import current_app, url_for
 from marshmallow import fields, missing
@@ -75,10 +77,10 @@ class URLFor(fields.Field):
 
     Usage: ::
 
-        url = URLFor('author_get', values=dict(id='<id>'))
+        url = URLFor("author_get", values=dict(id="<id>"))
         https_url = URLFor(
-            'author_get',
-            values=dict(id='<id>', _scheme='https', _external=True),
+            "author_get",
+            values=dict(id="<id>", _scheme="https", _external=True),
         )
 
     :param str endpoint: Flask endpoint name.
@@ -175,19 +177,23 @@ class Hyperlinks(fields.Field):
 
     Example: ::
 
-        _links = Hyperlinks({
-            'self': URLFor('author', values=dict(id='<id>')),
-            'collection': URLFor('author_list'),
-        })
+        _links = Hyperlinks(
+            {
+                "self": URLFor("author", values=dict(id="<id>")),
+                "collection": URLFor("author_list"),
+            }
+        )
 
     `URLFor` objects can be nested within the dictionary. ::
 
-        _links = Hyperlinks({
-            'self': {
-                'href': URLFor('book', values=dict(id='<id>')),
-                'title': 'book detail'
+        _links = Hyperlinks(
+            {
+                "self": {
+                    "href": URLFor("book", values=dict(id="<id>")),
+                    "title": "book detail",
+                }
             }
-        })
+        )
 
     :param dict schema: A dict that maps names to
         :class:`~flask_marshmallow.fields.URLFor` fields.
@@ -220,6 +226,17 @@ class File(fields.Field):
 
     default_error_messages = {"invalid": "Not a valid file."}
 
+    def deserialize(
+        self,
+        value: typing.Any,
+        attr: typing.Optional[str] = None,
+        data: typing.Optional[typing.Mapping[str, typing.Any]] = None,
+        **kwargs,
+    ):
+        if isinstance(value, Sequence) and len(value) == 0:
+            value = missing
+        return super().deserialize(value, attr, data, **kwargs)
+
     def _deserialize(self, value, attr, data, **kwargs):
         from werkzeug.datastructures import FileStorage
 
@@ -236,11 +253,12 @@ class Config(fields.Field):
         from flask import Flask
 
         app = Flask(__name__)
-        app.config['API_TITLE'] = 'Pet API'
+        app.config["API_TITLE"] = "Pet API"
+
 
         class FooSchema(Schema):
             user = String()
-            title = Config('API_TITLE')
+            title = Config("API_TITLE")
 
     This field should only be used in an output schema. A ``ValueError`` will
     be raised if the config key is not found in the app config.

flask_marshmallow/sqla.py

@@ -1,12 +1,13 @@
 """
-    flask_marshmallow.sqla
-    ~~~~~~~~~~~~~~~~~~~~~~
+flask_marshmallow.sqla
+~~~~~~~~~~~~~~~~~~~~~~
 
-    Integration with Flask-SQLAlchemy and marshmallow-sqlalchemy. Provides
-    `SQLAlchemySchema <marshmallow_sqlalchemy.SQLAlchemySchema>` and
-    `SQLAlchemyAutoSchema <marshmallow_sqlalchemy.SQLAlchemyAutoSchema>` classes
-    that use the scoped session from Flask-SQLAlchemy.
+Integration with Flask-SQLAlchemy and marshmallow-sqlalchemy. Provides
+`SQLAlchemySchema <marshmallow_sqlalchemy.SQLAlchemySchema>` and
+`SQLAlchemyAutoSchema <marshmallow_sqlalchemy.SQLAlchemyAutoSchema>` classes
+that use the scoped session from Flask-SQLAlchemy.
 """
+
 from urllib import parse
 
 import marshmallow_sqlalchemy as msqla

flask_marshmallow/validate.py

@@ -1,12 +1,15 @@
 """
-    flask_marshmallow.validate
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~
+flask_marshmallow.validate
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    Custom validation classes for various types of data.
+Custom validation classes for various types of data.
 """
+
+import io
 import os
 import re
 import typing
+from tempfile import SpooledTemporaryFile
 
 from marshmallow.exceptions import ValidationError
 from marshmallow.validate import Validator as Validator
@@ -15,7 +18,15 @@ from werkzeug.datastructures import FileStorage
 
 def _get_filestorage_size(file: FileStorage) -> int:
     """Return the size of the FileStorage object in bytes."""
-    size: int = file.stream.getbuffer().nbytes  # type: ignore
+    stream = file.stream
+    if isinstance(stream, io.BytesIO):
+        return stream.getbuffer().nbytes
+
+    if isinstance(stream, SpooledTemporaryFile):
+        return os.stat(stream.fileno()).st_size
+
+    size = len(file.read())
+    file.stream.seek(0)
     return size
 
 
@@ -57,7 +68,7 @@ class FileSize(Validator):
     Example: ::
 
         class ImageSchema(Schema):
-            image = File(required=True, validate=FileSize(min='1 MiB', max='2 MiB'))
+            image = File(required=True, validate=FileSize(min="1 MiB", max="2 MiB"))
 
     :param min: The minimum size (lower bound). If not provided, minimum
         size will not be checked.
@@ -106,8 +117,10 @@ class FileSize(Validator):
         )
 
     def _repr_args(self):
-        return "min={!r}, max={!r}, min_inclusive={!r}, max_inclusive={!r}".format(
-            self.min, self.max, self.min_inclusive, self.max_inclusive
+        return (
+            f"min={self.min!r}, max={self.max!r}, "
+            f"min_inclusive={self.min_inclusive!r}, "
+            f"max_inclusive={self.max_inclusive!r}"
         )
 
     def _format_error(self, value, message):
@@ -141,11 +154,12 @@ class FileSize(Validator):
 
 class FileType(Validator):
     """Validator which succeeds if the uploaded file is allowed by a given list
-        of extensions.
+    of extensions.
 
     Example: ::
+
         class ImageSchema(Schema):
-            image = File(required=True, validate=FileType(['.png']))
+            image = File(required=True, validate=FileType([".png"]))
 
     :param accept: A sequence of allowed extensions.
     :param error: Error message to raise in case of a validation error.

{flask_marshmallow-1.2.0.dist-info → flask_marshmallow-1.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: flask-marshmallow
-Version: 1.2.0
+Version: 1.2.1
 Summary: Flask + marshmallow for beautiful APIs
 Maintainer-email: Steven Loria <sloria1@gmail.com>, Stephen Rosen <sirosen0@gmail.com>
 Requires-Python: >=3.8

flask_marshmallow-1.2.1.dist-info/RECORD

@@ -0,0 +1,10 @@
+flask_marshmallow/__init__.py,sha256=IsYMbL7JZL1yc1P0EKVfpxokIMlnKKVNMcSwhHfu29w,3678
+flask_marshmallow/fields.py,sha256=Z-v60FhOe-HlupA_tGhZMtS4p4b9i4LFbTbCgDCQ5-4,7936
+flask_marshmallow/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+flask_marshmallow/schema.py,sha256=Z6uJVkqi-gq1QfdPbPuy5Fw3UnXGE9vKiD6IJkPOMR4,1412
+flask_marshmallow/sqla.py,sha256=VN4aH5pm1HvyepeV6AHtipTAK_Mz_zLA-0IulsObhCk,3948
+flask_marshmallow/validate.py,sha256=KRJus6GpPC7MZGFjDidhnNjI3tc6_y9PPQ-Pcmik18I,6816
+flask_marshmallow-1.2.1.dist-info/LICENSE,sha256=kGtdkFHkJhRMsXOtkRZnuOvQWpxYTCwmwTWzKj7RIAE,1064
+flask_marshmallow-1.2.1.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+flask_marshmallow-1.2.1.dist-info/METADATA,sha256=E5EDVQ1awnti6hs2oQPuBu1B5xAV19cfvW6kiUqbXH8,5190
+flask_marshmallow-1.2.1.dist-info/RECORD,,

flask_marshmallow-1.2.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-flask_marshmallow/__init__.py,sha256=2s46vkrP0wX1wXBT0OF9oTUNIaoX5-uu_AogfhGXupg,3650
-flask_marshmallow/fields.py,sha256=0_mk3dKpyDKT66Tp4KoDZ0uNCxmvGVH3Rk4OAwjR8f4,7486
-flask_marshmallow/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-flask_marshmallow/schema.py,sha256=Z6uJVkqi-gq1QfdPbPuy5Fw3UnXGE9vKiD6IJkPOMR4,1412
-flask_marshmallow/sqla.py,sha256=QKEpKDfrBJ5m1KpnRuEB5Txfxql-aN_pyHznYxzNd6Y,3971
-flask_marshmallow/validate.py,sha256=cJDooGyaEqhTmnIBEpOKAR8Y-WzPcNdvtDcAZUCI030,6565
-flask_marshmallow-1.2.0.dist-info/LICENSE,sha256=kGtdkFHkJhRMsXOtkRZnuOvQWpxYTCwmwTWzKj7RIAE,1064
-flask_marshmallow-1.2.0.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
-flask_marshmallow-1.2.0.dist-info/METADATA,sha256=SnUTf1VP6m6L83PHJK6QZ6tbsQwuCP4yAAvLwqPdMf0,5190
-flask_marshmallow-1.2.0.dist-info/RECORD,,