marshmallow 4.0.1__tar.gz → 4.1.1__tar.gz

{marshmallow-4.0.1 → marshmallow-4.1.1}/CHANGELOG.rst

@@ -1,6 +1,25 @@
 Changelog
 ---------
 
+4.1.1 (2025-11-05)
+++++++++++++++++++
+
+Bug fixes:
+
+- Ensure ``URL`` validator is case-insensitive when using custom schemes (:pr:`2874`).
+  Thanks :user:`T90REAL` for the PR.
+
+4.1.0 (2025-11-01)
+++++++++++++++++++
+
+Other changes:
+
+- Add `__len__` implementation to `missing` so that it can be used with
+  `validate.Length <marshmallow.validate.Length>` (:pr:`2861`).
+  Thanks :user:`agentgodzilla` for the PR.
+- Drop support for Python 3.9 (:pr:`2363`).
+- Test against Python 3.14 (:pr:`2864`).
+
 4.0.1 (2025-08-28)
 ++++++++++++++++++
 

{marshmallow-4.0.1 → marshmallow-4.1.1}/PKG-INFO

@@ -1,20 +1,20 @@
 Metadata-Version: 2.4
 Name: marshmallow
-Version: 4.0.1
+Version: 4.1.1
 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>
-Requires-Python: >=3.9
+Author-email: Steven Loria <oss@stevenloria.com>
+Maintainer-email: Steven Loria <oss@stevenloria.com>, Jérôme Lafréchoux <jerome@jolimont.fr>, Jared Deckard <jared@shademaps.com>
+Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 License-File: LICENSE
 Requires-Dist: backports-datetime-fromisoformat; python_version < '3.11'
 Requires-Dist: typing-extensions; python_version < '3.11'
@@ -22,11 +22,11 @@ Requires-Dist: marshmallow[tests] ; extra == "dev"
 Requires-Dist: tox ; extra == "dev"
 Requires-Dist: pre-commit>=3.5,<5.0 ; extra == "dev"
 Requires-Dist: autodocsumm==0.2.14 ; extra == "docs"
-Requires-Dist: furo==2025.7.19 ; extra == "docs"
+Requires-Dist: furo==2025.9.25 ; extra == "docs"
 Requires-Dist: sphinx-copybutton==0.5.2 ; extra == "docs"
 Requires-Dist: sphinx-issues==5.0.1 ; extra == "docs"
 Requires-Dist: sphinx==8.2.3 ; extra == "docs"
-Requires-Dist: sphinxext-opengraph==0.12.0 ; extra == "docs"
+Requires-Dist: sphinxext-opengraph==0.13.0 ; extra == "docs"
 Requires-Dist: pytest ; extra == "tests"
 Requires-Dist: simplejson ; extra == "tests"
 Project-URL: Changelog, https://marshmallow.readthedocs.io/en/latest/changelog.html

{marshmallow-4.0.1 → marshmallow-4.1.1}/docs/code_of_conduct.rst

@@ -136,10 +136,10 @@ members. This section covers actual concrete steps.
 Contacting maintainers
 ~~~~~~~~~~~~~~~~~~~~~~
 
-As a small and young project, we don't yet have a Code of Conduct
+As a small project, we don't yet have a Code of Conduct
 enforcement team. Hopefully that will be addressed as we grow, but for
-now, any issues should be addressed to `Steven Loria
-<https://github.com/sloria>`__, via `email <mailto:sloria1@gmail.com>`__
+now, any issues should be addressed to `@sloria
+<https://github.com/sloria>`__, via `email <mailto:oss@stevenloria.com>`__
 or any other medium that you feel comfortable with. Using words like
 "marshmallow code of conduct" in your subject will help make sure your
 message is noticed quickly.

{marshmallow-4.0.1 → marshmallow-4.1.1}/pyproject.toml

@@ -1,12 +1,12 @@
 [project]
 name = "marshmallow"
-version = "4.0.1"
+version = "4.1.1"
 description = "A lightweight library for converting complex datatypes to and from native Python datatypes."
 readme = "README.rst"
 license = { file = "LICENSE" }
-authors = [{ name = "Steven Loria", email = "sloria1@gmail.com" }]
+authors = [{ name = "Steven Loria", email = "oss@stevenloria.com" }]
 maintainers = [
-  { name = "Steven Loria", email = "sloria1@gmail.com" },
+  { name = "Steven Loria", email = "oss@stevenloria.com" },
   { name = "Jérôme Lafréchoux", email = "jerome@jolimont.fr" },
   { name = "Jared Deckard", email = "jared@shademaps.com" },
 ]
@@ -15,13 +15,13 @@ classifiers = [
   "Intended Audience :: Developers",
   "License :: OSI Approved :: MIT License",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
 ]
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 dependencies = [
   "backports-datetime-fromisoformat; python_version < '3.11'",
   "typing-extensions; python_version < '3.11'",
@@ -37,11 +37,11 @@ Tidelift = "https://tidelift.com/subscription/pkg/pypi-marshmallow?utm_source=py
 [project.optional-dependencies]
 docs = [
   "autodocsumm==0.2.14",
-  "furo==2025.7.19",
+  "furo==2025.9.25",
   "sphinx-copybutton==0.5.2",
   "sphinx-issues==5.0.1",
   "sphinx==8.2.3",
-  "sphinxext-opengraph==0.12.0",
+  "sphinxext-opengraph==0.13.0",
 ]
 tests = ["pytest", "simplejson"]
 dev = ["marshmallow[tests]", "tox", "pre-commit>=3.5,<5.0"]
@@ -108,6 +108,7 @@ ignore = [
   "PLR0915", # allow lots of statements
   "PT007",   # ignore false positives due to https://github.com/astral-sh/ruff/issues/14743
   "PT011",   # don't require match when using pytest.raises
+  "RUF043",  # allow metacharacters in match patterns
   "S",       # allow asserts
   "SIM117",  # allow nested with statements because it's more readable sometimes
   "SLF001",  # allow private attribute access

{marshmallow-4.0.1 → marshmallow-4.1.1}/src/marshmallow/constants.py

@@ -18,5 +18,8 @@ class _Missing:
     def __repr__(self):
         return "<marshmallow.missing>"
 
+    def __len__(self):
+        return 0
+
 
 missing: typing.Final = _Missing()

{marshmallow-4.0.1 → marshmallow-4.1.1}/src/marshmallow/decorators.py

@@ -68,8 +68,8 @@ Example: ::
 from __future__ import annotations
 
 import functools
+import typing
 from collections import defaultdict
-from typing import Any, Callable, cast
 
 PRE_DUMP = "pre_dump"
 POST_DUMP = "post_dump"
@@ -80,10 +80,10 @@ VALIDATES_SCHEMA = "validates_schema"
 
 
 class MarshmallowHook:
-    __marshmallow_hook__: dict[str, list[tuple[bool, Any]]] | None = None
+    __marshmallow_hook__: dict[str, list[tuple[bool, typing.Any]]] | None = None
 
 
-def validates(*field_names: str) -> Callable[..., Any]:
+def validates(*field_names: str) -> typing.Callable[..., typing.Any]:
     """Register a validator method for field(s).
 
     :param field_names: Names of the fields that the method validates.
@@ -95,12 +95,12 @@ def validates(*field_names: str) -> Callable[..., Any]:
 
 
 def validates_schema(
-    fn: Callable[..., Any] | None = None,
+    fn: typing.Callable[..., typing.Any] | None = None,
     *,
     pass_collection: bool = False,
     pass_original: bool = False,
     skip_on_field_errors: bool = True,
-) -> Callable[..., Any]:
+) -> typing.Callable[..., typing.Any]:
     """Register a schema-level validator.
 
     By default it receives a single object at a time, transparently handling the ``many``
@@ -131,10 +131,10 @@ def validates_schema(
 
 
 def pre_dump(
-    fn: Callable[..., Any] | None = None,
+    fn: typing.Callable[..., typing.Any] | None = None,
     *,
     pass_collection: bool = False,
-) -> Callable[..., Any]:
+) -> typing.Callable[..., typing.Any]:
     """Register a method to invoke before serializing an object. The method
     receives the object to be serialized and returns the processed object.
 
@@ -150,11 +150,11 @@ def pre_dump(
 
 
 def post_dump(
-    fn: Callable[..., Any] | None = None,
+    fn: typing.Callable[..., typing.Any] | None = None,
     *,
     pass_collection: bool = False,
     pass_original: bool = False,
-) -> Callable[..., Any]:
+) -> typing.Callable[..., typing.Any]:
     """Register a method to invoke after serializing an object. The method
     receives the serialized object and returns the processed object.
 
@@ -173,10 +173,10 @@ def post_dump(
 
 
 def pre_load(
-    fn: Callable[..., Any] | None = None,
+    fn: typing.Callable[..., typing.Any] | None = None,
     *,
     pass_collection: bool = False,
-) -> Callable[..., Any]:
+) -> typing.Callable[..., typing.Any]:
     """Register a method to invoke before deserializing an object. The method
     receives the data to be deserialized and returns the processed data.
 
@@ -194,11 +194,11 @@ def pre_load(
 
 
 def post_load(
-    fn: Callable[..., Any] | None = None,
+    fn: typing.Callable[..., typing.Any] | None = None,
     *,
     pass_collection: bool = False,
     pass_original: bool = False,
-) -> Callable[..., Any]:
+) -> typing.Callable[..., typing.Any]:
     """Register a method to invoke after deserializing an object. The method
     receives the deserialized data and returns the processed data.
 
@@ -219,12 +219,12 @@ def post_load(
 
 
 def set_hook(
-    fn: Callable[..., Any] | None,
+    fn: typing.Callable[..., typing.Any] | None,
     tag: str,
     *,
     many: bool = False,
-    **kwargs: Any,
-) -> Callable[..., Any]:
+    **kwargs: typing.Any,
+) -> typing.Callable[..., typing.Any]:
     """Mark decorated function as a hook to be picked up later.
     You should not need to use this method directly.
 
@@ -241,7 +241,7 @@ def set_hook(
 
     # Set a __marshmallow_hook__ attribute instead of wrapping in some class,
     # because I still want this to end up as a normal (unbound) method.
-    function = cast("MarshmallowHook", fn)
+    function = typing.cast("MarshmallowHook", fn)
     try:
         hook_config = function.__marshmallow_hook__
     except AttributeError:

{marshmallow-4.0.1 → marshmallow-4.1.1}/src/marshmallow/fields.py

@@ -685,7 +685,7 @@ class Pluck(Nested):
         return self._load(value, partial=partial)
 
 
-class List(Field[list[typing.Optional[_InternalT]]]):
+class List(Field[list[_InternalT | None]]):
     """A list field, composed with another `Field` class or
     instance.
 
@@ -816,7 +816,7 @@ class Tuple(Field[tuple]):
 
         return tuple(
             field._serialize(each, attr, obj, **kwargs)
-            for field, each in zip(self.tuple_fields, value)
+            for field, each in zip(self.tuple_fields, value, strict=True)
         )
 
     def _deserialize(
@@ -834,7 +834,7 @@ class Tuple(Field[tuple]):
         result = []
         errors = {}
 
-        for idx, (field, each) in enumerate(zip(self.tuple_fields, value)):
+        for idx, (field, each) in enumerate(zip(self.tuple_fields, value, strict=True)):
             try:
                 result.append(field.deserialize(each, **kwargs))
             except ValidationError as error:
@@ -1745,7 +1745,7 @@ class Email(String):
         self.validators.insert(0, validator)
 
 
-class IP(Field[typing.Union[ipaddress.IPv4Address, ipaddress.IPv6Address]]):
+class IP(Field[ipaddress.IPv4Address | ipaddress.IPv6Address]):
     """A IP address field.
 
     :param exploded: If `True`, serialize ipv6 address in long form, ie. with groups
@@ -1802,9 +1802,7 @@ class IPv6(IP):
     DESERIALIZATION_CLASS = ipaddress.IPv6Address
 
 
-class IPInterface(
-    Field[typing.Union[ipaddress.IPv4Interface, ipaddress.IPv6Interface]]
-):
+class IPInterface(Field[ipaddress.IPv4Interface | ipaddress.IPv6Interface]):
     """A IPInterface field.
 
     IP interface is the non-strict form of the IPNetwork type where arbitrary host

{marshmallow-4.0.1 → marshmallow-4.1.1}/src/marshmallow/schema.py

@@ -1188,7 +1188,9 @@ class Schema(metaclass=SchemaMeta):
             pass_original = validator_kwargs.get("pass_original", False)
 
             if many and not pass_collection:
-                for idx, (item, orig) in enumerate(zip(data, original_data)):
+                for idx, (item, orig) in enumerate(
+                    zip(data, original_data, strict=True)
+                ):
                     self._run_validator(
                         validator,
                         item,

{marshmallow-4.0.1 → marshmallow-4.1.1}/src/marshmallow/types.py

@@ -7,23 +7,16 @@
 
 from __future__ import annotations
 
-try:
-    from typing import TypeAlias
-except ImportError:  # Remove when dropping Python 3.9
-    from typing_extensions import TypeAlias
-
 import typing
 
 #: A type that can be either a sequence of strings or a set of strings
-StrSequenceOrSet: TypeAlias = typing.Union[
-    typing.Sequence[str], typing.AbstractSet[str]
-]
+StrSequenceOrSet: typing.TypeAlias = typing.Sequence[str] | typing.AbstractSet[str]
 
 #: Type for validator functions
-Validator: TypeAlias = typing.Callable[[typing.Any], typing.Any]
+Validator: typing.TypeAlias = typing.Callable[[typing.Any], typing.Any]
 
 #: A valid option for the ``unknown`` schema option and argument
-UnknownOption: TypeAlias = typing.Literal["exclude", "include", "raise"]
+UnknownOption: typing.TypeAlias = typing.Literal["exclude", "include", "raise"]
 
 
 class SchemaValidator(typing.Protocol):

{marshmallow-4.0.1 → marshmallow-4.1.1}/src/marshmallow/utils.py

@@ -7,31 +7,25 @@ import inspect
 import typing
 from collections.abc import Mapping, Sequence
 
-# Remove when we drop Python 3.9
-try:
-    from typing import TypeGuard
-except ImportError:
-    from typing_extensions import TypeGuard
-
 from marshmallow.constants import missing
 
 
-def is_generator(obj) -> TypeGuard[typing.Generator]:
+def is_generator(obj) -> typing.TypeGuard[typing.Generator]:
     """Return True if ``obj`` is a generator"""
     return inspect.isgeneratorfunction(obj) or inspect.isgenerator(obj)
 
 
-def is_iterable_but_not_string(obj) -> TypeGuard[typing.Iterable]:
+def is_iterable_but_not_string(obj) -> typing.TypeGuard[typing.Iterable]:
     """Return True if ``obj`` is an iterable object that isn't a string."""
     return (hasattr(obj, "__iter__") and not hasattr(obj, "strip")) or is_generator(obj)
 
 
-def is_sequence_but_not_string(obj) -> TypeGuard[Sequence]:
+def is_sequence_but_not_string(obj) -> typing.TypeGuard[Sequence]:
     """Return True if ``obj`` is a sequence that isn't a string."""
     return isinstance(obj, Sequence) and not isinstance(obj, (str, bytes))
 
 
-def is_collection(obj) -> TypeGuard[typing.Iterable]:
+def is_collection(obj) -> typing.TypeGuard[typing.Iterable]:
     """Return True if ``obj`` is a collection type, e.g list, tuple, queryset."""
     return is_iterable_but_not_string(obj) and not isinstance(obj, Mapping)
 

{marshmallow-4.0.1 → marshmallow-4.1.1}/src/marshmallow/validate.py

@@ -187,7 +187,7 @@ class URL(Validator):
         self.relative = relative
         self.absolute = absolute
         self.error: str = error or self.default_message
-        self.schemes = schemes or self.default_schemes
+        self.schemes = {s.lower() for s in schemes} if schemes else self.default_schemes
         self.require_tld = require_tld
 
     def _repr_args(self) -> str:
@@ -623,8 +623,7 @@ class OneOf(Validator):
         :param valuegetter: Can be a callable or a string. In the former case, it must
             be a one-argument callable which returns the value of a
             choice. In the latter case, the string specifies the name
-            of an attribute of the choice objects. Defaults to `str()`
-            or `str()`.
+            of an attribute of the choice objects. Defaults to `str()`.
         """
         valuegetter = valuegetter if callable(valuegetter) else attrgetter(valuegetter)
         pairs = zip_longest(self.choices, self.labels, fillvalue="")

{marshmallow-4.0.1 → marshmallow-4.1.1}/tests/test_decorators.py

@@ -165,7 +165,7 @@ class TestPassOriginal:
             def post_load(self, data, original, many, **kwargs):
                 if many:
                     ret = []
-                    for item, orig_item in zip(data, original):
+                    for item, orig_item in zip(data, original, strict=True):
                         item["_post_load"] = orig_item["sentinel"]
                         ret.append(item)
                 else:
@@ -177,7 +177,7 @@ class TestPassOriginal:
             def post_dump(self, data, original, many, **kwargs):
                 if many:
                     ret = []
-                    for item, orig_item in zip(data, original):
+                    for item, orig_item in zip(data, original, strict=True):
                         item["_post_dump"] = orig_item["sentinel"]
                         ret.append(item)
                 else:

{marshmallow-4.0.1 → marshmallow-4.1.1}/tests/test_deserialization.py

@@ -14,6 +14,7 @@ from marshmallow import (
     RAISE,
     Schema,
     fields,
+    missing,
     validate,
 )
 from marshmallow.exceptions import ValidationError
@@ -1005,6 +1006,13 @@ class TestFieldDeserialization:
         field = fields.Function(lambda x: None, deserialize=lambda val: val.upper())
         assert field.deserialize("foo") == "FOO"
 
+    def test_function_field_deserialization_missing_with_length_validator(self):
+        field = fields.Function(
+            deserialize=lambda value: value.get("some-key", missing),
+            validate=validate.Length(min=0),
+        )
+        assert field.deserialize({}) is missing
+
     def test_function_field_passed_deserialize_only_is_load_only(self):
         field = fields.Function(deserialize=lambda val: val.upper())
         assert field.load_only is True
@@ -1306,7 +1314,7 @@ class TestFieldDeserialization:
         field = fields.List(fields.DateTime())
         result = field.deserialize(dstrings)
         assert all(isinstance(each, dt.datetime) for each in result)
-        for actual, expected in zip(result, dtimes):
+        for actual, expected in zip(result, dtimes, strict=True):
             assert_date_equal(actual, expected)
 
     def test_list_field_deserialize_invalid_item(self):
@@ -1347,7 +1355,9 @@ class TestFieldDeserialization:
 
         assert isinstance(result, tuple)
         assert len(result) == 2
-        for val, type_, true_val in zip(result, (dt.datetime, int), (dtime, 42)):
+        for val, type_, true_val in zip(
+            result, (dt.datetime, int), (dtime, 42), strict=True
+        ):
             assert isinstance(val, type_)
             assert val == true_val
 

{marshmallow-4.0.1 → marshmallow-4.1.1}/tests/test_schema.py

@@ -2265,7 +2265,7 @@ class TestGetAttribute:
         ]
         schema = UserDictSchema(many=True)
         results = schema.dump(user_dicts)
-        for result, user_dict in zip(results, user_dicts):
+        for result, user_dict in zip(results, user_dicts, strict=True):
             assert result["name"] == user_dict["_name"]
             assert result["email"] == user_dict["_email"]
         # can't serialize User object

{marshmallow-4.0.1 → marshmallow-4.1.1}/tests/test_utils.py

@@ -124,7 +124,7 @@ def test_from_timestamp_with_negative_value():
 
 def test_from_timestamp_with_overflow_value():
     value = 9223372036854775
-    with pytest.raises(ValueError, match="out of range"):
+    with pytest.raises(ValueError, match=r"out of range|year must be in 1\.\.9999"):
         utils.from_timestamp(value)
 
 

{marshmallow-4.0.1 → marshmallow-4.1.1}/tests/test_validate.py

@@ -205,6 +205,14 @@ def test_url_custom_scheme():
     assert validator(url) == url
 
 
+def test_url_custom_scheme_case_insensitive():
+    validator = validate.URL(schemes={"HTTP"})
+    assert validator("http://example.com") == "http://example.com"
+
+    validator = validate.URL(schemes={"HtTp"})
+    assert validator("hTtP://example.com") == "hTtP://example.com"
+
+
 @pytest.mark.parametrize(
     "valid_url",
     (

{marshmallow-4.0.1 → marshmallow-4.1.1}/tox.ini

@@ -1,5 +1,5 @@
 [tox]
-envlist = lint,mypy,py{39,310,311,312,313},docs
+envlist = lint,mypy,py{310,311,312,313,314},docs
 
 [testenv]
 extras = tests