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

{wexample_filestate_python-0.0.55 → wexample_filestate_python-0.0.57}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-filestate-python
-Version: 0.0.55
+Version: 0.0.57
 Summary: Helpers for Python.
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -19,8 +19,8 @@ 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
+Requires-Dist: wexample-api==0.0.81
+Requires-Dist: wexample-filestate==0.0.72
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -28,10 +28,49 @@ Description-Content-Type: text/markdown
 
 # wexample-filestate-python
 
-Version: 0.0.55
+Version: 0.0.57
 
 Helpers for Python.
 
+## Table of Contents
+
+- [Status Compatibility](#status-compatibility)
+- [Api Reference](#api-reference)
+- [Tests](#tests)
+- [Code Quality](#code-quality)
+- [Versioning](#versioning)
+- [Changelog](#changelog)
+- [Migration Notes](#migration-notes)
+- [Roadmap](#roadmap)
+- [Security](#security)
+- [Privacy](#privacy)
+- [Support](#support)
+- [Contribution Guidelines](#contribution-guidelines)
+- [Maintainers](#maintainers)
+- [License](#license)
+- [Useful Links](#useful-links)
+- [Suite Integration](#suite-integration)
+- [Compatibility Matrix](#compatibility-matrix)
+- [Dependencies](#dependencies)
+- [Suite Signature](#suite-signature)
+
+
+## Status & Compatibility
+
+**Maturity**: Production-ready
+
+**Python Support**: >=3.10
+
+**OS Support**: Linux, macOS, Windows
+
+**Status**: Actively maintained
+
+## API Reference
+
+Full API documentation is available in the source code docstrings.
+
+Key modules and classes are documented with type hints for better IDE support.
+
 ## Tests
 
 This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
@@ -118,13 +157,13 @@ Breaking changes are clearly documented with upgrade paths and examples.
 
 Current limitations and planned features are tracked in the GitHub issues.
 
-See the [project roadmap](https://github.com/wexample/python-filestate-python/issues) for upcoming features and improvements.
+See the [project roadmap](https://github.com/wexample/python-filestate_python/issues) for upcoming features and improvements.
 
 ## Security Policy
 
 ### Reporting Vulnerabilities
 
-If you discover a security vulnerability, please email security@wexample.com.
+If you discover a security vulnerability, please email contact@wexample.com.
 
 **Do not** open public issues for security vulnerabilities.
 
@@ -147,7 +186,7 @@ Community support is available through GitHub Discussions.
 
 ## Contribution Guidelines
 
-We welcome contributions to the Wexample suite! 
+We welcome contributions to the Wexample suite!
 
 ### How to Contribute
 
@@ -165,7 +204,9 @@ See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the full list of contributors.
 
 ## License
 
-MIT
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+Free to use in both personal and commercial projects.
 
 ## Useful Links
 
@@ -185,9 +226,31 @@ The suite includes packages for configuration management, file handling, prompts
 
 Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
 
+## Compatibility Matrix
+
+This package is part of the Wexample suite and is compatible with other suite packages.
+
+Refer to each package's documentation for specific version compatibility requirements.
+
+## Dependencies
+
+- attrs: >=23.1.0
+- autoflake: 
+- black: 
+- cattrs: >=23.1.0
+- flynt: 
+- isort: 
+- libcst: 
+- packaging: 
+- pyupgrade: 
+- tomli: 
+- wexample-api: ==0.0.81
+- wexample-filestate: ==0.0.72
+
+
 # About us
 
-Wexample stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
+[Wexample](https://wexample.com) stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
 
 This packages suite embodies this spirit. Trusted by professionals and enthusiasts alike, it delivers a consistent, high-quality foundation for modern development — open, elegant, and battle-tested. Its reputation is built on years of collaboration, refinement, and rigorous attention to detail, making it a natural choice for those who demand both robustness and beauty in their tools.
 

{wexample_filestate_python-0.0.55 → wexample_filestate_python-0.0.57}/README.md

@@ -1,9 +1,48 @@
 # wexample-filestate-python
 
-Version: 0.0.55
+Version: 0.0.57
 
 Helpers for Python.
 
+## Table of Contents
+
+- [Status Compatibility](#status-compatibility)
+- [Api Reference](#api-reference)
+- [Tests](#tests)
+- [Code Quality](#code-quality)
+- [Versioning](#versioning)
+- [Changelog](#changelog)
+- [Migration Notes](#migration-notes)
+- [Roadmap](#roadmap)
+- [Security](#security)
+- [Privacy](#privacy)
+- [Support](#support)
+- [Contribution Guidelines](#contribution-guidelines)
+- [Maintainers](#maintainers)
+- [License](#license)
+- [Useful Links](#useful-links)
+- [Suite Integration](#suite-integration)
+- [Compatibility Matrix](#compatibility-matrix)
+- [Dependencies](#dependencies)
+- [Suite Signature](#suite-signature)
+
+
+## Status & Compatibility
+
+**Maturity**: Production-ready
+
+**Python Support**: >=3.10
+
+**OS Support**: Linux, macOS, Windows
+
+**Status**: Actively maintained
+
+## API Reference
+
+Full API documentation is available in the source code docstrings.
+
+Key modules and classes are documented with type hints for better IDE support.
+
 ## Tests
 
 This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
@@ -90,13 +129,13 @@ Breaking changes are clearly documented with upgrade paths and examples.
 
 Current limitations and planned features are tracked in the GitHub issues.
 
-See the [project roadmap](https://github.com/wexample/python-filestate-python/issues) for upcoming features and improvements.
+See the [project roadmap](https://github.com/wexample/python-filestate_python/issues) for upcoming features and improvements.
 
 ## Security Policy
 
 ### Reporting Vulnerabilities
 
-If you discover a security vulnerability, please email security@wexample.com.
+If you discover a security vulnerability, please email contact@wexample.com.
 
 **Do not** open public issues for security vulnerabilities.
 
@@ -119,7 +158,7 @@ Community support is available through GitHub Discussions.
 
 ## Contribution Guidelines
 
-We welcome contributions to the Wexample suite! 
+We welcome contributions to the Wexample suite!
 
 ### How to Contribute
 
@@ -137,7 +176,9 @@ See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the full list of contributors.
 
 ## License
 
-MIT
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+Free to use in both personal and commercial projects.
 
 ## Useful Links
 
@@ -157,9 +198,31 @@ The suite includes packages for configuration management, file handling, prompts
 
 Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
 
+## Compatibility Matrix
+
+This package is part of the Wexample suite and is compatible with other suite packages.
+
+Refer to each package's documentation for specific version compatibility requirements.
+
+## Dependencies
+
+- attrs: >=23.1.0
+- autoflake: 
+- black: 
+- cattrs: >=23.1.0
+- flynt: 
+- isort: 
+- libcst: 
+- packaging: 
+- pyupgrade: 
+- tomli: 
+- wexample-api: ==0.0.81
+- wexample-filestate: ==0.0.72
+
+
 # About us
 
-Wexample stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
+[Wexample](https://wexample.com) stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
 
 This packages suite embodies this spirit. Trusted by professionals and enthusiasts alike, it delivers a consistent, high-quality foundation for modern development — open, elegant, and battle-tested. Its reputation is built on years of collaboration, refinement, and rigorous attention to detail, making it a natural choice for those who demand both robustness and beauty in their tools.
 

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

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-filestate-python"
-version = "0.0.55"
+version = "0.0.57"
 description = "Helpers for Python."
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -28,8 +28,8 @@ dependencies = [
     "packaging",
     "pyupgrade",
     "tomli",
-    "wexample-api==0.0.78",
-    "wexample-filestate==0.0.69",
+    "wexample-api==0.0.81",
+    "wexample-filestate==0.0.72",
 ]
 
 [project.readme]

wexample_filestate_python-0.0.57/src/wexample_filestate_python/option/python/abstract_python_file_content_option.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+from wexample_filestate.option.abstract_file_content_option import (
+    AbstractFileContentOption,
+)
+from wexample_helpers.decorator.base_class import base_class
+
+
+@base_class
+class AbstractPythonFileContentOption(AbstractFileContentOption):
+    """Base class for Python file content transformation options."""

{wexample_filestate_python-0.0.55 → wexample_filestate_python-0.0.57}/src/wexample_filestate_python/option/python_option.py

@@ -98,6 +98,7 @@ class PythonOption(OptionMixin, AbstractNestedConfigOption):
         )
 
         return [
+            # filestate: python-iterable-sort
             AddFutureAnnotationsOption,
             AddReturnTypesOption,
             ClassNameMatchesFileNameOption,

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

@@ -1,47 +0,0 @@
-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
-
-if TYPE_CHECKING:
-    from wexample_filestate.const.types_state_items import TargetFileOrDirectoryType
-
-
-@base_class
-class AbstractPythonFileContentOption(OptionMixin, AbstractConfigOption):
-    @staticmethod
-    def get_raw_value_allowed_type() -> Any:
-        return bool
-
-    def create_required_operation(
-        self, target: TargetFileOrDirectoryType, scopes: set[Scope]
-    ) -> AbstractOperation | None:
-        from wexample_filestate.operation.file_write_operation import FileWriteOperation
-
-        """Create FileWriteOperation if add_future_annotations is enabled and needed."""
-        # Get current content
-        current_content = target.get_local_file().read()
-
-        # Apply add_future_annotations transformation
-        new_content = self._apply_content_change(target=target)
-
-        # If content changed, create FileWriteOperation
-        if new_content != current_content:
-            return FileWriteOperation(
-                option=self,
-                target=target,
-                content=new_content,
-                description=self.get_description(),
-            )
-
-        return None
-
-    @abstract_method
-    def _apply_content_change(self, target: TargetFileOrDirectoryType) -> None:
-        pass