Milestone to v1

HISTORY.rst

@@ -2,6 +2,33 @@
 History
 =======
 
+
+0.36.0 (2025-12-14)
+------------------
+
+**Features and Improvements**
+
+* Introduce ``DataclassWizard`` as the preferred base class for the v1 API.
+  This class auto-applies the ``@dataclass`` decorator to subclasses, reducing
+  boilerplate and clarifying the recommended usage going forward.
+* Add explicit v1 dump support via a new ``v1/dumpers.py`` implementation.
+  This refactor improves separation of concerns and results in better
+  serialization performance when v1 is enabled.
+* Update default usage examples and documentation to reflect the new
+  ``DataclassWizard`` API and explicit ``load_case`` / ``dump_case`` configuration.
+* Fix annotation resolution for older Python versions by routing
+  through ``get_resolved_annotations()``.
+
+**API Changes**
+
+* Rename ``v1_key_case`` to ``v1_case`` for clarity and consistency with related
+  v1 configuration options.
+
+**Internal Changes**
+
+* Refactor v1 load/dump selection logic to route through the new v1 loader and
+  dumper pipeline when enabled.
+
 0.35.4 (2025-12-12)
 -------------------
 

README.rst

@@ -32,11 +32,11 @@ for complex and *nested dataclass* models!
 **Behold, the power of the Dataclass Wizard**::
 
     >>> from __future__ import annotations
-    >>> from dataclasses import dataclass, field
-    >>> from dataclass_wizard import JSONWizard
+    >>> from dataclasses import field
+    >>> from dataclass_wizard import DataclassWizard
     ...
-    >>> @dataclass
-    ... class MyClass(JSONWizard):
+    >>> # DataclassWizard auto-applies @dataclass to subclasses
+    ... class MyClass(DataclassWizard, load_case='AUTO', dump_case='CAMEL'):
     ...     my_str: str | None
     ...     is_active_tuple: tuple[bool, ...]
     ...     list_of_int: list[int] = field(default_factory=list)
@@ -1516,7 +1516,7 @@ What's New in v1.0
             print(MyModel(my_field="value").to_dict())
             # Output: {'my_field': 'value'}
 
-    - **Default __str__() Behavior Change**
+- **Default __str__() Behavior Change**
 
       Starting with **v1.0.0**, we no longer pretty-print the serialized JSON value with keys in ``camelCase``.
       Instead, we now use the ``pprint`` module to handle serialization formatting.

benchmarks/complex.py

@@ -219,14 +219,14 @@ def test_load(request, data, data_2, data_dacite, n):
     """
     [ RESULTS ON MAC OS X ]
 
-    benchmarks.complex.complex - [INFO] dataclass-wizard     0.325364
-    benchmarks.complex.complex - [INFO] dataclass-factory    0.773195
-    benchmarks.complex.complex - [INFO] dataclasses-json     28.435088
-    benchmarks.complex.complex - [INFO] dacite               6.287875
-    benchmarks.complex.complex - [INFO] mashumaro            0.344701
-    benchmarks.complex.complex - [INFO] pydantic             0.547749
-    benchmarks.complex.complex - [INFO] jsons                29.978993
-    benchmarks.complex.complex - [INFO] jsons (strict)       34.052532
+    benchmarks.complex.complex - [INFO] dataclass-wizard     0.317641
+    benchmarks.complex.complex - [INFO] dataclass-factory    0.751124
+    benchmarks.complex.complex - [INFO] dacite               6.350958
+    benchmarks.complex.complex - [INFO] mashumaro            0.343612
+    benchmarks.complex.complex - [INFO] pydantic             0.538801
+    benchmarks.complex.complex - [INFO] dataclasses-json     28.214992
+    benchmarks.complex.complex - [INFO] jsons                31.735730
+    benchmarks.complex.complex - [INFO] jsons (strict)       34.855084
     """
     g = globals().copy()
     g.update(locals())
@@ -276,14 +276,14 @@ def test_dump(request, data, data_2, data_dacite, n):
     """
     [ RESULTS ON MAC OS X ]
 
-    benchmarks.complex.complex - [INFO] dataclass-wizard     1.606120
-    benchmarks.complex.complex - [INFO] asdict (dataclasses) 2.006917
-    benchmarks.complex.complex - [INFO] dataclass-factory    0.979412
-    benchmarks.complex.complex - [INFO] dataclasses-json     13.740522
-    benchmarks.complex.complex - [INFO] mashumaro            0.289991
-    benchmarks.complex.complex - [INFO] pydantic             0.384267
-    benchmarks.complex.complex - [INFO] jsons                41.673240
-    benchmarks.complex.complex - [INFO] jsons (strict)       45.934885
+    benchmarks.complex.complex - [INFO] dataclass-wizard     0.405688
+    benchmarks.complex.complex - [INFO] asdict (dataclasses) 1.727631
+    benchmarks.complex.complex - [INFO] dataclass-factory    0.831178
+    benchmarks.complex.complex - [INFO] dataclasses-json     11.072727
+    benchmarks.complex.complex - [INFO] mashumaro            0.248298
+    benchmarks.complex.complex - [INFO] pydantic             0.316203
+    benchmarks.complex.complex - [INFO] jsons                37.361450
+    benchmarks.complex.complex - [INFO] jsons (strict)       31.578708
     """
     c1 = MyClassWizard.from_dict(data)
     c2 = factory.load(data_2, MyClass)

benchmarks/simple.py

@@ -81,15 +81,15 @@ def test_load(data, n):
     """
     [ RESULTS ON MAC OS X ]
 
-    benchmarks.simple.simple - [INFO] dataclass-wizard     0.033917
-    benchmarks.simple.simple - [INFO] dataclass-factory    0.103837
-    benchmarks.simple.simple - [INFO] dataclasses-json     3.941902
-    benchmarks.simple.simple - [INFO] jsons                5.636863
-    benchmarks.simple.simple - [INFO] dacite               0.572661
-    benchmarks.simple.simple - [INFO] pydantic             0.081108
-    benchmarks.simple.simple - [INFO] marshmallow          2.550217
-    benchmarks.simple.simple - [INFO] attrs                0.022822
-    benchmarks.simple.simple - [INFO] mashumaro            0.046641
+    benchmarks.simple.simple - [INFO] dataclass-wizard     0.030784
+    benchmarks.simple.simple - [INFO] dataclass-factory    0.103156
+    benchmarks.simple.simple - [INFO] dataclasses-json     3.512702
+    benchmarks.simple.simple - [INFO] jsons                4.709339
+    benchmarks.simple.simple - [INFO] dacite               0.468830
+    benchmarks.simple.simple - [INFO] pydantic             0.071347
+    benchmarks.simple.simple - [INFO] marshmallow          2.155037
+    benchmarks.simple.simple - [INFO] attrs                0.020167
+    benchmarks.simple.simple - [INFO] mashumaro            0.041291
     """
     g = globals().copy()
     g.update(locals())
@@ -131,30 +131,18 @@ def test_dump(data, n):
     """
     [ RESULTS ON MAC OS X ]
 
-    benchmarks.simple.simple - [INFO] dataclass-wizard     0.072549
-    benchmarks.simple.simple - [INFO] asdict (dataclasses) 0.101621
-    benchmarks.simple.simple - [INFO] dataclass-factory    0.087357
-    benchmarks.simple.simple - [INFO] dataclasses-json     1.488334
-    benchmarks.simple.simple - [INFO] jsons                8.550752
+    benchmarks.simple.simple - [INFO] dataclass-wizard     0.024619
+    benchmarks.simple.simple - [INFO] asdict (dataclasses) 0.093137
+    benchmarks.simple.simple - [INFO] dataclass-factory    0.188235
+    benchmarks.simple.simple - [INFO] dataclasses-json     1.294685
+    benchmarks.simple.simple - [INFO] jsons                6.913666
     benchmarks.simple.simple - [INFO] dacite (not applicable) -- skipped
-    benchmarks.simple.simple - [INFO] pydantic             0.080157
-    benchmarks.simple.simple - [INFO] marshmallow          0.000578
-    benchmarks.simple.simple - [INFO] attrs                0.146561
-    benchmarks.simple.simple - [INFO] mashumaro            0.010199
+    benchmarks.simple.simple - [INFO] pydantic             0.066996
+    benchmarks.simple.simple - [INFO] marshmallow          0.000519
+    benchmarks.simple.simple - [INFO] attrs                0.122752
+    benchmarks.simple.simple - [INFO] mashumaro            0.008702
     """
 
-    # [ RESULTS ]
-    # benchmarks.simple.simple - [INFO] dataclass-wizard     0.065604
-    # benchmarks.simple.simple - [INFO] asdict (dataclasses) 0.087785
-    # benchmarks.simple.simple - [INFO] dataclass-factory    0.084215
-    # benchmarks.simple.simple - [INFO] dataclasses-json     1.278573
-    # benchmarks.simple.simple - [INFO] jsons                6.192119
-    # benchmarks.simple.simple - [INFO] dacite (not applicable) -- skipped
-    # benchmarks.simple.simple - [INFO] pydantic             0.066679
-    # benchmarks.simple.simple - [INFO] marshmallow          0.000481
-    # benchmarks.simple.simple - [INFO] attrs                0.122282
-    # benchmarks.simple.simple - [INFO] mashumaro            0.009025
-
     c1 = MyClassWizard.from_dict(data)
     c2 = factory.load(data, MyClass)
     c3 = MyClassDJ.from_dict(data)

dataclass_wizard/__init__.py

@@ -70,6 +70,7 @@
 
 __all__ = [
     # Base exports
+    'DataclassWizard',
     'JSONSerializable',
     'JSONPyWizard',
     'JSONWizard',
@@ -120,17 +121,17 @@
 
 from .bases_meta import LoadMeta, DumpMeta, EnvMeta
 from .constants import PACKAGE_NAME
-from .dumpers import DumpMixin, setup_default_dumper, asdict
+from .dumpers import DumpMixin, setup_default_dumper
 from .loaders import LoadMixin, setup_default_loader
-from .loader_selection import fromlist, fromdict
+from .loader_selection import asdict, fromlist, fromdict
 from .models import (env_field, json_field, json_key, path_field, skip_if_field,
                      KeyPath, Container,
                      Pattern, DatePattern, TimePattern, DateTimePattern,
                      CatchAll, SkipIf, SkipIfNone,
                      EQ, NE, LT, LE, GT, GE, IS, IS_NOT, IS_TRUTHY, IS_FALSY)
 from .environ.wizard import EnvWizard
 from .property_wizard import property_wizard
-from .serial_json import JSONWizard, JSONPyWizard, JSONSerializable
+from .serial_json import DataclassWizard, JSONWizard, JSONPyWizard, JSONSerializable
 from .wizard_mixins import JSONListWizard, JSONFileWizard, TOMLWizard, YAMLWizard