wexample-wex-addon-dev-php 0.0.16__tar.gz → 0.0.18__tar.gz

{wexample_wex_addon_dev_php-0.0.16 → wexample_wex_addon_dev_php-0.0.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-wex-addon-dev-php
-Version: 0.0.16
+Version: 0.0.18
 Summary: Python dev addon for wex
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -11,20 +11,59 @@ Project-URL: homepage, https://github.com/wexample/python-wex-dev-python
 Requires-Python: >=3.10
 Requires-Dist: attrs>=23.1.0
 Requires-Dist: cattrs>=23.1.0
-Requires-Dist: wexample-wex-addon-app==0.0.51
-Requires-Dist: wexample-wex-core==6.0.63
+Requires-Dist: wexample-filestate-php==0.0.13
+Requires-Dist: wexample-wex-addon-app==0.0.54
+Requires-Dist: wexample-wex-core==6.0.66
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
-Requires-Dist: wexample-filestate-php==0.0.1; extra == "dev"
 Description-Content-Type: text/markdown
 
 # wexample-wex-addon-dev-php
 
-Version: 0.0.16
+Version: 0.0.18
 
 Python dev addon for wex
 
+## 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.
@@ -111,13 +150,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-wex-dev-python/issues) for upcoming features and improvements.
+See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_php/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.
 
@@ -140,7 +179,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
 
@@ -158,14 +197,16 @@ 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
 
-- **Homepage**: https://github.com/wexample/python-wex-dev-python
+- **Homepage**: https://github.com/wexample/python-wex-addon-dev-php
 - **Documentation**: [docs.wexample.com](https://docs.wexample.com)
-- **Issue Tracker**: https://github.com/wexample/python-wex-dev-python/issues
-- **Discussions**: https://github.com/wexample/python-wex-dev-python/discussions
+- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-php/issues
+- **Discussions**: https://github.com/wexample/python-wex-addon-dev-php/discussions
 - **PyPI**: [pypi.org/project/wexample-wex-addon-dev-php](https://pypi.org/project/wexample-wex-addon-dev-php/)
 
 ## Integration in the Suite
@@ -178,9 +219,24 @@ 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
+- cattrs: >=23.1.0
+- wexample-filestate-php: ==0.0.13
+- wexample-wex-addon-app: ==0.0.54
+- wexample-wex-core: ==6.0.66
+
+
 # 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_wex_addon_dev_php-0.0.16 → wexample_wex_addon_dev_php-0.0.18}/README.md

@@ -1,9 +1,48 @@
 # wexample-wex-addon-dev-php
 
-Version: 0.0.16
+Version: 0.0.18
 
 Python dev addon for wex
 
+## 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-wex-dev-python/issues) for upcoming features and improvements.
+See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_php/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,14 +176,16 @@ 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
 
-- **Homepage**: https://github.com/wexample/python-wex-dev-python
+- **Homepage**: https://github.com/wexample/python-wex-addon-dev-php
 - **Documentation**: [docs.wexample.com](https://docs.wexample.com)
-- **Issue Tracker**: https://github.com/wexample/python-wex-dev-python/issues
-- **Discussions**: https://github.com/wexample/python-wex-dev-python/discussions
+- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-php/issues
+- **Discussions**: https://github.com/wexample/python-wex-addon-dev-php/discussions
 - **PyPI**: [pypi.org/project/wexample-wex-addon-dev-php](https://pypi.org/project/wexample-wex-addon-dev-php/)
 
 ## Integration in the Suite
@@ -157,9 +198,24 @@ 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
+- cattrs: >=23.1.0
+- wexample-filestate-php: ==0.0.13
+- wexample-wex-addon-app: ==0.0.54
+- wexample-wex-core: ==6.0.66
+
+
 # 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_wex_addon_dev_php-0.0.16 → wexample_wex_addon_dev_php-0.0.18}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-wex-addon-dev-php"
-version = "0.0.16"
+version = "0.0.18"
 description = "Python dev addon for wex"
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -20,8 +20,9 @@ classifiers = [
 dependencies = [
     "attrs>=23.1.0",
     "cattrs>=23.1.0",
-    "wexample-wex-addon-app==0.0.51",
-    "wexample-wex-core==6.0.63",
+    "wexample-filestate-php==0.0.13",
+    "wexample-wex-addon-app==0.0.54",
+    "wexample-wex-core==6.0.66",
 ]
 
 [project.readme]
@@ -38,7 +39,6 @@ homepage = "https://github.com/wexample/python-wex-dev-python"
 dev = [
     "pytest",
     "pytest-cov",
-    "wexample-filestate-php==0.0.1",
 ]
 
 [tool.setuptools.packages.find]

wexample_wex_addon_dev_php-0.0.18/src/wexample_wex_addon_dev_php/config_value/php_package_readme_config_value.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from wexample_helpers.decorator.base_class import base_class
+from wexample_wex_addon_app.config_value.app_readme_config_value import (
+    AppReadmeConfigValue,
+)
+
+
+@base_class
+class PhpPackageReadmeContentConfigValue(AppReadmeConfigValue):
+    """README generation for Php packages."""
+
+    def _get_app_description(self) -> str:
+        return self.workdir.get_app_config().get("description", "")

wexample_wex_addon_dev_php-0.0.18/src/wexample_wex_addon_dev_php/file/php_composer_json_file.py

@@ -0,0 +1,81 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_filestate.item.file.json_file import JsonFile
+from wexample_helpers.decorator.base_class import base_class
+
+if TYPE_CHECKING:
+    from wexample_wex_addon_app.workdir.code_base_workdir import CodeBaseWorkdir
+
+
+@base_class
+class PhpComposerJsonFile(JsonFile):
+    def add_dependency(
+            self,
+            package_name: str,
+            version: str,
+            operator: str = "",
+            optional: bool = False,
+            group: None | str = None,
+    ) -> bool:
+        """
+        Add or update a Composer dependency.
+        Returns True if the dependency list changed.
+        """
+        # Composer group
+        group_key = "require-dev" if group == "dev" else "require"
+
+        # Composer does not use operators like pip (==, >=, etc.)
+        # So operator is simply prepended if provided.
+        constraint = f"{operator}{version}".strip()
+
+        config = self.read_config()
+
+        # Extract or create dependency dictionary
+        deps_node = config.search(path=group_key, default={})
+        deps = deps_node.to_dict() if deps_node else {}
+
+        old = deps.get(package_name)
+
+        # Nothing changes
+        if old == constraint:
+            return False
+
+        # Apply change
+        deps[package_name] = constraint
+
+        config_updated = {}
+        config_updated[group_key] = deps
+        config.update_nested(data=config_updated)
+
+        self.write_config(config)
+
+        return True
+
+    def get_dependencies_versions(
+            self, optional: bool = False, group: str = "dev"
+    ) -> dict[str, str]:
+        # Default values is not well managed in nested config value, for now.
+        require = self.read_config().search(path="require")
+
+        if not require:
+            return {}
+
+        return require.to_dict()
+
+    def dumps(self, content: dict | None = None) -> str:
+        import json
+
+        content = content or self.read_parsed()
+
+        package = self.find_package_workdir()
+        if package:
+            content["version"] = package.get_project_version()
+
+        return json.dumps(content or {}, ensure_ascii=False, indent=2)
+
+    def find_package_workdir(self) -> CodeBaseWorkdir | None:
+        from wexample_wex_addon_app.workdir.code_base_workdir import CodeBaseWorkdir
+
+        return self.find_closest(CodeBaseWorkdir)

wexample_wex_addon_dev_php-0.0.18/src/wexample_wex_addon_dev_php/workdir/php_package_workdir.py

@@ -0,0 +1,88 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_helpers.helpers.string import string_to_pascal_case
+from wexample_helpers_git.helpers.git import (
+    git_tag_exists,
+    git_tag_annotated,
+)
+from wexample_wex_addon_app.workdir.framework_packages_suite_workdir import (
+    FrameworkPackageSuiteWorkdir,
+)
+from wexample_wex_addon_dev_php.workdir.php_workdir import PhpWorkdir
+
+if TYPE_CHECKING:
+    from wexample_filestate.config_value.readme_content_config_value import (
+        ReadmeContentConfigValue,
+    )
+    from wexample_filestate.utils.search_result import SearchResult
+
+
+class PhpPackageWorkdir(PhpWorkdir):
+    def _get_readme_content(self) -> ReadmeContentConfigValue | None:
+        from wexample_wex_addon_dev_php.config_value.php_package_readme_config_value import (
+            PhpPackageReadmeContentConfigValue,
+        )
+
+        return PhpPackageReadmeContentConfigValue(workdir=self)
+
+    def _get_suite_package_workdir_class(self) -> type[FrameworkPackageSuiteWorkdir]:
+        from wexample_wex_addon_dev_php.workdir.php_packages_suite_workdir import (
+            PhpPackagesSuiteWorkdir,
+        )
+
+        return PhpPackagesSuiteWorkdir
+
+    def get_package_import_name(self) -> str:
+        """Get the full package import name with vendor prefix."""
+        return f"{string_to_pascal_case(self.get_vendor_name())}\\{string_to_pascal_case(self.get_project_name())}"
+
+    def search_imports_in_codebase(
+        self, searched_package: "PhpPackageWorkdir"
+    ) -> list["SearchResult"]:
+        """Find PHP `use`/qualified references to the given package."""
+        import re
+
+        pkg = re.escape(searched_package.get_package_import_name())
+        pattern = rf"(?m)^\s*use\s+{pkg}(?:\\\\[\w]+)*\s*;|{pkg}(?:\\\\[\w]+)*"
+        return self.search_in_codebase(pattern, regex=True, flags=re.MULTILINE)
+
+    def search_in_codebase(
+        self, string: str, *, regex: bool = False, flags: int = 0
+    ) -> list["SearchResult"]:
+        from wexample_filestate.utils.search_result import SearchResult
+        from wexample_filestate_php.file.php_file import PhpFile
+
+        found: list[SearchResult] = []
+
+        def _search(item: PhpFile) -> None:
+            found.extend(
+                SearchResult.create_for_all_matches(
+                    string, item, regex=regex, flags=flags
+                )
+            )
+
+        self.for_each_child_of_type_recursive(callback=_search, class_type=PhpFile)
+
+        return found
+
+    def _publish(self, force: bool = False) -> None:
+        """Add a Packagist-friendly tag (vX.Y.Z) in addition to default tagging."""
+        tag = f"v{self.get_project_version()}"
+        cwd = self.get_path()
+
+        if git_tag_exists(tag, cwd=cwd, inherit_stdio=False) and not force:
+            self.log(
+                f"Tag {tag} already exists, skipping creation (use --force to re-tag)."
+            )
+        else:
+            git_tag_annotated(tag, f"Release {tag}", cwd=cwd, inherit_stdio=True)
+
+        # Uses git repo to deploy packages.
+        self.push_to_deployment_remote()
+
+    def get_package_name(self) -> str:
+        from wexample_helpers.helpers.string import string_to_kebab_case
+
+        return f"{string_to_kebab_case(self.get_vendor_name())}/{string_to_kebab_case(self.get_project_name())}"

wexample_wex_addon_dev_php-0.0.18/src/wexample_wex_addon_dev_php/workdir/php_workdir.py

@@ -0,0 +1,127 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_filestate_php.option.php.phpcs_fixer_option import PhpcsFixerOption
+from wexample_wex_addon_app.workdir.code_base_workdir import CodeBaseWorkdir
+
+if TYPE_CHECKING:
+    from wexample_config.const.types import DictConfig
+    from wexample_config.options_provider.abstract_options_provider import (
+        AbstractOptionsProvider,
+    )
+    from wexample_filestate.option.children_file_factory_option import (
+        ChildrenFileFactoryOption,
+    )
+
+    from wexample_wex_addon_dev_php.file.php_composer_json_file import (
+        PhpComposerJsonFile,
+    )
+
+
+class PhpWorkdir(CodeBaseWorkdir):
+    def get_app_config_file(self, reload: bool = True) -> PhpComposerJsonFile:
+        from wexample_wex_addon_dev_php.file.php_composer_json_file import (
+            PhpComposerJsonFile,
+        )
+
+        config_file = self.find_by_type(PhpComposerJsonFile)
+        # Read once to populate content with file source.
+        config_file.read_text(reload=reload)
+        return config_file
+
+    def get_dependencies_versions(self) -> dict[str, str]:
+        return self.get_app_config_file().get_dependencies_versions()
+
+    def get_main_code_file_extension(self) -> str:
+        from wexample_filestate_php.const.php_file import PHP_FILE_EXTENSION
+
+        return PHP_FILE_EXTENSION
+
+    def get_options_providers(self) -> list[type[AbstractOptionsProvider]]:
+        from wexample_filestate_php.options_provider.php_options_provider import (
+            PhpOptionsProvider,
+        )
+
+        options = super().get_options_providers()
+
+        options.extend(
+            [
+                PhpOptionsProvider,
+            ]
+        )
+
+        return options
+
+    def prepare_value(self, raw_value: DictConfig | None = None) -> DictConfig:
+        from wexample_filestate.const.disk import DiskItemType
+        from wexample_helpers.helpers.array import array_dict_get_by
+
+        from wexample_wex_addon_dev_php.file.php_composer_json_file import (
+            PhpComposerJsonFile,
+        )
+
+        raw_value = super().prepare_value(raw_value=raw_value)
+
+        # Ensure a composer.json file exists for any PHP package project
+        children = raw_value["children"]
+
+        children.append(
+            {
+                "class": PhpComposerJsonFile,
+                "name": "composer.json",
+                "type": DiskItemType.FILE,
+                "should_exist": True,
+            }
+        )
+
+        # Add rules to .gitignore
+        array_dict_get_by("name", ".gitignore", children).setdefault(
+            "should_contain_lines", []
+        ).extend(
+            [
+                ".php-cs-fixer.cache",
+                ".scannerwork",
+                "/vendor",
+            ]
+        )
+
+        children.extend(
+            [
+                {
+                    "name": "tests",
+                    "type": DiskItemType.DIRECTORY,
+                    "should_exist": True,
+                    "children": [
+                        self._create_php_file_children_filter(),
+                    ],
+                },
+                {
+                    "name": "src",
+                    "type": DiskItemType.DIRECTORY,
+                    "should_exist": True,
+                    "children": [
+                        self._create_php_file_children_filter(),
+                    ],
+                },
+            ]
+        )
+
+        return raw_value
+
+    def _create_php_file_children_filter(self) -> ChildrenFileFactoryOption:
+        from wexample_filestate.const.disk import DiskItemType
+        from wexample_filestate.option.children_filter_option import (
+            ChildrenFilterOption,
+        )
+        from wexample_filestate_php.file.php_file import PhpFile
+
+        return ChildrenFilterOption(
+            pattern={
+                "class": PhpFile,
+                "type": DiskItemType.FILE,
+                "php": [PhpcsFixerOption.get_name()],
+            },
+            name_pattern=r"^.*\.php$",
+            recursive=True,
+        )

wexample_wex_addon_dev_php-0.0.16/src/wexample_wex_addon_dev_php/workdir/php_package_workdir.py

@@ -1,7 +0,0 @@
-from __future__ import annotations
-
-from wexample_wex_addon_dev_php.workdir.php_workdir import PhpWorkdir
-
-
-class PhpPackageWorkdir(PhpWorkdir):
-    pass

wexample_wex_addon_dev_php-0.0.16/src/wexample_wex_addon_dev_php/workdir/php_workdir.py

@@ -1,64 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING
-
-from wexample_wex_addon_app.workdir.code_base_workdir import CodeBaseWorkdir
-
-if TYPE_CHECKING:
-    from wexample_config.const.types import DictConfig
-    from wexample_filestate.option.children_file_factory_option import (
-        ChildrenFileFactoryOption,
-    )
-
-
-class PhpWorkdir(CodeBaseWorkdir):
-    def get_dependencies(self) -> list[str]:
-        # TODO search in composer.json
-        return []
-
-    def prepare_value(self, raw_value: DictConfig | None = None) -> DictConfig:
-        from wexample_filestate.const.disk import DiskItemType
-        from wexample_helpers.helpers.array import array_dict_get_by
-
-        raw_value = super().prepare_value(raw_value=raw_value)
-
-        # Ensure a composer.json file exists for any PHP package project
-        children = raw_value["children"]
-
-        children.append(
-            {
-                "name": "composer.json",
-                "type": DiskItemType.FILE,
-                "should_exist": True,
-            }
-        )
-
-        # Add rules to .gitignore
-        array_dict_get_by("name", ".gitignore", children).setdefault(
-            "should_contain_lines", []
-        ).extend(
-            [
-                ".php-cs-fixer.cache",
-                ".scannerwork",
-                "/vendor",
-            ]
-        )
-
-        return raw_value
-
-    def _create_php_file_children_filter(self) -> ChildrenFileFactoryOption:
-        from wexample_filestate.const.disk import DiskItemType
-        from wexample_filestate.option.children_filter_option import (
-            ChildrenFilterOption,
-        )
-        from wexample_filestate_php.file.php_file import PhpFile
-
-        return ChildrenFilterOption(
-            pattern={
-                "class": PhpFile,
-                "name_pattern": r"^.*\.php$",
-                "type": DiskItemType.FILE,
-                "python": [],
-            },
-            recursive=True,
-        )