wexample-filestate-python 0.0.45__tar.gz → 0.0.55__tar.gz

wexample_filestate_python-0.0.45/README.md → wexample_filestate_python-0.0.55/PKG-INFO

@@ -1,9 +1,86 @@
+Metadata-Version: 2.1
+Name: wexample-filestate-python
+Version: 0.0.55
+Summary: Helpers for Python.
+Author-Email: weeger <contact@wexample.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Project-URL: homepage, https://github.com/wexample/python-filestate-python
+Requires-Python: >=3.10
+Requires-Dist: attrs>=23.1.0
+Requires-Dist: autoflake
+Requires-Dist: black
+Requires-Dist: cattrs>=23.1.0
+Requires-Dist: flynt
+Requires-Dist: isort
+Requires-Dist: libcst
+Requires-Dist: packaging
+Requires-Dist: pyupgrade
+Requires-Dist: tomli
+Requires-Dist: wexample-api==0.0.78
+Requires-Dist: wexample-filestate==0.0.69
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Description-Content-Type: text/markdown
+
 # wexample-filestate-python
 
-Version: 0.0.45
+Version: 0.0.55
 
 Helpers for Python.
 
+## Tests
+
+This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
+
+### Installation
+
+First, install the required testing dependencies:
+```bash
+.venv/bin/python -m pip install pytest pytest-cov
+```
+
+### Basic Usage
+
+Run all tests with coverage:
+```bash
+.venv/bin/python -m pytest --cov --cov-report=html
+```
+
+### Common Commands
+```bash
+# Run tests with coverage for a specific module
+.venv/bin/python -m pytest --cov=your_module
+
+# Show which lines are not covered
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
+
+# Generate an HTML coverage report
+.venv/bin/python -m pytest --cov=your_module --cov-report=html
+
+# Combine terminal and HTML reports
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
+
+# Run specific test file with coverage
+.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
+```
+
+### Viewing HTML Reports
+
+After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
+
+### Coverage Threshold
+
+To enforce a minimum coverage percentage:
+```bash
+.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
+```
+
+This will cause the test suite to fail if coverage drops below 80%.
+
 ## Code Quality & Typing
 
 All the suite packages follow strict quality standards:

wexample_filestate_python-0.0.45/PKG-INFO → wexample_filestate_python-0.0.55/README.md

@@ -1,32 +1,58 @@
-Metadata-Version: 2.1
-Name: wexample-filestate-python
-Version: 0.0.45
-Summary: Helpers for Python.
-Author-Email: weeger <contact@wexample.com>
-License: MIT
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Project-URL: homepage, https://github.com/wexample/python-filestate-python
-Requires-Python: >=3.10
-Requires-Dist: attrs>=23.1.0
-Requires-Dist: cattrs>=23.1.0
-Requires-Dist: libcst
-Requires-Dist: packaging
-Requires-Dist: tomli
-Requires-Dist: wexample-filestate==0.0.56
-Requires-Dist: wexample-helpers-api==0.0.37
-Provides-Extra: dev
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: pytest-cov; extra == "dev"
-Description-Content-Type: text/markdown
-
 # wexample-filestate-python
 
-Version: 0.0.45
+Version: 0.0.55
 
 Helpers for Python.
 
+## Tests
+
+This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
+
+### Installation
+
+First, install the required testing dependencies:
+```bash
+.venv/bin/python -m pip install pytest pytest-cov
+```
+
+### Basic Usage
+
+Run all tests with coverage:
+```bash
+.venv/bin/python -m pytest --cov --cov-report=html
+```
+
+### Common Commands
+```bash
+# Run tests with coverage for a specific module
+.venv/bin/python -m pytest --cov=your_module
+
+# Show which lines are not covered
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
+
+# Generate an HTML coverage report
+.venv/bin/python -m pytest --cov=your_module --cov-report=html
+
+# Combine terminal and HTML reports
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
+
+# Run specific test file with coverage
+.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
+```
+
+### Viewing HTML Reports
+
+After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
+
+### Coverage Threshold
+
+To enforce a minimum coverage percentage:
+```bash
+.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
+```
+
+This will cause the test suite to fail if coverage drops below 80%.
+
 ## Code Quality & Typing
 
 All the suite packages follow strict quality standards:

{wexample_filestate_python-0.0.45 → wexample_filestate_python-0.0.55}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-filestate-python"
-version = "0.0.45"
+version = "0.0.55"
 description = "Helpers for Python."
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -19,12 +19,17 @@ classifiers = [
 ]
 dependencies = [
     "attrs>=23.1.0",
+    "autoflake",
+    "black",
     "cattrs>=23.1.0",
+    "flynt",
+    "isort",
     "libcst",
     "packaging",
+    "pyupgrade",
     "tomli",
-    "wexample-filestate==0.0.56",
-    "wexample-helpers-api==0.0.37",
+    "wexample-api==0.0.78",
+    "wexample-filestate==0.0.69",
 ]
 
 [project.readme]
@@ -43,6 +48,14 @@ dev = [
     "pytest-cov",
 ]
 
+[tool.setuptools.packages.find]
+include = [
+    "*",
+]
+exclude = [
+    "wexample_filestate_python.testing*",
+]
+
 [tool.pdm]
 distribution = true
 
@@ -52,16 +65,42 @@ packages = [
     { include = "wexample_filestate_python", from = "src" },
 ]
 
+[tool.pytest.ini_options]
+testpaths = [
+    "tests",
+]
+pythonpath = [
+    "src",
+]
+
+[tool.coverage.run]
+source = [
+    "wexample_filestate_python",
+]
+omit = [
+    "*/tests/*",
+    "*/.venv/*",
+    "*/venv/*",
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "@abstractmethod",
+]
+
 [tool.filestate]
 keep = [
+    "autoflake",
     "black",
+    "libcst",
+    "tomli",
+    "pyupgrade",
     "isort",
-]
-
-[tool.setuptools.packages.find]
-include = [
-    "*",
-]
-exclude = [
-    "wexample_filestate_python.testing*",
+    "flynt",
 ]

{wexample_filestate_python-0.0.45 → wexample_filestate_python-0.0.55}/src/wexample_filestate_python/common/pipy_gateway.py

@@ -1,8 +1,8 @@
 from __future__ import annotations
 
+from wexample_api.common.abstract_gateway import AbstractGateway
 from wexample_helpers.classes.field import public_field
 from wexample_helpers.decorator.base_class import base_class
-from wexample_helpers_api.common.abstract_gateway import AbstractGateway
 
 
 @base_class

wexample_filestate_python-0.0.55/src/wexample_filestate_python/const/path.py

@@ -0,0 +1,6 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+PATH_DIR_SRC: Path = Path("src")
+PATH_DIR_TESTS: Path = Path("tests")

wexample_filestate_python-0.0.55/src/wexample_filestate_python/const/python_file.py

@@ -0,0 +1,6 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+PYTHON_FILE_PYTEST_COVERAGE_JSON: Path = Path("coverage.json")
+PYTHON_FILE_EXTENSION = "py"

{wexample_filestate_python-0.0.45/src/wexample_filestate_python/option → wexample_filestate_python-0.0.55/src/wexample_filestate_python/option/python}/abstract_python_file_content_option.py

@@ -3,6 +3,8 @@ from __future__ import annotations
 from typing import TYPE_CHECKING, Any
 
 from wexample_config.config_option.abstract_config_option import AbstractConfigOption
+from wexample_filestate.enum.scopes import Scope
+from wexample_filestate.operation.abstract_operation import AbstractOperation
 from wexample_filestate.option.mixin.option_mixin import OptionMixin
 from wexample_helpers.classes.abstract_method import abstract_method
 from wexample_helpers.decorator.base_class import base_class
@@ -18,7 +20,7 @@ class AbstractPythonFileContentOption(OptionMixin, AbstractConfigOption):
         return bool
 
     def create_required_operation(
-        self, target: TargetFileOrDirectoryType
+        self, target: TargetFileOrDirectoryType, scopes: set[Scope]
     ) -> AbstractOperation | None:
         from wexample_filestate.operation.file_write_operation import FileWriteOperation
 

wexample_filestate_python-0.0.55/src/wexample_filestate_python/option/python/class_name_matches_file_name_option.py

@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+import ast
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from wexample_config.config_option.abstract_config_option import AbstractConfigOption
+from wexample_filestate.enum.scopes import Scope
+from wexample_filestate.operation.abstract_operation import AbstractOperation
+from wexample_filestate.option.mixin.option_mixin import OptionMixin
+from wexample_helpers.decorator.base_class import base_class
+
+if TYPE_CHECKING:
+    from wexample_filestate.const.types_state_items import TargetFileOrDirectoryType
+
+
+@base_class
+class ClassNameMatchesFileNameOption(OptionMixin, AbstractConfigOption):
+    @staticmethod
+    def _expected_class_name_from_path(path: Path) -> str | None:
+        stem = path.stem
+        if not stem or stem == "__init__":
+            return None
+
+        cleaned = stem.replace("-", "_")
+        parts = [part for part in cleaned.split("_") if part]
+        if not parts:
+            return None
+
+        def normalize(part: str) -> str:
+            head, tail = part[:1], part[1:]
+            return head.upper() + tail.lower()
+
+        return "".join(normalize(part) for part in parts)
+
+    def create_required_operation(
+        self, target: TargetFileOrDirectoryType, scopes: set[Scope]
+    ) -> AbstractOperation | None:
+        del scopes  # unused
+
+        if not self._class_name_matches_file_name(target=target):
+            # TODO
+            print(f" CORRECT {target.get_path()}")
+
+        return None
+
+    def get_description(self) -> str:
+        return "File name should be a pascal-case version of the class name"
+
+    def _class_name_matches_file_name(self, target: TargetFileOrDirectoryType) -> bool:
+        expected_name = self._expected_class_name_from_path(path=target.get_path())
+
+        if expected_name is None:
+            return False
+
+        source = target.get_local_file().read()
+        try:
+            module = ast.parse(source)
+        except SyntaxError:
+            return False
+
+        for node in module.body:
+            if isinstance(node, ast.ClassDef) and node.name == expected_name:
+                return True
+        return False

{wexample_filestate_python-0.0.45/src/wexample_filestate_python/option → wexample_filestate_python-0.0.55/src/wexample_filestate_python/option/python}/relocate_imports_option.py

@@ -152,11 +152,16 @@ class RelocateImportsOption(AbstractPythonFileContentOption):
 
         # For names used inside cast() anywhere in the module:
         # - do NOT auto-add to TYPE_CHECKING (unless also in annotations via type_only_for_block)
-        # - remove module-level import unless also class_level
+        # - remove module-level import unless also class_level or runtime_used_anywhere
+        # Exclude names used at runtime at module level (e.g., TerminalColor.RED in dict values)
         names_to_remove_from_module = (
-            set(runtime_local_final)
+            (set(runtime_local_final) - runtime_used_anywhere)
             | set(type_only_names)
-            | (set(cast_type_names_anywhere) - set(class_level_names))
+            | (
+                set(cast_type_names_anywhere)
+                - set(class_level_names)
+                - runtime_used_anywhere
+            )
         )
 
         # Do not add to TYPE_CHECKING if the name's module-level import is kept

{wexample_filestate_python-0.0.45/src/wexample_filestate_python/option → wexample_filestate_python-0.0.55/src/wexample_filestate_python/option/python}/remove_unused_option.py

@@ -18,16 +18,17 @@ class RemoveUnusedOption(AbstractPythonFileContentOption):
     def _apply_content_change(self, target: TargetFileOrDirectoryType) -> str:
         """Remove unused Python imports using autoflake."""
         from wexample_helpers.helpers.shell import shell_run
+        from wexample_helpers.helpers.system import system_get_venv_bin_path
 
         result = shell_run(
             cmd=[
-                "autoflake",
+                f"{system_get_venv_bin_path()}/autoflake",
                 "--stdout",
                 "--remove-all-unused-imports",
                 "--remove-unused-variables",
                 "--expand-star-imports",
                 "--remove-duplicate-keys",
-                target.get_path(),
+                str(target.get_path()),
             ],
         )
 

wexample_filestate_python-0.0.55/src/wexample_filestate_python/option/python_option.py

@@ -0,0 +1,133 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Union
+
+from wexample_config.config_option.abstract_config_option import AbstractConfigOption
+from wexample_config.config_option.abstract_nested_config_option import (
+    AbstractNestedConfigOption,
+)
+from wexample_filestate.enum.scopes import Scope
+from wexample_filestate.operation.abstract_operation import AbstractOperation
+from wexample_filestate.option.mixin.option_mixin import OptionMixin
+from wexample_helpers.decorator.base_class import base_class
+
+if TYPE_CHECKING:
+    from wexample_filestate.const.types_state_items import TargetFileOrDirectoryType
+
+
+@base_class
+class PythonOption(OptionMixin, AbstractNestedConfigOption):
+    @staticmethod
+    def get_raw_value_allowed_type() -> Any:
+        from wexample_filestate_python.config_value.python_config_value import (
+            PythonConfigValue,
+        )
+
+        return Union[list[str], dict, PythonConfigValue]
+
+    def create_required_operation(
+        self, target: TargetFileOrDirectoryType, scopes: set[Scope]
+    ) -> AbstractOperation | None:
+        return self._create_child_required_operation(target=target, scopes=scopes)
+
+    def get_allowed_options(self) -> list[type[AbstractConfigOption]]:
+        # Import all the config options for each Python operation
+        from wexample_filestate_python.option.python.add_future_annotations_option import (
+            AddFutureAnnotationsOption,
+        )
+        from wexample_filestate_python.option.python.add_return_types_option import (
+            AddReturnTypesOption,
+        )
+        from wexample_filestate_python.option.python.class_name_matches_file_name_option import (
+            ClassNameMatchesFileNameOption,
+        )
+        from wexample_filestate_python.option.python.fix_attrs_option import (
+            FixAttrsOption,
+        )
+        from wexample_filestate_python.option.python.fix_blank_lines_option import (
+            FixBlankLinesOption,
+        )
+        from wexample_filestate_python.option.python.format_option import FormatOption
+        from wexample_filestate_python.option.python.fstringify_option import (
+            FstringifyOption,
+        )
+        from wexample_filestate_python.option.python.modernize_typing_option import (
+            ModernizeTypingOption,
+        )
+        from wexample_filestate_python.option.python.order_class_attributes_option import (
+            OrderClassAttributesOption,
+        )
+        from wexample_filestate_python.option.python.order_class_docstring_option import (
+            OrderClassDocstringOption,
+        )
+        from wexample_filestate_python.option.python.order_class_methods_option import (
+            OrderClassMethodsOption,
+        )
+        from wexample_filestate_python.option.python.order_constants_option import (
+            OrderConstantsOption,
+        )
+        from wexample_filestate_python.option.python.order_iterable_items_option import (
+            OrderIterableItemsOption,
+        )
+        from wexample_filestate_python.option.python.order_main_guard_option import (
+            OrderMainGuardOption,
+        )
+        from wexample_filestate_python.option.python.order_module_docstring_option import (
+            OrderModuleDocstringOption,
+        )
+        from wexample_filestate_python.option.python.order_module_functions_option import (
+            OrderModuleFunctionsOption,
+        )
+        from wexample_filestate_python.option.python.order_module_metadata_option import (
+            OrderModuleMetadataOption,
+        )
+        from wexample_filestate_python.option.python.order_type_checking_block_option import (
+            OrderTypeCheckingBlockOption,
+        )
+        from wexample_filestate_python.option.python.relocate_imports_option import (
+            RelocateImportsOption,
+        )
+        from wexample_filestate_python.option.python.remove_unused_option import (
+            RemoveUnusedOption,
+        )
+        from wexample_filestate_python.option.python.sort_imports_option import (
+            SortImportsOption,
+        )
+        from wexample_filestate_python.option.python.unquote_annotations_option import (
+            UnquoteAnnotationsOption,
+        )
+
+        return [
+            AddFutureAnnotationsOption,
+            AddReturnTypesOption,
+            ClassNameMatchesFileNameOption,
+            FixAttrsOption,
+            FixBlankLinesOption,
+            FormatOption,
+            FstringifyOption,
+            ModernizeTypingOption,
+            OrderClassAttributesOption,
+            OrderClassDocstringOption,
+            OrderClassMethodsOption,
+            OrderConstantsOption,
+            OrderIterableItemsOption,
+            OrderMainGuardOption,
+            OrderModuleDocstringOption,
+            OrderModuleFunctionsOption,
+            OrderModuleMetadataOption,
+            OrderTypeCheckingBlockOption,
+            RelocateImportsOption,
+            RemoveUnusedOption,
+            SortImportsOption,
+            UnquoteAnnotationsOption,
+        ]
+
+    def set_value(self, raw_value: Any) -> None:
+        # Convert list form to dict form for consistency
+        if isinstance(raw_value, list):
+            dict_value = {}
+            for option_name in raw_value:
+                dict_value[option_name] = True
+            raw_value = dict_value
+
+        super().set_value(raw_value=raw_value)

{wexample_filestate_python-0.0.45 → wexample_filestate_python-0.0.55}/src/wexample_filestate_python/utils/relocate_imports/python_localize_runtime_imports.py

@@ -27,6 +27,7 @@ class PythonLocalizeRuntimeImports(cst.CSTTransformer):
         self.functions_needing_local = functions_needing_local
         self.skip_local_names = skip_local_names or set()
         self.class_stack: list[str] = []
+        self.func_stack: list[str] = []
 
     @staticmethod
     def _build_module_expr(mod: str | None) -> cst.BaseExpression | None:
@@ -63,10 +64,11 @@ class PythonLocalizeRuntimeImports(cst.CSTTransformer):
         self, original_node: cst.AsyncFunctionDef, updated_node: cst.AsyncFunctionDef
     ) -> cst.AsyncFunctionDef:
         func_qname = (
-            ".".join(self.class_stack + [original_node.name.value])
-            if self.class_stack
+            ".".join(self.class_stack + self.func_stack + [original_node.name.value])
+            if (self.class_stack or self.func_stack)
             else original_node.name.value
         )
+        self.func_stack.pop()
         to_inject, pairs = self._build_local_imports(func_qname)
         if not to_inject:
             return updated_node
@@ -160,10 +162,11 @@ class PythonLocalizeRuntimeImports(cst.CSTTransformer):
         self, original_node: cst.FunctionDef, updated_node: cst.FunctionDef
     ) -> cst.FunctionDef:
         func_qname = (
-            ".".join(self.class_stack + [original_node.name.value])
-            if self.class_stack
+            ".".join(self.class_stack + self.func_stack + [original_node.name.value])
+            if (self.class_stack or self.func_stack)
             else original_node.name.value
         )
+        self.func_stack.pop()
         # Build consolidated imports and list of pairs to hoist
         to_inject, pairs = self._build_local_imports(func_qname)
         if not to_inject:
@@ -251,10 +254,18 @@ class PythonLocalizeRuntimeImports(cst.CSTTransformer):
             body=pruned_node.body.with_changes(body=new_body)
         )
 
+    def visit_AsyncFunctionDef(self, node: cst.AsyncFunctionDef) -> bool:  # type: ignore[override]
+        self.func_stack.append(node.name.value)
+        return True
+
     def visit_ClassDef(self, node: cst.ClassDef) -> bool:  # type: ignore[override]
         self.class_stack.append(node.name.value)
         return True
 
+    def visit_FunctionDef(self, node: cst.FunctionDef) -> bool:  # type: ignore[override]
+        self.func_stack.append(node.name.value)
+        return True
+
     def _build_import_statements_from_pairs(
         self, pairs: set[tuple[str | None, str]]
     ) -> list[cst.BaseStatement]:

{wexample_filestate_python-0.0.45 → wexample_filestate_python-0.0.55}/src/wexample_filestate_python/utils/relocate_imports/python_runtime_symbol_collector.py

@@ -25,9 +25,31 @@ class PythonRuntimeSymbolCollector(cst.CSTVisitor):
         self.in_annotation_stack.append(True)
         return True
 
+    def visit_Attribute(self, node: cst.Attribute) -> bool:  # type: ignore[override]
+        """Visit Attribute nodes to detect runtime usage of imported names.
+
+        For example, in TerminalColor.RED, we need to mark TerminalColor as runtime-used.
+        """
+        if self.in_annotation_stack:
+            return True
+        # Walk the value (left side) to find the base name
+        self._walk_for_runtime_names(node.value)
+        return False  # Don't visit children since we handled it manually
+
     def visit_Name(self, node: cst.Name) -> None:  # type: ignore[override]
         if self.in_annotation_stack:
             return
         val = node.value
         if val in self.imported_value_names:
             self.runtime_used_anywhere.add(val)
+
+    def _walk_for_runtime_names(self, expr: cst.BaseExpression) -> None:
+        """Recursively walk an expression to find imported names used at runtime."""
+        if isinstance(expr, cst.Name):
+            if expr.value in self.imported_value_names:
+                self.runtime_used_anywhere.add(expr.value)
+        elif isinstance(expr, cst.Attribute):
+            # Recurse into the value (left side) only
+            self._walk_for_runtime_names(expr.value)
+        elif isinstance(expr, cst.Subscript):
+            self._walk_for_runtime_names(expr.value)

{wexample_filestate_python-0.0.45 → wexample_filestate_python-0.0.55}/src/wexample_filestate_python/utils/relocate_imports/python_usage_collector.py

@@ -341,7 +341,13 @@ class PythonUsageCollector(cst.CSTVisitor):
 
     # ----- internals -----
     def _qualified_func_name(self, base: str) -> str:
-        return ".".join(self.class_stack + [base]) if self.class_stack else base
+        # Include func_stack to distinguish nested functions with the same name
+        # e.g., ScreenExample.demo_with_progress_and_confirm._callback vs ScreenExample.example_extended._callback
+        return (
+            ".".join(self.class_stack + self.func_stack + [base])
+            if (self.class_stack or self.func_stack)
+            else base
+        )
 
     def _record_type_names(self, ann: cst.BaseExpression, bucket: set[str]) -> None:
         if isinstance(ann, cst.Name):

wexample_filestate_python-0.0.45/src/wexample_filestate_python/option/python_option.py

@@ -1,164 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Any, ClassVar, Union
-
-from wexample_config.config_option.abstract_config_option import AbstractConfigOption
-from wexample_config.config_option.abstract_nested_config_option import (
-    AbstractNestedConfigOption,
-)
-from wexample_filestate.operation.abstract_operation import AbstractOperation
-from wexample_filestate.option.mixin.option_mixin import OptionMixin
-from wexample_helpers.decorator.base_class import base_class
-
-if TYPE_CHECKING:
-    from wexample_filestate.const.types_state_items import TargetFileOrDirectoryType
-
-
-@base_class
-class PythonOption(OptionMixin, AbstractNestedConfigOption):
-    # filestate: python-constant-sort
-    # New preferred option name to add `from __future__ import annotations`
-    OPTION_NAME_ADD_FUTURE_ANNOTATIONS: ClassVar[str] = "add_future_annotations"
-    OPTION_NAME_ADD_RETURN_TYPES: ClassVar[str] = "add_return_types"
-    # Fix attrs usage (ensure kw_only=True, etc.)
-    OPTION_NAME_FIX_ATTRS: ClassVar[str] = "fix_attrs"
-    # Fix blank lines in Python files (after signatures, docstrings, etc.)
-    OPTION_NAME_FIX_BLANK_LINES: ClassVar[str] = "fix_blank_lines"
-    OPTION_NAME_FORMAT: ClassVar[str] = "format"
-    OPTION_NAME_FSTRINGIFY: ClassVar[str] = "fstringify"
-    OPTION_NAME_MODERNIZE_TYPING: ClassVar[str] = "modernize_typing"
-    # Sort class attributes: special first, then public A–Z, then private/protected A–Z
-    OPTION_NAME_ORDER_CLASS_ATTRIBUTES: ClassVar[str] = "order_class_attributes"
-    # Ensure class docstring is first statement after header/decorators
-    OPTION_NAME_ORDER_CLASS_DOCSTRING: ClassVar[str] = "order_class_docstring"
-    # Order class methods (dunders sequence, class/staticmethods, properties, instances)
-    OPTION_NAME_ORDER_CLASS_METHODS: ClassVar[str] = "order_class_methods"
-    # Sort flagged UPPER_CASE constant blocks at module level
-    OPTION_NAME_ORDER_CONSTANTS: ClassVar[str] = "order_constants"
-    # Sort items inside flagged iterable literals (lists/dicts)
-    OPTION_NAME_ORDER_ITERABLE_ITEMS: ClassVar[str] = "order_iterable_items"
-    # Ensure if __name__ == "__main__" block is at the very end
-    OPTION_NAME_ORDER_MAIN_GUARD: ClassVar[str] = "order_main_guard"
-    # Order module docstring to be at the top of the file
-    OPTION_NAME_ORDER_MODULE_DOCSTRING: ClassVar[str] = "order_module_docstring"
-    # Order module-level functions (public A–Z, then private)
-    OPTION_NAME_ORDER_MODULE_FUNCTIONS: ClassVar[str] = "order_module_functions"
-    # Group and sort module metadata at module level
-    OPTION_NAME_ORDER_MODULE_METADATA: ClassVar[str] = "order_module_metadata"
-    # Normalize blank lines between program structures (spacing rules)
-    OPTION_NAME_ORDER_SPACING: ClassVar[str] = "order_spacing"
-    # Move TYPE_CHECKING blocks to after regular imports
-    OPTION_NAME_ORDER_TYPE_CHECKING_BLOCK: ClassVar[str] = "order_type_checking_block"
-    # Relocate imports by usage (runtime-in-method, class property types, type-only)
-    OPTION_NAME_RELOCATE_IMPORTS: ClassVar[str] = "relocate_imports"
-    OPTION_NAME_REMOVE_UNUSED: ClassVar[str] = "remove_unused"
-    OPTION_NAME_SORT_IMPORTS: ClassVar[str] = "sort_imports"
-    # New policy: unquote annotations (remove string annotations)
-    OPTION_NAME_UNQUOTE_ANNOTATIONS: ClassVar[str] = "unquote_annotations"
-
-    @staticmethod
-    def get_raw_value_allowed_type() -> Any:
-        from wexample_filestate_python.config_value.python_config_value import (
-            PythonConfigValue,
-        )
-
-        return Union[list[str], dict, PythonConfigValue]
-
-    def create_required_operation(
-        self, target: TargetFileOrDirectoryType
-    ) -> AbstractOperation | None:
-        return self._create_child_required_operation(target=target)
-
-    def get_allowed_options(self) -> list[type[AbstractConfigOption]]:
-        # Import all the config options for each Python operation
-        from wexample_filestate_python.option.add_future_annotations_option import (
-            AddFutureAnnotationsOption,
-        )
-        from wexample_filestate_python.option.add_return_types_option import (
-            AddReturnTypesOption,
-        )
-        from wexample_filestate_python.option.fix_attrs_option import FixAttrsOption
-        from wexample_filestate_python.option.fix_blank_lines_option import (
-            FixBlankLinesOption,
-        )
-        from wexample_filestate_python.option.format_option import FormatOption
-        from wexample_filestate_python.option.fstringify_option import FstringifyOption
-        from wexample_filestate_python.option.modernize_typing_option import (
-            ModernizeTypingOption,
-        )
-        from wexample_filestate_python.option.order_class_attributes_option import (
-            OrderClassAttributesOption,
-        )
-        from wexample_filestate_python.option.order_class_docstring_option import (
-            OrderClassDocstringOption,
-        )
-        from wexample_filestate_python.option.order_class_methods_option import (
-            OrderClassMethodsOption,
-        )
-        from wexample_filestate_python.option.order_constants_option import (
-            OrderConstantsOption,
-        )
-        from wexample_filestate_python.option.order_iterable_items_option import (
-            OrderIterableItemsOption,
-        )
-        from wexample_filestate_python.option.order_main_guard_option import (
-            OrderMainGuardOption,
-        )
-        from wexample_filestate_python.option.order_module_docstring_option import (
-            OrderModuleDocstringOption,
-        )
-        from wexample_filestate_python.option.order_module_functions_option import (
-            OrderModuleFunctionsOption,
-        )
-        from wexample_filestate_python.option.order_module_metadata_option import (
-            OrderModuleMetadataOption,
-        )
-        from wexample_filestate_python.option.order_type_checking_block_option import (
-            OrderTypeCheckingBlockOption,
-        )
-        from wexample_filestate_python.option.relocate_imports_option import (
-            RelocateImportsOption,
-        )
-        from wexample_filestate_python.option.remove_unused_option import (
-            RemoveUnusedOption,
-        )
-        from wexample_filestate_python.option.sort_imports_option import (
-            SortImportsOption,
-        )
-        from wexample_filestate_python.option.unquote_annotations_option import (
-            UnquoteAnnotationsOption,
-        )
-
-        return [
-            AddFutureAnnotationsOption,
-            AddReturnTypesOption,
-            FixAttrsOption,
-            FixBlankLinesOption,
-            FormatOption,
-            FstringifyOption,
-            ModernizeTypingOption,
-            OrderClassAttributesOption,
-            OrderClassDocstringOption,
-            OrderClassMethodsOption,
-            OrderConstantsOption,
-            OrderIterableItemsOption,
-            OrderMainGuardOption,
-            OrderModuleDocstringOption,
-            OrderModuleFunctionsOption,
-            OrderModuleMetadataOption,
-            OrderTypeCheckingBlockOption,
-            RelocateImportsOption,
-            RemoveUnusedOption,
-            SortImportsOption,
-            UnquoteAnnotationsOption,
-        ]
-
-    def set_value(self, raw_value: Any) -> None:
-        # Convert list form to dict form for consistency
-        if isinstance(raw_value, list):
-            dict_value = {}
-            for option_name in raw_value:
-                dict_value[option_name] = True
-            raw_value = dict_value
-
-        super().set_value(raw_value=raw_value)