dataclass-wizard 0.35.2__tar.gz → 0.35.4__tar.gz

{dataclass_wizard-0.35.2 → dataclass_wizard-0.35.4}/CONTRIBUTING.rst

@@ -107,7 +107,7 @@ Before you submit a pull request, check that it meets these guidelines:
 2. If the pull request adds functionality, the docs should be updated. Put
    your new functionality into a function with a docstring, and add the
    feature to the list in README.rst.
-3. The pull request should work for Python 3.9, 3.10, 3.11, 3.12 and 3.13, and for PyPy. Check
+3. The pull request should work for Python 3.9, 3.10, 3.11, 3.12, 3.13 and 3.14, and for PyPy. Check
    https://github.com/rnag/dataclass-wizard/actions/workflows/dev.yml
    and make sure that the tests pass for all supported Python versions.
 

{dataclass_wizard-0.35.2 → dataclass_wizard-0.35.4}/HISTORY.rst

@@ -2,6 +2,22 @@
 History
 =======
 
+0.35.4 (2025-12-12)
+-------------------
+
+**Features and Improvements**
+
+* Add compatability and support for **Python 3.14**. Thanks to :user:`rexzhang` in :pr:`204`!
+
+0.35.3 (2025-12-12)
+-------------------
+
+**Bugfixes**
+
+* Fix typing stub (``.pyi``) compatibility for older Python/tooling versions
+  by removing Python 3.12-only ``type`` statement syntax and using
+  ``TypeAlias``/``typing``-compatible annotations instead (fixes :issue:`176`).
+
 0.35.2 (2025-12-12)
 -------------------
 

{dataclass_wizard-0.35.2 → dataclass_wizard-0.35.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dataclass-wizard
-Version: 0.35.2
+Version: 0.35.4
 Summary: Lightning-fast JSON wizardry for Python dataclasses — effortless serialization right out of the box!
 Home-page: https://github.com/rnag/dataclass-wizard
 Author: Ritvik Nag
@@ -24,10 +24,11 @@ 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
 Classifier: Programming Language :: Python
 Description-Content-Type: text/x-rst
 License-File: LICENSE
-Requires-Dist: typing-extensions>=4.9.0; python_version <= "3.12"
+Requires-Dist: typing-extensions>=4.13.0; python_version <= "3.13"
 Provides-Extra: dotenv
 Requires-Dist: python-dotenv<2,>=1; extra == "dotenv"
 Provides-Extra: timedelta
@@ -56,7 +57,7 @@ Requires-Dist: Sphinx==8.1.3; python_version >= "3.10" and extra == "dev"
 Requires-Dist: twine==6.0.1; extra == "dev"
 Requires-Dist: dataclass-wizard[toml]; extra == "dev"
 Requires-Dist: sphinx-issues==5.0.0; extra == "dev"
-Requires-Dist: sphinx-autodoc-typehints==2.5.0; extra == "dev"
+Requires-Dist: sphinx-autodoc-typehints==2.5.0; python_version >= "3.10" and extra == "dev"
 Requires-Dist: sphinx-copybutton==0.5.2; extra == "dev"
 Requires-Dist: typing-extensions>=4.9.0; extra == "dev"
 Requires-Dist: pytest==8.3.4; extra == "dev"
@@ -69,7 +70,7 @@ Requires-Dist: jsons==1.6.3; extra == "dev"
 Requires-Dist: dataclass-factory==2.16; extra == "dev"
 Requires-Dist: dacite==1.8.1; extra == "dev"
 Requires-Dist: mashumaro==3.15; extra == "dev"
-Requires-Dist: pydantic==2.10.3; extra == "dev"
+Requires-Dist: pydantic==2.10.3; python_version < "3.14" and extra == "dev"
 Requires-Dist: attrs==24.3.0; extra == "dev"
 Dynamic: author
 Dynamic: author-email
@@ -89,7 +90,7 @@ Dynamic: summary
 Dataclass Wizard
 ================
 
-Release v\ 0.35.2 | 📚 Full docs on `Read the Docs`_ (`Installation`_).
+Release v\ 0.35.4 | 📚 Full docs on `Read the Docs`_ (`Installation`_).
 
 .. image:: https://github.com/rnag/dataclass-wizard/actions/workflows/dev.yml/badge.svg
     :target: https://github.com/rnag/dataclass-wizard/actions/workflows/dev.yml

{dataclass_wizard-0.35.2 → dataclass_wizard-0.35.4}/README.rst

@@ -2,7 +2,7 @@
 Dataclass Wizard
 ================
 
-Release v\ 0.35.2 | 📚 Full docs on `Read the Docs`_ (`Installation`_).
+Release v\ 0.35.4 | 📚 Full docs on `Read the Docs`_ (`Installation`_).
 
 .. image:: https://github.com/rnag/dataclass-wizard/actions/workflows/dev.yml/badge.svg
     :target: https://github.com/rnag/dataclass-wizard/actions/workflows/dev.yml

{dataclass_wizard-0.35.2 → dataclass_wizard-0.35.4}/dataclass_wizard/__version__.py

@@ -7,7 +7,7 @@ __title__ = 'dataclass-wizard'
 __description__ = ('Lightning-fast JSON wizardry for Python dataclasses — '
                    'effortless serialization right out of the box!')
 __url__ = 'https://github.com/rnag/dataclass-wizard'
-__version__ = '0.35.2'
+__version__ = '0.35.4'
 __author__ = 'Ritvik Nag'
 __author_email__ = 'me@ritviknag.com'
 __license__ = 'Apache 2.0'

{dataclass_wizard-0.35.2 → dataclass_wizard-0.35.4}/dataclass_wizard/constants.py

@@ -23,6 +23,9 @@ PY312_OR_ABOVE = _PY_VERSION >= (3, 12)
 # Check if currently running Python 3.13 or higher
 PY313_OR_ABOVE = _PY_VERSION >= (3, 13)
 
+# Check if currently running Python 3.14 or higher
+PY314_OR_ABOVE = _PY_VERSION >= (3, 14)
+
 # The name of the dictionary object that contains `load` hooks for each
 # object type. Also used to check if a class is a :class:`BaseLoadHook`
 _LOAD_HOOKS = '__LOAD_HOOKS__'

{dataclass_wizard-0.35.2 → dataclass_wizard-0.35.4}/dataclass_wizard/environ/lookups.pyi

@@ -1,13 +1,13 @@
 from dataclasses import MISSING
-from typing import ClassVar
+from typing import ClassVar, TypeAlias, Union
 
 from ..decorators import cached_class_property
 from ..type_def import StrCollection, EnvFileType
 
 
-type _MISSING_TYPE = type(MISSING)
-type STR_OR_MISSING = str | _MISSING_TYPE
-type STR_OR_NONE = str | None
+_MISSING_TYPE: TypeAlias = type(MISSING)
+STR_OR_MISSING: TypeAlias = Union[str, _MISSING_TYPE]
+STR_OR_NONE: TypeAlias = Union[str, None]
 
 # Type of `os.environ` or `DotEnv` dict
 Environ = dict[str, STR_OR_NONE]

{dataclass_wizard-0.35.2 → dataclass_wizard-0.35.4}/dataclass_wizard/models.py

@@ -3,7 +3,7 @@ from dataclasses import MISSING, Field
 from datetime import date, datetime, time
 from typing import Generic, Mapping, NewType, Any, TypedDict
 
-from .constants import PY310_OR_ABOVE
+from .constants import PY310_OR_ABOVE, PY314_OR_ABOVE
 from .decorators import cached_property
 from .type_def import T, DT, PyNotRequired
 # noinspection PyProtectedMember
@@ -90,11 +90,51 @@ class JSONField(Field):
 
     __slots__ = ('json', )
 
+    # In Python 3.14, dataclasses adds a new parameter to the :class:`Field`
+    # constructor: `doc`
+    #
+    # Ref: https://docs.python.org/3.14/library/dataclasses.html#dataclasses.field
+    if PY314_OR_ABOVE:  # pragma: no cover
+        # noinspection PyShadowingBuiltins
+        def __init__(
+            self,
+            keys,
+            all: bool,
+            dump: bool,
+            default,
+            default_factory,
+            init,
+            repr,
+            hash,
+            compare,
+            metadata,
+            path: bool = False,
+        ):
+
+            super().__init__(
+                default,
+                default_factory,
+                init,
+                repr,
+                hash,
+                compare,
+                metadata,
+                False,
+                None,
+            )
+
+            if isinstance(keys, str):
+                keys = split_object_path(keys) if path else (keys,)
+            elif keys is ...:
+                keys = ()
+
+            self.json = JSON(*keys, all=all, dump=dump, path=path)
+
     # In Python 3.10, dataclasses adds a new parameter to the :class:`Field`
     # constructor: `kw_only`
     #
     # Ref: https://docs.python.org/3.10/library/dataclasses.html#dataclasses.dataclass
-    if PY310_OR_ABOVE:  # pragma: no cover
+    elif PY310_OR_ABOVE:  # pragma: no cover
         # noinspection PyShadowingBuiltins
         def __init__(self, keys, all: bool, dump: bool,
                      default, default_factory, init, repr, hash, compare,
@@ -312,11 +352,40 @@ def path_field(keys, *,
                     hash, compare, metadata, True)
 
 
+if PY314_OR_ABOVE:
+
+    def skip_if_field(
+        condition,
+        *,
+        default=MISSING,
+        default_factory=MISSING,
+        init=True,
+        repr=True,
+        hash=None,
+        compare=True,
+        metadata=None,
+        kw_only=MISSING,
+        doc=None,
+    ):
+
+        if default is not MISSING and default_factory is not MISSING:
+            raise ValueError("cannot specify both default and default_factory")
+
+        if metadata is None:
+            metadata = {}
+
+        metadata["__skip_if__"] = condition
+
+        return Field(
+            default, default_factory, init, repr, hash, compare, metadata, kw_only, doc
+        )
+
+
 # In Python 3.10, dataclasses adds a new parameter to the :class:`Field`
 # constructor: `kw_only`
 #
 # Ref: https://docs.python.org/3.10/library/dataclasses.html#dataclasses.dataclass
-if PY310_OR_ABOVE:  # pragma: no cover
+elif PY310_OR_ABOVE:  # pragma: no cover
     def skip_if_field(condition, *, default=MISSING, default_factory=MISSING, init=True, repr=True,
                       hash=None, compare=True, metadata=None, kw_only=MISSING):
 

{dataclass_wizard-0.35.2 → dataclass_wizard-0.35.4}/dataclass_wizard/property_wizard.py

@@ -2,11 +2,18 @@ from dataclasses import MISSING, Field, field as dataclass_field
 from functools import wraps
 from typing import Dict, Any, Type, Union, Tuple, Optional
 
+from .constants import PY314_OR_ABOVE
 from .type_def import T, NoneType
 from .utils.typing_compat import (
     get_origin, get_args, is_generic, is_literal, is_annotated, eval_forward_ref_if_needed
 )
 
+if PY314_OR_ABOVE:  # pragma: no cover
+    from annotationlib import get_annotations
+else:
+    # https://typing-extensions.readthedocs.io/en/latest/index.html#typing_extensions.get_annotations
+    from typing_extensions import get_annotations
+
 
 AnnotationType = Dict[str, Type[T]]
 AnnotationReplType = Dict[str, str]
@@ -26,7 +33,8 @@ def property_wizard(*args, **kwargs):
 
     cls: Type = type(*args, **kwargs)
     cls_dict: Dict[str, Any] = args[2]
-    annotations: AnnotationType = cls_dict.get('__annotations__', {})
+    # https://docs.python.org/3.14/whatsnew/3.14.html#implications-for-readers-of-annotations
+    annotations: AnnotationType = get_annotations(cls)
 
     # For each property, we want to replace the annotation for the underscore-
     # leading field associated with that property with the 'public' field

{dataclass_wizard-0.35.2 → dataclass_wizard-0.35.4}/dataclass_wizard/utils/object_path.pyi

@@ -1,8 +1,8 @@
 from dataclasses import MISSING
-from typing import Any, Sequence
+from typing import Any, Sequence, TypeAlias, Union
 
-type PathPart = str | int | float | bool
-type PathType = Sequence[PathPart]
+PathPart: TypeAlias = Union[str, int, float, bool]
+PathType: TypeAlias = Sequence[PathPart]
 
 
 def safe_get(data: dict | list,

{dataclass_wizard-0.35.2 → dataclass_wizard-0.35.4}/dataclass_wizard/v1/models.py

@@ -6,7 +6,7 @@ from typing import TYPE_CHECKING, Any, TypedDict, cast
 from zoneinfo import ZoneInfo
 
 from .decorators import setup_recursive_safe_function
-from ..constants import PY310_OR_ABOVE, PY311_OR_ABOVE
+from ..constants import PY310_OR_ABOVE, PY311_OR_ABOVE, PY314_OR_ABOVE
 from ..log import LOG
 from ..type_def import DefFactory, ExplicitNull, PyNotRequired, NoneType
 from ..utils.function_builder import FunctionBuilder
@@ -450,6 +450,44 @@ UTCDateTimePattern = PatternBase(datetime, tz_info=UTC)
 UTCTimePattern = PatternBase(time, tz_info=UTC)
 
 
+def _normalize_alias_path_args(all_paths, load, dump):
+    """Normalize `AliasPath` arguments and canonicalize path values."""
+    if load is not None:
+        all_paths = load
+        load = None
+        dump = ExplicitNull
+
+    elif dump is not None:
+        all_paths = dump
+        dump = None
+        load = ExplicitNull
+
+    if isinstance(all_paths, str):
+        all_paths = (split_object_path(all_paths),)
+    else:
+        all_paths = tuple([
+            split_object_path(a) if isinstance(a, str) else a
+            for a in all_paths
+        ])
+
+    return all_paths, load, dump
+
+
+def _normalize_alias_args(default, default_factory, all_aliases, load, dump):
+    """Normalize `Alias` arguments and canonicalize alias values."""
+
+    if default is not MISSING and default_factory is not MISSING:
+        raise ValueError('cannot specify both default and default_factory')
+
+    if all_aliases:
+        load = dump = all_aliases
+
+    elif load is not None and isinstance(load, str):
+        load = (load,)
+
+    return all_aliases, load, dump
+
+
 # Instances of Field are only ever created from within this module,
 # and only from the field() function, although Field instances are
 # exposed externally as (conceptually) read-only objects.
@@ -461,11 +499,125 @@ UTCTimePattern = PatternBase(time, tz_info=UTC)
 # When cls._FIELDS is filled in with a list of Field objects, the name
 # and type fields will have been populated.
 
+# In Python 3.14, dataclasses adds a new parameter to the :class:`Field`
+# constructor: `doc`
+#
+# Ref: https://docs.python.org/3.14/library/dataclasses.html#dataclasses.field
+if PY314_OR_ABOVE:
+    # noinspection PyPep8Naming,PyShadowingBuiltins
+    def Alias(
+        *all,
+        load=None,
+        dump=None,
+        skip=False,
+        default=MISSING,
+        default_factory=MISSING,
+        init=True,
+        repr=True,
+        hash=None,
+        compare=True,
+        metadata=None,
+        kw_only=False,
+        doc=None,
+    ):
+
+        all, load, dump = _normalize_alias_args(default, default_factory, all, load, dump)
+
+        return Field(
+            load,
+            dump,
+            skip,
+            None,
+            default,
+            default_factory,
+            init,
+            repr,
+            hash,
+            compare,
+            metadata,
+            kw_only,
+            doc,
+        )
+
+    # noinspection PyPep8Naming,PyShadowingBuiltins
+    def AliasPath(
+        *all,
+        load=None,
+        dump=None,
+        skip=False,
+        default=MISSING,
+        default_factory=MISSING,
+        init=True,
+        repr=True,
+        hash=None,
+        compare=True,
+        metadata=None,
+        kw_only=False,
+        doc=None,
+    ):
+        all, load, dump = _normalize_alias_path_args(all, load, dump)
+
+        return Field(
+            load,
+            dump,
+            skip,
+            all,
+            default,
+            default_factory,
+            init,
+            repr,
+            hash,
+            compare,
+            metadata,
+            kw_only,
+            doc,
+        )
+
+    class Field(_Field):
+
+        __slots__ = ("load_alias", "dump_alias", "skip", "path")
+
+        # noinspection PyShadowingBuiltins
+        def __init__(
+            self,
+            load_alias,
+            dump_alias,
+            skip,
+            path,
+            default,
+            default_factory,
+            init,
+            repr,
+            hash,
+            compare,
+            metadata,
+            kw_only,
+            doc=None,
+        ):
+
+            super().__init__(
+                default,
+                default_factory,
+                init,
+                repr,
+                hash,
+                compare,
+                metadata,
+                kw_only,
+                doc,
+            )
+
+            self.load_alias = load_alias
+            self.dump_alias = dump_alias
+            self.skip = skip
+            self.path = path
+
+
 # In Python 3.10, dataclasses adds a new parameter to the :class:`Field`
 # constructor: `kw_only`
 #
 # Ref: https://docs.python.org/3.10/library/dataclasses.html#dataclasses.dataclass
-if PY310_OR_ABOVE:  # pragma: no cover
+elif PY310_OR_ABOVE:  # pragma: no cover
 
     # noinspection PyPep8Naming,PyShadowingBuiltins
     def Alias(*all,
@@ -478,17 +630,22 @@ if PY310_OR_ABOVE:  # pragma: no cover
               hash=None, compare=True,
               metadata=None, kw_only=False):
 
-        if default is not MISSING and default_factory is not MISSING:
-            raise ValueError('cannot specify both default and default_factory')
-
-        if all:
-            load = dump = all
-
-        elif load is not None and isinstance(load, str):
-            load = (load, )
-
-        return Field(load, dump, skip, None, default, default_factory, init, repr,
-                     hash, compare, metadata, kw_only)
+        all, load, dump = _normalize_alias_args(default, default_factory, all, load, dump)
+
+        return Field(
+            load,
+            dump,
+            skip,
+            None,
+            default,
+            default_factory,
+            init,
+            repr,
+            hash,
+            compare,
+            metadata,
+            kw_only,
+        )
 
     # noinspection PyPep8Naming,PyShadowingBuiltins
     def AliasPath(*all,
@@ -500,28 +657,22 @@ if PY310_OR_ABOVE:  # pragma: no cover
                   init=True, repr=True,
                   hash=None, compare=True,
                   metadata=None, kw_only=False):
-
-        if load is not None:
-            all = load
-            load = None
-            dump = ExplicitNull
-
-        elif dump is not None:
-            all = dump
-            dump = None
-            load = ExplicitNull
-
-        if isinstance(all, str):
-            all = (split_object_path(all), )
-        else:
-            all = tuple([
-                split_object_path(a) if isinstance(a, str) else a
-                for a in all
-            ])
-
-        return Field(load, dump, skip, all, default, default_factory, init, repr,
-                     hash, compare, metadata, kw_only)
-
+        all, load, dump = _normalize_alias_path_args(all, load, dump)
+
+        return Field(
+            load,
+            dump,
+            skip,
+            all,
+            default,
+            default_factory,
+            init,
+            repr,
+            hash,
+            compare,
+            metadata,
+            kw_only,
+        )
 
     class Field(_Field):
 
@@ -555,18 +706,21 @@ else:  # pragma: no cover
               init=True, repr=True,
               hash=None, compare=True, metadata=None):
 
-        if default is not MISSING and default_factory is not MISSING:
-            raise ValueError('cannot specify both default and default_factory')
-
-        if all:
-            load = dump = all
-
-        elif load is not None and isinstance(load, str):
-            load = (load, )
-
-        return Field(load, dump, skip, None,
-                     default, default_factory, init, repr,
-                     hash, compare, metadata)
+        all, load, dump = _normalize_alias_args(default, default_factory, all, load, dump)
+
+        return Field(
+            load,
+            dump,
+            skip,
+            None,
+            default,
+            default_factory,
+            init,
+            repr,
+            hash,
+            compare,
+            metadata,
+        )
 
     # noinspection PyPep8Naming,PyShadowingBuiltins
     def AliasPath(*all,
@@ -578,28 +732,21 @@ else:  # pragma: no cover
                   init=True, repr=True,
                   hash=None, compare=True,
                   metadata=None):
-
-        if load is not None:
-            all = load
-            load = None
-            dump = ExplicitNull
-
-        elif dump is not None:
-            all = dump
-            dump = None
-            load = ExplicitNull
-
-        if isinstance(all, str):
-            all = (split_object_path(all), )
-        else:
-            all = tuple([
-                split_object_path(a) if isinstance(a, str) else a
-                for a in all
-            ])
-
-        return Field(load, dump, skip, all, default, default_factory, init, repr,
-                     hash, compare, metadata)
-
+        all, load, dump = _normalize_alias_path_args(all, load, dump)
+
+        return Field(
+            load,
+            dump,
+            skip,
+            all,
+            default,
+            default_factory,
+            init,
+            repr,
+            hash,
+            compare,
+            metadata,
+        )
 
     class Field(_Field):
 

{dataclass_wizard-0.35.2 → dataclass_wizard-0.35.4}/dataclass_wizard/v1/models.pyi

@@ -604,6 +604,19 @@ class Field(_Field):
     skip: bool
     path: PathType | None
 
+    # In Python 3.14, dataclasses adds a new parameter to the :class:`Field`
+    # constructor: `doc`
+    #
+    # Ref: https://docs.python.org/3.14/library/dataclasses.html#dataclasses.field
+    @overload
+    def __init__(self,
+                 load_alias: str | None,
+                 dump_alias: str | None,
+                 skip: bool,
+                 path: PathType | None,
+                 default, default_factory, init, repr, hash, compare,
+                 metadata, kw_only, doc):
+
     # In Python 3.10, dataclasses adds a new parameter to the :class:`Field`
     # constructor: `kw_only`
     #

{dataclass_wizard-0.35.2 → dataclass_wizard-0.35.4}/dataclass_wizard/wizard_mixins.pyi

@@ -18,7 +18,7 @@ from .type_def import (T, ListOfJSONObject,
 # A type that can be string or `path.Path`
 # https://stackoverflow.com/a/78070015/10237506
 # A type that can be string, bytes, or `PathLike`
-FileType: TypeAlias = Union[str, bytes, PathLike]
+FileType: TypeAlias = str | bytes | PathLike
 
 
 class JSONListWizard(JSONSerializable, str=False):