wexample-filestate-python 6.7.1__tar.gz → 6.8.1__tar.gz

{wexample_filestate_python-6.7.1 → wexample_filestate_python-6.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-filestate-python
-Version: 6.7.1
+Version: 6.8.1
 Summary: Helpers for Python.
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -20,7 +20,7 @@ Requires-Dist: packaging
 Requires-Dist: pyupgrade
 Requires-Dist: tomli
 Requires-Dist: wexample-api>=6.1.0
-Requires-Dist: wexample-filestate>=11.1.0
+Requires-Dist: wexample-filestate>=11.2.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -28,7 +28,7 @@ Description-Content-Type: text/markdown
 
 # filestate_python
 
-Version: 6.7.1
+Version: 6.8.1
 
 Helpers for Python.
 
@@ -119,7 +119,7 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 - pyupgrade: 
 - tomli: 
 - wexample-api: >=6.1.0
-- wexample-filestate: >=11.1.0
+- wexample-filestate: >=11.2.0
 
 ## Versioning & Compatibility Policy
 

{wexample_filestate_python-6.7.1 → wexample_filestate_python-6.8.1}/README.md

@@ -1,6 +1,6 @@
 # filestate_python
 
-Version: 6.7.1
+Version: 6.8.1
 
 Helpers for Python.
 
@@ -91,7 +91,7 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 - pyupgrade: 
 - tomli: 
 - wexample-api: >=6.1.0
-- wexample-filestate: >=11.1.0
+- wexample-filestate: >=11.2.0
 
 ## Versioning & Compatibility Policy
 

{wexample_filestate_python-6.7.1 → wexample_filestate_python-6.8.1}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-filestate-python"
-version = "6.7.1"
+version = "6.8.1"
 description = "Helpers for Python."
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -29,7 +29,7 @@ dependencies = [
     "pyupgrade",
     "tomli",
     "wexample-api>=6.1.0",
-    "wexample-filestate>=11.1.0",
+    "wexample-filestate>=11.2.0",
 ]
 
 [project.readme]

{wexample_filestate_python-6.7.1 → wexample_filestate_python-6.8.1}/src/wexample_filestate_python/utils/python_class_attributes_utils.py

@@ -229,10 +229,24 @@ def _is_comment_line(node: cst.CSTNode) -> bool:
 
 
 def _is_dataclass(classdef: cst.ClassDef) -> bool:
-    """Detect if class has a @dataclass decorator (dataclass or dataclasses.dataclass)."""
+    """Detect if class needs "required-first" field ordering.
+
+    Triggers on:
+      - ``@dataclass`` / ``@dataclasses.dataclass`` decorator (incl. parenthesized form)
+      - ``NamedTuple`` / ``typing.NamedTuple`` in the base classes
+
+    For both kinds, Python enforces that fields without a default appear
+    before fields with a default. The plain alphabetical sort applied
+    otherwise would silently swap them and raise ``TypeError`` at class
+    creation time (NamedTuple) or produce surprising defaults (dataclass).
+    """
+    # Decorators: @dataclass, @dataclasses.dataclass, @dataclass(...), @dataclasses.dataclass(...)
     for dec in classdef.decorators:
         try:
             expr = dec.decorator
+            # Unwrap parenthesized decorator calls like @dataclass(frozen=True)
+            if isinstance(expr, cst.Call):
+                expr = expr.func
             if isinstance(expr, cst.Name) and expr.value == "dataclass":
                 return True
             if isinstance(expr, cst.Attribute) and isinstance(expr.attr, cst.Name):
@@ -240,6 +254,17 @@ def _is_dataclass(classdef: cst.ClassDef) -> bool:
                     return True
         except Exception:
             continue
+    # Base classes: NamedTuple / typing.NamedTuple
+    for base in classdef.bases:
+        try:
+            expr = base.value
+            if isinstance(expr, cst.Name) and expr.value == "NamedTuple":
+                return True
+            if isinstance(expr, cst.Attribute) and isinstance(expr.attr, cst.Name):
+                if expr.attr.value == "NamedTuple":
+                    return True
+        except Exception:
+            continue
     return False