marshmallow 3.21.0__py3-none-any.whl → 3.21.2__py3-none-any.whl

marshmallow/__init__.py

@@ -52,9 +52,9 @@ def __getattr__(name: str) -> typing.Any:
             stacklevel=2,
         )
         __parsed_version__ = Version(importlib.metadata.version("marshmallow"))
-        __version_info__: tuple[int, int, int] | tuple[
-            int, int, int, str, int
-        ] = __parsed_version__.release  # type: ignore[assignment]
+        __version_info__: tuple[int, int, int] | tuple[int, int, int, str, int] = (
+            __parsed_version__.release  # type: ignore[assignment]
+        )
         if __parsed_version__.pre:
             __version_info__ += __parsed_version__.pre  # type: ignore[assignment]
         return __version_info__

marshmallow/base.py

@@ -7,6 +7,7 @@ These are necessary to avoid circular imports between schema.py and fields.py.
     This module is treated as private API.
     Users should not need to use this module directly.
 """
+
 from __future__ import annotations
 
 from abc import ABC, abstractmethod

marshmallow/class_registry.py

@@ -7,6 +7,7 @@ class:`fields.Nested <marshmallow.fields.Nested>`.
     This module is treated as private API.
     Users should not need to use this module directly.
 """
+
 from __future__ import annotations
 
 import typing
@@ -35,7 +36,8 @@ def register(classname: str, cls: SchemaType) -> None:
         class MyClass:
             pass
 
-        register('MyClass', MyClass)
+
+        register("MyClass", MyClass)
         # Registry:
         # {
         #   'MyClass': [path.to.MyClass],

marshmallow/decorators.py

@@ -15,39 +15,45 @@ signature.
 Example: ::
 
     from marshmallow import (
-        Schema, pre_load, pre_dump, post_load, validates_schema,
-        validates, fields, ValidationError
+        Schema,
+        pre_load,
+        pre_dump,
+        post_load,
+        validates_schema,
+        validates,
+        fields,
+        ValidationError,
     )
 
-    class UserSchema(Schema):
 
+    class UserSchema(Schema):
         email = fields.Str(required=True)
         age = fields.Integer(required=True)
 
         @post_load
         def lowerstrip_email(self, item, many, **kwargs):
-            item['email'] = item['email'].lower().strip()
+            item["email"] = item["email"].lower().strip()
             return item
 
         @pre_load(pass_many=True)
         def remove_envelope(self, data, many, **kwargs):
-            namespace = 'results' if many else 'result'
+            namespace = "results" if many else "result"
             return data[namespace]
 
         @post_dump(pass_many=True)
         def add_envelope(self, data, many, **kwargs):
-            namespace = 'results' if many else 'result'
+            namespace = "results" if many else "result"
             return {namespace: data}
 
         @validates_schema
         def validate_email(self, data, **kwargs):
-            if len(data['email']) < 3:
-                raise ValidationError('Email must be more than 3 characters', 'email')
+            if len(data["email"]) < 3:
+                raise ValidationError("Email must be more than 3 characters", "email")
 
-        @validates('age')
+        @validates("age")
         def validate_age(self, data, **kwargs):
             if data < 14:
-                raise ValidationError('Too young!')
+                raise ValidationError("Too young!")
 
 .. note::
     These decorators only work with instance methods. Class and static
@@ -58,6 +64,7 @@ Example: ::
     If you need to guarantee order of different processing steps, you should put
     them in the same processing method.
 """
+
 from __future__ import annotations
 
 import functools

marshmallow/exceptions.py

@@ -1,4 +1,5 @@
 """Exception classes for marshmallow-related errors."""
+
 from __future__ import annotations
 
 import typing

marshmallow/fields.py

@@ -1,4 +1,5 @@
 """Field classes for various types of data."""
+
 from __future__ import annotations
 
 import collections
@@ -393,7 +394,7 @@ class Field(FieldABC):
             class TitleCase(Field):
                 def _serialize(self, value, attr, obj, **kwargs):
                     if not value:
-                        return ''
+                        return ""
                     return str(value).title()
 
         :param value: The value to be serialized.
@@ -495,6 +496,7 @@ class Nested(Field):
             parent = fields.Nested(lambda: ParentSchema(only=("id",)), dump_only=True)
             siblings = fields.List(fields.Nested(lambda: ChildSchema(only=("id", "name"))))
 
+
         class ParentSchema(Schema):
             id = fields.Str()
             children = fields.List(
@@ -511,10 +513,10 @@ class Nested(Field):
     ::
 
         # Yes
-        author = fields.Nested(UserSchema, only=('id', 'name'))
+        author = fields.Nested(UserSchema, only=("id", "name"))
 
         # No
-        author = fields.Nested(UserSchema(), only=('id', 'name'))
+        author = fields.Nested(UserSchema(), only=("id", "name"))
 
     :param nested: `Schema` instance, class, class name (string), dictionary, or callable that
         returns a `Schema` or dictionary. Dictionaries are converted with `Schema.from_dict`.
@@ -626,7 +628,7 @@ class Nested(Field):
         return self._schema
 
     def _nested_normalized_option(self, option_name: str) -> list[str]:
-        nested_field = "%s." % self.name
+        nested_field = f"{self.name}."
         return [
             field.split(nested_field, 1)[1]
             for field in getattr(self.root, option_name, set())
@@ -676,16 +678,18 @@ class Pluck(Nested):
 
         from marshmallow import Schema, fields
 
+
         class ArtistSchema(Schema):
             id = fields.Int()
             name = fields.Str()
 
+
         class AlbumSchema(Schema):
-            artist = fields.Pluck(ArtistSchema, 'id')
+            artist = fields.Pluck(ArtistSchema, "id")
 
 
-        in_data = {'artist': 42}
-        loaded = AlbumSchema().load(in_data) # => {'artist': {'id': 42}}
+        in_data = {"artist": 42}
+        loaded = AlbumSchema().load(in_data)  # => {'artist': {'id': 42}}
         dumped = AlbumSchema().dump(loaded)  # => {'artist': 42}
 
     :param Schema nested: The Schema class or class name (string)
@@ -1281,8 +1285,6 @@ class DateTime(Field):
         return value.strftime(data_format)
 
     def _deserialize(self, value, attr, data, **kwargs) -> dt.datetime:
-        if not value:  # Falsy values, e.g. '', None, [] are not valid
-            raise self.make_error("invalid", input=value, obj_type=self.OBJ_TYPE)
         data_format = self.format or self.DEFAULT_FORMAT
         func = self.DESERIALIZATION_FUNCS.get(data_format)
         try:

marshmallow/schema.py

@@ -1,4 +1,5 @@
 """The :class:`Schema` class, including its metaclass and options (class Meta)."""
+
 from __future__ import annotations
 
 import copy
@@ -1047,9 +1048,9 @@ class Schema(base.SchemaABC, metaclass=SchemaMeta):
             # the type checker's perspective.
             if isinstance(field_obj, type) and issubclass(field_obj, base.FieldABC):
                 msg = (
-                    'Field for "{field_name}" must be declared as a '
+                    f'Field for "{field_name}" must be declared as a '
                     "Field instance, not a class. "
-                    'Did you mean "fields.{field_obj.__name__}()"?'
+                    f'Did you mean "fields.{field_obj.__name__}()"?'  # type: ignore
                 )
                 raise TypeError(msg) from error
             raise error

marshmallow/types.py

@@ -4,6 +4,7 @@
 
     This module is provisional. Types may be modified, added, and removed between minor releases.
 """
+
 import typing
 
 StrSequenceOrSet = typing.Union[typing.Sequence[str], typing.AbstractSet[str]]

marshmallow/utils.py

@@ -1,4 +1,5 @@
 """Utility methods for marshmallow."""
+
 from __future__ import annotations
 
 import collections
@@ -191,6 +192,8 @@ def from_iso_date(value):
 
 
 def from_timestamp(value: typing.Any) -> dt.datetime:
+    if value is True or value is False:
+        raise ValueError("Not a valid POSIX timestamp")
     value = float(value)
     if value < 0:
         raise ValueError("Not a valid POSIX timestamp")

marshmallow/validate.py

@@ -1,4 +1,5 @@
 """Validation classes for various types of data."""
+
 from __future__ import annotations
 
 import re
@@ -36,8 +37,7 @@ class Validator(ABC):
         return ""
 
     @abstractmethod
-    def __call__(self, value: typing.Any) -> typing.Any:
-        ...
+    def __call__(self, value: typing.Any) -> typing.Any: ...
 
 
 class And(Validator):
@@ -47,10 +47,12 @@ class And(Validator):
 
         from marshmallow import validate, ValidationError
 
+
         def is_even(value):
             if value % 2 != 0:
                 raise ValidationError("Not an even value.")
 
+
         validator = validate.And(validate.Range(min=0), is_even)
         validator(-1)
         # ValidationError: ['Must be greater than or equal to 0.', 'Not an even value.']
@@ -334,9 +336,7 @@ class Range(Validator):
         )
 
     def _repr_args(self) -> str:
-        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}, min_inclusive={self.min_inclusive!r}, max_inclusive={self.max_inclusive!r}"
 
     def _format_error(self, value: _T, message: str) -> str:
         return (self.error or message).format(input=value, min=self.min, max=self.max)
@@ -486,12 +486,10 @@ class Regexp(Validator):
         return self.error.format(input=value, regex=self.regex.pattern)
 
     @typing.overload
-    def __call__(self, value: str) -> str:
-        ...
+    def __call__(self, value: str) -> str: ...
 
     @typing.overload
-    def __call__(self, value: bytes) -> bytes:
-        ...
+    def __call__(self, value: bytes) -> bytes: ...
 
     def __call__(self, value):
         if self.regex.match(value) is None:

{marshmallow-3.21.0.dist-info → marshmallow-3.21.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: marshmallow
-Version: 3.21.0
+Version: 3.21.2
 Summary: A lightweight library for converting complex datatypes to and from native Python datatypes.
 Author-email: Steven Loria <sloria1@gmail.com>
 Maintainer-email: Steven Loria <sloria1@gmail.com>, Jérôme Lafréchoux <jerome@jolimont.fr>, Jared Deckard <jared@shademaps.com>
@@ -19,8 +19,8 @@ Requires-Dist: packaging>=17.0
 Requires-Dist: marshmallow[tests] ; extra == "dev"
 Requires-Dist: tox ; extra == "dev"
 Requires-Dist: pre-commit~=3.5 ; extra == "dev"
-Requires-Dist: sphinx==7.2.6 ; extra == "docs"
-Requires-Dist: sphinx-issues==4.0.0 ; extra == "docs"
+Requires-Dist: sphinx==7.3.7 ; extra == "docs"
+Requires-Dist: sphinx-issues==4.1.0 ; extra == "docs"
 Requires-Dist: alabaster==0.7.16 ; extra == "docs"
 Requires-Dist: sphinx-version-warning==1.1.2 ; extra == "docs"
 Requires-Dist: autodocsumm==0.2.12 ; extra == "docs"
@@ -157,10 +157,6 @@ Your logo will show up here with a link to your website. [`Become a sponsor`_]
 
 .. _`Become a sponsor`: https://opencollective.com/marshmallow#sponsor
 
-.. image:: https://opencollective.com/marshmallow/sponsor/0/avatar.svg
-    :target: https://opencollective.com/marshmallow/sponsor/0/website
-    :alt: Sponsors
-
 .. image:: https://opencollective.com/static/images/become_sponsor.svg
     :target: https://opencollective.com/marshmallow#sponsor
     :alt: Become a sponsor

marshmallow-3.21.2.dist-info/RECORD

@@ -0,0 +1,18 @@
+marshmallow/__init__.py,sha256=C-zbaQJ9dlJLJxotIqTa5OOaD6ojGNRqW8moGrMsGr8,2387
+marshmallow/base.py,sha256=jZ68DZxxSCvRg2GTcxQcf2JjTxqEn-xFNrBEMK3CinU,1346
+marshmallow/class_registry.py,sha256=Uvg-Obos0MejwTrpOHNEH4VF_SfGXKgR-4F2LnCbt1A,2811
+marshmallow/decorators.py,sha256=aa0tmqYW7-EJSae0ztZU9fHiQ3YIBdvIgaCrl1ChLNA,8300
+marshmallow/error_store.py,sha256=A7AxgLMw9ffSmaxRH4x3wcBWibx-DuGH4LwSDpVn50I,2223
+marshmallow/exceptions.py,sha256=DuARdOcirCdJxmlp16V97hQKAXOokvdW12jXtYOlGyk,2326
+marshmallow/fields.py,sha256=3mWgT1TiLzKgdhgWTJYsGe6lVgUz02g8sb63FEEn5hc,72995
+marshmallow/orderedset.py,sha256=C2aAG6w1faIL1phinbAltbe3AUAnF5MN6n7fzESNDhI,2922
+marshmallow/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+marshmallow/schema.py,sha256=lcaRjOkHph5NwokwIlJOuQmP_96FIwO6TzwSBd3c_98,49057
+marshmallow/types.py,sha256=eHMwQR8-ICX2RHf_i6bgjnhzdanbpBqXuzXuP6jHcNI,332
+marshmallow/utils.py,sha256=sWciesZ6tS08uX9Z9fzu2lbuut5eh8TKABU-TwgqSms,11886
+marshmallow/validate.py,sha256=hS7fYC6byDHK9A7A4is0McDMZEzu6GkKke-7unLt2hE,23857
+marshmallow/warnings.py,sha256=vHQu7AluuWqLhvlw5noXtWWbya13zDXY6JMaVSUzmDs,65
+marshmallow-3.21.2.dist-info/LICENSE,sha256=kGtdkFHkJhRMsXOtkRZnuOvQWpxYTCwmwTWzKj7RIAE,1064
+marshmallow-3.21.2.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+marshmallow-3.21.2.dist-info/METADATA,sha256=C7GEuX08QNTfpUvjjiD3GpZtWcPf4kHOJmMYNe6IoW0,7079
+marshmallow-3.21.2.dist-info/RECORD,,

marshmallow-3.21.0.dist-info/RECORD

@@ -1,18 +0,0 @@
-marshmallow/__init__.py,sha256=zfCLhifu2WhV5WdSIvF-IgtOocF2Koc1iIJ30V9MCWw,2385
-marshmallow/base.py,sha256=fo3i0f5YiT9MqY0rmdcmVy8iTNK9aOG0hFSGf4MxWEs,1345
-marshmallow/class_registry.py,sha256=h-f1EKajePnuALkjqWInnbyv_xgt92nb_DZhxyk2BVc,2809
-marshmallow/decorators.py,sha256=X9vNZgfrk3JvhHrVV9CPQxy2XMtGwewVwdvEeX_4u_o,8250
-marshmallow/error_store.py,sha256=A7AxgLMw9ffSmaxRH4x3wcBWibx-DuGH4LwSDpVn50I,2223
-marshmallow/exceptions.py,sha256=OIFlC_xY6c_4A6-1fYX-pIsgQegoLPiF5Ccur01MbPU,2325
-marshmallow/fields.py,sha256=G97qL6WjmX2H0Qn9RF78X-bQkw50uUaxMSqRfdmCFe4,73145
-marshmallow/orderedset.py,sha256=C2aAG6w1faIL1phinbAltbe3AUAnF5MN6n7fzESNDhI,2922
-marshmallow/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-marshmallow/schema.py,sha256=L6Cb39l6zE57qmLM2UZxty8g76PCr9MvY-saxzIwo3k,49038
-marshmallow/types.py,sha256=m1IhBT7dWHrYjTm7BQigHGX8UoYyt32WHwDK5Jppxf0,331
-marshmallow/utils.py,sha256=nUZBXDeXxSv6kc1njj_PvmyFRCun2bgZBYZ7mS5gLh8,11789
-marshmallow/validate.py,sha256=fZU2ftt9c-wlBgGmdnB0iZGrHpDLYgY7J7kHp0bAS9U,23914
-marshmallow/warnings.py,sha256=vHQu7AluuWqLhvlw5noXtWWbya13zDXY6JMaVSUzmDs,65
-marshmallow-3.21.0.dist-info/LICENSE,sha256=kGtdkFHkJhRMsXOtkRZnuOvQWpxYTCwmwTWzKj7RIAE,1064
-marshmallow-3.21.0.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
-marshmallow-3.21.0.dist-info/METADATA,sha256=y4u7H1p6Hvj8y66QQrXIYjjLpr8QQiQIYMnHSK0E4tw,7240
-marshmallow-3.21.0.dist-info/RECORD,,