wexample-filestate-flutter 0.0.13__tar.gz

wexample_filestate_flutter-0.0.13/PKG-INFO

@@ -0,0 +1,236 @@
+Metadata-Version: 2.1
+Name: wexample-filestate-flutter
+Version: 0.0.13
+Author-Email: weeger <contact@wexample.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Requires-Dist: attrs>=23.1.0
+Requires-Dist: cattrs>=23.1.0
+Requires-Dist: wexample-filestate==0.0.72
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Description-Content-Type: text/markdown
+
+# wexample-filestate-flutter
+
+Version: 0.0.13
+
+## 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.
+
+### 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:
+
+- **Type hints**: Full type coverage with mypy validation
+- **Code formatting**: Enforced with black and isort
+- **Linting**: Comprehensive checks with custom scripts and tools
+- **Testing**: High test coverage requirements
+
+These standards ensure reliability and maintainability across the suite.
+
+## Versioning & Compatibility Policy
+
+Wexample packages follow **Semantic Versioning** (SemVer):
+
+- **MAJOR**: Breaking changes
+- **MINOR**: New features, backward compatible
+- **PATCH**: Bug fixes, backward compatible
+
+We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for detailed version history and release notes.
+
+Major changes are documented with migration guides when applicable.
+
+## Migration Notes
+
+When upgrading between major versions, refer to the migration guides in the documentation.
+
+Breaking changes are clearly documented with upgrade paths and examples.
+
+## Known Limitations & Roadmap
+
+Current limitations and planned features are tracked in the GitHub issues.
+
+See the [project roadmap](https://github.com/wexample/python-filestate_flutter/issues) for upcoming features and improvements.
+
+## Security Policy
+
+### Reporting Vulnerabilities
+
+If you discover a security vulnerability, please email contact@wexample.com.
+
+**Do not** open public issues for security vulnerabilities.
+
+We take security seriously and will respond promptly to verified reports.
+
+## Privacy & Telemetry
+
+This package does **not** collect any telemetry or usage data.
+
+Your privacy is respected — no data is transmitted to external services.
+
+## Support Channels
+
+- **GitHub Issues**: Bug reports and feature requests
+- **GitHub Discussions**: Questions and community support
+- **Documentation**: Comprehensive guides and API reference
+- **Email**: contact@wexample.com for general inquiries
+
+Community support is available through GitHub Discussions.
+
+## Contribution Guidelines
+
+We welcome contributions to the Wexample suite!
+
+### How to Contribute
+
+1. **Fork** the repository
+2. **Create** a feature branch
+3. **Make** your changes
+4. **Test** thoroughly
+5. **Submit** a pull request
+
+## Maintainers & Authors
+
+Maintained by the Wexample team and community contributors.
+
+See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the full list of contributors.
+
+## License
+
+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
+
+- **Homepage**: https://github.com/wexample/python-filestate-flutter
+- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
+- **Issue Tracker**: https://github.com/wexample/python-filestate-flutter/issues
+- **Discussions**: https://github.com/wexample/python-filestate-flutter/discussions
+- **PyPI**: [pypi.org/project/wexample-filestate-flutter](https://pypi.org/project/wexample-filestate-flutter/)
+
+## Integration in the Suite
+
+This package is part of the **Wexample Suite** — a collection of high-quality Python packages designed to work seamlessly together.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+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
+- cattrs: >=23.1.0
+- wexample-filestate: ==0.0.72
+
+
+# About us
+
+[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 cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
+

wexample_filestate_flutter-0.0.13/README.md

@@ -0,0 +1,219 @@
+# wexample-filestate-flutter
+
+Version: 0.0.13
+
+## 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.
+
+### 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:
+
+- **Type hints**: Full type coverage with mypy validation
+- **Code formatting**: Enforced with black and isort
+- **Linting**: Comprehensive checks with custom scripts and tools
+- **Testing**: High test coverage requirements
+
+These standards ensure reliability and maintainability across the suite.
+
+## Versioning & Compatibility Policy
+
+Wexample packages follow **Semantic Versioning** (SemVer):
+
+- **MAJOR**: Breaking changes
+- **MINOR**: New features, backward compatible
+- **PATCH**: Bug fixes, backward compatible
+
+We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for detailed version history and release notes.
+
+Major changes are documented with migration guides when applicable.
+
+## Migration Notes
+
+When upgrading between major versions, refer to the migration guides in the documentation.
+
+Breaking changes are clearly documented with upgrade paths and examples.
+
+## Known Limitations & Roadmap
+
+Current limitations and planned features are tracked in the GitHub issues.
+
+See the [project roadmap](https://github.com/wexample/python-filestate_flutter/issues) for upcoming features and improvements.
+
+## Security Policy
+
+### Reporting Vulnerabilities
+
+If you discover a security vulnerability, please email contact@wexample.com.
+
+**Do not** open public issues for security vulnerabilities.
+
+We take security seriously and will respond promptly to verified reports.
+
+## Privacy & Telemetry
+
+This package does **not** collect any telemetry or usage data.
+
+Your privacy is respected — no data is transmitted to external services.
+
+## Support Channels
+
+- **GitHub Issues**: Bug reports and feature requests
+- **GitHub Discussions**: Questions and community support
+- **Documentation**: Comprehensive guides and API reference
+- **Email**: contact@wexample.com for general inquiries
+
+Community support is available through GitHub Discussions.
+
+## Contribution Guidelines
+
+We welcome contributions to the Wexample suite!
+
+### How to Contribute
+
+1. **Fork** the repository
+2. **Create** a feature branch
+3. **Make** your changes
+4. **Test** thoroughly
+5. **Submit** a pull request
+
+## Maintainers & Authors
+
+Maintained by the Wexample team and community contributors.
+
+See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the full list of contributors.
+
+## License
+
+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
+
+- **Homepage**: https://github.com/wexample/python-filestate-flutter
+- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
+- **Issue Tracker**: https://github.com/wexample/python-filestate-flutter/issues
+- **Discussions**: https://github.com/wexample/python-filestate-flutter/discussions
+- **PyPI**: [pypi.org/project/wexample-filestate-flutter](https://pypi.org/project/wexample-filestate-flutter/)
+
+## Integration in the Suite
+
+This package is part of the **Wexample Suite** — a collection of high-quality Python packages designed to work seamlessly together.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+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
+- cattrs: >=23.1.0
+- wexample-filestate: ==0.0.72
+
+
+# About us
+
+[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 cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
+

wexample_filestate_flutter-0.0.13/pyproject.toml

@@ -0,0 +1,82 @@
+[build-system]
+requires = [
+    "pdm-backend",
+]
+build-backend = "pdm.backend"
+
+[project]
+name = "wexample-filestate-flutter"
+version = "0.0.13"
+authors = [
+    { name = "weeger", email = "contact@wexample.com" },
+]
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "attrs>=23.1.0",
+    "cattrs>=23.1.0",
+    "wexample-filestate==0.0.72",
+]
+
+[project.readme]
+file = "README.md"
+content-type = "text/markdown"
+
+[project.license]
+text = "MIT"
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "pytest-cov",
+]
+
+[tool.setuptools.packages.find]
+include = [
+    "*",
+]
+exclude = [
+    "wexample_filestate_flutter.testing*",
+]
+
+[tool.pdm]
+distribution = true
+
+[tool.pdm.build]
+package-dir = "src"
+packages = [
+    { include = "wexample_filestate_flutter", from = "src" },
+]
+
+[tool.pytest.ini_options]
+testpaths = [
+    "tests",
+]
+pythonpath = [
+    "src",
+]
+
+[tool.coverage.run]
+source = [
+    "wexample_filestate_flutter",
+]
+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",
+]

wexample_filestate_flutter-0.0.13/src/wexample_filestate_flutter/config_option/dart_format_config_option.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+from wexample_config.config_option.abstract_config_option import AbstractConfigOption
+from wexample_helpers.decorator.base_class import base_class
+
+
+@base_class
+class DartFormatConfigOption(AbstractConfigOption):
+    @staticmethod
+    def get_name() -> str:
+        return "dart_format"

wexample_filestate_flutter-0.0.13/src/wexample_filestate_flutter/config_value/flutter_config_value.py

@@ -0,0 +1,27 @@
+from __future__ import annotations
+
+from typing import Any
+
+from wexample_config.config_value.config_value import ConfigValue
+from wexample_helpers.classes.field import public_field
+from wexample_helpers.decorator.base_class import base_class
+
+
+@base_class
+class FlutterConfigValue(ConfigValue):
+    dart_format: bool | None = public_field(
+        default=None,
+        description="Format and fix Dart/Flutter code using dart format and dart fix",
+    )
+    raw: Any = public_field(
+        default=None, description="Disabled raw value for this config."
+    )
+
+    def to_option_raw_value(self) -> Any:
+        from wexample_filestate_flutter.config_option.dart_format_config_option import (
+            DartFormatConfigOption,
+        )
+
+        return {
+            DartFormatConfigOption.get_name(): self.dart_format,
+        }

wexample_filestate_flutter-0.0.13/src/wexample_filestate_flutter/const/flutter_file.py

@@ -0,0 +1,4 @@
+from __future__ import annotations
+
+FLUTTER_FILE_EXTENSIONS = [".dart"]
+FLUTTER_FILE_EXTENSION = ".dart"

wexample_filestate_flutter-0.0.13/src/wexample_filestate_flutter/file/flutter_file.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from typing import ClassVar
+
+from wexample_filestate.item.item_target_file import ItemTargetFile
+
+
+class FlutterFile(ItemTargetFile):
+    EXTENSION_ENV: ClassVar[str] = "dart"
+
+    def _expected_file_name_extension(self) -> str | None:
+        return FlutterFile.EXTENSION_ENV

wexample_filestate_flutter-0.0.13/src/wexample_filestate_flutter/option/flutter/abstract_flutter_file_content_option.py

@@ -0,0 +1,96 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import TYPE_CHECKING, ClassVar
+
+from wexample_filestate.option.abstract_file_content_option import (
+    AbstractFileContentOption,
+)
+from wexample_filestate.option.mixin.with_docker_option_mixin import (
+    WithDockerOptionMixin,
+)
+from wexample_helpers.decorator.base_class import base_class
+
+if TYPE_CHECKING:
+    from wexample_filestate.const.types_state_items import TargetFileOrDirectoryType
+
+
+@base_class
+class AbstractFlutterFileContentOption(
+    WithDockerOptionMixin, AbstractFileContentOption
+):
+    _CONTAINER_ROOT: ClassVar[str] = "/var/www/html"
+    # Avoid re-running flutter pub get for every file during the same Python process
+    _prepared_roots: ClassVar[set[str]] = set()
+
+    def _cleanup_host_cache(self, target: TargetFileOrDirectoryType) -> None:
+        """Remove host-generated Dart cache files that contain absolute paths.
+
+        These caches often point to the host's pub cache (e.g., /home/<user>/.pub-cache)
+        and break inside the container, so we wipe them before running commands there.
+        """
+        import shutil
+
+        root_path = target.get_root().get_path()
+
+        dart_tool = root_path / ".dart_tool"
+        if dart_tool.exists():
+            shutil.rmtree(dart_tool, ignore_errors=True)
+
+        packages_file = root_path / ".packages"
+        if packages_file.exists():
+            packages_file.unlink(missing_ok=True)
+
+    def _get_docker_image_name(self) -> str:
+        """Return the Docker image name for Flutter options."""
+        return "wex-flutter-option"
+
+    def _get_dockerfile_path(self) -> Path:
+        """Return the path to the Flutter Dockerfile."""
+        # Get the path relative to this file
+        current_file = Path(__file__)
+        package_root = current_file.parent.parent.parent
+        return package_root / "resources" / "docker" / "Dockerfile.flutter-option"
+
+    def _prepare_container_environment(self, target: TargetFileOrDirectoryType) -> None:
+        """Ensure caches are clean and dependencies are resolved inside the container."""
+        root_key = str(target.get_root().get_path().resolve())
+        if root_key in self._prepared_roots:
+            return
+
+        # Remove host-specific cache artifacts first
+        self._cleanup_host_cache(target)
+
+        # Make sure the container exists before running pub get
+        self._ensure_docker_container(target)
+
+        # Re-install dependencies inside the container to regenerate package_config with container paths.
+        # Prefer flutter pub when available (flutter SDK projects), otherwise fall back to dart pub.
+        self._execute_in_docker(
+            target=target,
+            command=[
+                "bash",
+                "-lc",
+                "export PATH=/usr/local/flutter/bin:/usr/lib/dart/bin:$PATH && "
+                f"cd {self._CONTAINER_ROOT} && "
+                "if command -v flutter >/dev/null 2>&1; then "
+                "flutter pub get; "
+                "else "
+                "dart pub get; "
+                "fi",
+            ],
+        )
+        self._prepared_roots.add(root_key)
+
+    def _run_from_container_root(
+        self, target: TargetFileOrDirectoryType, shell_command: str
+    ) -> str:
+        """Helper to run a shell command from the project root inside the container."""
+        return self._execute_in_docker(
+            target=target,
+            command=[
+                "bash",
+                "-lc",
+                f"export PATH=/usr/local/flutter/bin:/usr/lib/dart/bin:$PATH && cd {self._CONTAINER_ROOT} && {shell_command}",
+            ],
+        )

wexample_filestate_flutter-0.0.13/src/wexample_filestate_flutter/option/flutter/dart_format_option.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_helpers.decorator.base_class import base_class
+
+from .abstract_flutter_file_content_option import AbstractFlutterFileContentOption
+
+if TYPE_CHECKING:
+    from wexample_filestate.const.types_state_items import TargetFileOrDirectoryType
+
+
+@base_class
+class DartFormatOption(AbstractFlutterFileContentOption):
+    def get_description(self) -> str:
+        return "Format and fix Dart/Flutter code using dart format and dart fix."
+
+    def _apply_content_change(self, target: TargetFileOrDirectoryType) -> str:
+        """Format and fix Dart/Flutter code using dart format and dart fix via Docker."""
+        # Clean host caches and ensure dependencies are resolved inside the container
+        self._prepare_container_environment(target)
+
+        # Get the file path inside the container
+        container_file_path = self._get_container_file_path(target)
+
+        # First, apply dart fix to auto-fix issues
+        self._run_from_container_root(
+            target=target,
+            shell_command=f"dart fix --apply {container_file_path}",
+        )
+
+        # Then, format the code
+        self._run_from_container_root(
+            target=target,
+            shell_command=f"dart format {container_file_path}",
+        )
+
+        # Read the fixed and formatted content from the file (it was modified in place)
+        return target.read_text()

wexample_filestate_flutter-0.0.13/src/wexample_filestate_flutter/option/flutter_option.py

@@ -0,0 +1,55 @@
+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_filestate.option.mixin.with_docker_option_mixin import (
+    WithDockerOptionMixin,
+)
+from wexample_helpers.decorator.base_class import base_class
+
+if TYPE_CHECKING:
+    from wexample_filestate.const.types_state_items import TargetFileOrDirectoryType
+
+
+@base_class
+class FlutterOption(OptionMixin, WithDockerOptionMixin, AbstractNestedConfigOption):
+    @staticmethod
+    def get_raw_value_allowed_type() -> Any:
+        from wexample_filestate_flutter.config_value.flutter_config_value import (
+            FlutterConfigValue,
+        )
+
+        return Union[list[str], dict, FlutterConfigValue]
+
+    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 Flutter operation
+        from wexample_filestate_flutter.option.flutter.dart_format_option import (
+            DartFormatOption,
+        )
+
+        return [
+            # filestate: flutter-iterable-sort
+            DartFormatOption,
+        ]
+
+    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_flutter-0.0.13/src/wexample_filestate_flutter/options_provider/flutter_options_provider.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_config.options_provider.abstract_options_provider import (
+    AbstractOptionsProvider,
+)
+
+if TYPE_CHECKING:
+    from wexample_config.config_option.abstract_config_option import (
+        AbstractConfigOption,
+    )
+
+
+class FlutterOptionsProvider(AbstractOptionsProvider):
+    @classmethod
+    def get_options(cls) -> list[type[AbstractConfigOption]]:
+        from wexample_filestate_flutter.option.flutter_option import FlutterOption
+
+        return [
+            FlutterOption,
+        ]

wexample_filestate_flutter-0.0.13/src/wexample_filestate_flutter/resources/docker/Dockerfile.flutter-option

@@ -0,0 +1,11 @@
+# Base image with Flutter SDK (includes Dart)
+FROM ghcr.io/cirruslabs/flutter:stable
+
+# Copy analysis options configuration
+COPY analysis_options.yaml /root/analysis_options.yaml
+
+# Set working directory
+WORKDIR /var/www/html
+
+# Keep container running
+CMD ["tail", "-f", "/dev/null"]

wexample_filestate_flutter-0.0.13/src/wexample_filestate_flutter/resources/docker/analysis_options.yaml

@@ -0,0 +1,151 @@
+# Dart/Flutter analysis options for code quality
+analyzer:
+  strong-mode:
+    implicit-casts: false
+    implicit-dynamic: false
+  errors:
+    # Treat missing required parameters as errors
+    missing_required_param: error
+    # Treat missing returns as errors
+    missing_return: error
+    # Treat invalid assignments as errors
+    invalid_assignment: error
+    # Treat dead code as warnings
+    dead_code: warning
+    # Treat unused imports as warnings
+    unused_import: warning
+    # Treat unused local variables as warnings
+    unused_local_variable: warning
+  exclude:
+    - "**/*.g.dart"
+    - "**/*.freezed.dart"
+    - "**/generated/**"
+    - "**/build/**"
+    - "**/node_modules/**"
+
+linter:
+  rules:
+    # Error rules
+    - avoid_empty_else
+    - avoid_print
+    - avoid_relative_lib_imports
+    - avoid_returning_null_for_future
+    - avoid_slow_async_io
+    - avoid_types_as_parameter_names
+    - cancel_subscriptions
+    - close_sinks
+    - comment_references
+    - control_flow_in_finally
+    - empty_statements
+    - hash_and_equals
+    - invariant_booleans
+    - iterable_contains_unrelated_type
+    - list_remove_unrelated_type
+    - literal_only_boolean_expressions
+    - no_adjacent_strings_in_list
+    - no_duplicate_case_values
+    - prefer_void_to_null
+    - test_types_in_equals
+    - throw_in_finally
+    - unnecessary_statements
+    - unrelated_type_equality_checks
+    - valid_regexps
+
+    # Style rules
+    - always_declare_return_types
+    - always_put_control_body_on_new_line
+    - always_require_non_null_named_parameters
+    - annotate_overrides
+    - avoid_bool_literals_in_conditional_expressions
+    - avoid_catches_without_on_clauses
+    - avoid_catching_errors
+    - avoid_function_literals_in_foreach_calls
+    - avoid_init_to_null
+    - avoid_null_checks_in_equality_operators
+    - avoid_renaming_method_parameters
+    - avoid_return_types_on_setters
+    - avoid_returning_null
+    - avoid_returning_null_for_void
+    - avoid_shadowing_type_parameters
+    - avoid_single_cascade_in_expression_statements
+    - avoid_unnecessary_containers
+    - avoid_unused_constructor_parameters
+    - await_only_futures
+    - camel_case_extensions
+    - camel_case_types
+    - cascade_invocations
+    - constant_identifier_names
+    - curly_braces_in_flow_control_structures
+    - directives_ordering
+    - empty_catches
+    - empty_constructor_bodies
+    - file_names
+    - implementation_imports
+    - library_names
+    - library_prefixes
+    - non_constant_identifier_names
+    - null_closures
+    - omit_local_variable_types
+    - one_member_abstracts
+    - only_throw_errors
+    - overridden_fields
+    - package_api_docs
+    - package_prefixed_library_names
+    - prefer_adjacent_string_concatenation
+    - prefer_asserts_in_initializer_lists
+    - prefer_collection_literals
+    - prefer_conditional_assignment
+    - prefer_const_constructors
+    - prefer_const_constructors_in_immutables
+    - prefer_const_declarations
+    - prefer_const_literals_to_create_immutables
+    - prefer_constructors_over_static_methods
+    - prefer_contains
+    - prefer_equal_for_default_values
+    - prefer_final_fields
+    - prefer_final_in_for_each
+    - prefer_final_locals
+    - prefer_for_elements_to_map_fromIterable
+    - prefer_function_declarations_over_variables
+    - prefer_generic_function_type_aliases
+    - prefer_if_elements_to_conditional_expressions
+    - prefer_if_null_operators
+    - prefer_initializing_formals
+    - prefer_inlined_adds
+    - prefer_int_literals
+    - prefer_interpolation_to_compose_strings
+    - prefer_is_empty
+    - prefer_is_not_empty
+    - prefer_is_not_operator
+    - prefer_iterable_whereType
+    - prefer_null_aware_operators
+    - prefer_single_quotes
+    - prefer_spread_collections
+    - prefer_typing_uninitialized_variables
+    - provide_deprecation_message
+    - recursive_getters
+    - slash_for_doc_comments
+    - sort_child_properties_last
+    - sort_constructors_first
+    - sort_unnamed_constructors_first
+    - type_annotate_public_apis
+    - type_init_formals
+    - unawaited_futures
+    - unnecessary_await_in_return
+    - unnecessary_brace_in_string_interps
+    - unnecessary_const
+    - unnecessary_getters_setters
+    - unnecessary_lambdas
+    - unnecessary_new
+    - unnecessary_null_aware_assignments
+    - unnecessary_null_in_if_null_operators
+    - unnecessary_overrides
+    - unnecessary_parenthesis
+    - unnecessary_this
+    - use_full_hex_values_for_flutter_colors
+    - use_function_type_syntax_for_parameters
+    - use_rethrow_when_possible
+    - use_setters_to_change_properties
+    - use_string_buffers
+    - use_to_and_as_if_applicable
+    - void_checks