wexample-filestate-python 6.7.0__tar.gz → 6.8.0__tar.gz

{wexample_filestate_python-6.7.0 → wexample_filestate_python-6.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-filestate-python
-Version: 6.7.0
+Version: 6.8.0
 Summary: Helpers for Python.
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -28,7 +28,7 @@ Description-Content-Type: text/markdown
 
 # filestate_python
 
-Version: 6.7.0
+Version: 6.8.0
 
 Helpers for Python.
 

{wexample_filestate_python-6.7.0 → wexample_filestate_python-6.8.0}/README.md

@@ -1,6 +1,6 @@
 # filestate_python
 
-Version: 6.7.0
+Version: 6.8.0
 
 Helpers for Python.
 

{wexample_filestate_python-6.7.0 → wexample_filestate_python-6.8.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-filestate-python"
-version = "6.7.0"
+version = "6.8.0"
 description = "Helpers for Python."
 authors = [
     { name = "weeger", email = "contact@wexample.com" },

{wexample_filestate_python-6.7.0 → wexample_filestate_python-6.8.0}/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