wexample-wex-addon-dev-php 12.9.0__tar.gz → 12.11.0__tar.gz

{wexample_wex_addon_dev_php-12.9.0 → wexample_wex_addon_dev_php-12.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-wex-addon-dev-php
-Version: 12.9.0
+Version: 12.11.0
 Summary: Extends wex with PHP-specific development commands for Composer, Laravel, Symfony, and WordPress services running in Docker containers
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -14,8 +14,8 @@ Requires-Dist: cattrs>=23.1.0
 Requires-Dist: wexample-filestate-php>=6.5.0
 Requires-Dist: wexample-filestate-symfony>=2.1.0
 Requires-Dist: wexample-wex-addon-ai>=19.0.0
-Requires-Dist: wexample-wex-addon-app>=34.0.0
-Requires-Dist: wexample-wex-addon-dev-javascript>=8.5.0
+Requires-Dist: wexample-wex-addon-app>=34.1.0
+Requires-Dist: wexample-wex-addon-dev-javascript>=8.6.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -23,7 +23,7 @@ Description-Content-Type: text/markdown
 
 # wex_addon_dev_php
 
-Version: 12.9.0
+Version: 12.11.0
 
 `wex_addon_dev_php` extends the wex CLI with PHP-specific development commands for Composer, Laravel, Symfony, and WordPress services running in Docker containers. It is aimed at PHP developers who manage their apps through wex and need framework-aware automation — dependency wiring, migration runs, lock-file refreshes — executed directly inside the running service containers. The addon registers four workdir types (`php`, `php-package`, `php-packages-suite`, `php-symfony`) and contributes its commands through the standard `PhpAddonManager` plugin point.
 
@@ -274,8 +274,8 @@ The suite includes packages for configuration management, file handling, prompts
 - wexample-filestate-php: >=6.5.0
 - wexample-filestate-symfony: >=2.1.0
 - wexample-wex-addon-ai: >=19.0.0
-- wexample-wex-addon-app: >=34.0.0
-- wexample-wex-addon-dev-javascript: >=8.5.0
+- wexample-wex-addon-app: >=34.1.0
+- wexample-wex-addon-dev-javascript: >=8.6.0
 
 ## Versioning & Compatibility Policy
 

{wexample_wex_addon_dev_php-12.9.0 → wexample_wex_addon_dev_php-12.11.0}/README.md

@@ -1,6 +1,6 @@
 # wex_addon_dev_php
 
-Version: 12.9.0
+Version: 12.11.0
 
 `wex_addon_dev_php` extends the wex CLI with PHP-specific development commands for Composer, Laravel, Symfony, and WordPress services running in Docker containers. It is aimed at PHP developers who manage their apps through wex and need framework-aware automation — dependency wiring, migration runs, lock-file refreshes — executed directly inside the running service containers. The addon registers four workdir types (`php`, `php-package`, `php-packages-suite`, `php-symfony`) and contributes its commands through the standard `PhpAddonManager` plugin point.
 
@@ -251,8 +251,8 @@ The suite includes packages for configuration management, file handling, prompts
 - wexample-filestate-php: >=6.5.0
 - wexample-filestate-symfony: >=2.1.0
 - wexample-wex-addon-ai: >=19.0.0
-- wexample-wex-addon-app: >=34.0.0
-- wexample-wex-addon-dev-javascript: >=8.5.0
+- wexample-wex-addon-app: >=34.1.0
+- wexample-wex-addon-dev-javascript: >=8.6.0
 
 ## Versioning & Compatibility Policy
 

{wexample_wex_addon_dev_php-12.9.0 → wexample_wex_addon_dev_php-12.11.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-wex-addon-dev-php"
-version = "12.9.0"
+version = "12.11.0"
 description = "Extends wex with PHP-specific development commands for Composer, Laravel, Symfony, and WordPress services running in Docker containers"
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -23,8 +23,8 @@ dependencies = [
     "wexample-filestate-php>=6.5.0",
     "wexample-filestate-symfony>=2.1.0",
     "wexample-wex-addon-ai>=19.0.0",
-    "wexample-wex-addon-app>=34.0.0",
-    "wexample-wex-addon-dev-javascript>=8.5.0",
+    "wexample-wex-addon-app>=34.1.0",
+    "wexample-wex-addon-dev-javascript>=8.6.0",
 ]
 
 [project.readme]

wexample_wex_addon_dev_php-12.11.0/src/wexample_wex_addon_dev_php/common/packagist_registry_gateway.py

@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+from wexample_api.common.abstract_gateway import AbstractGateway
+from wexample_helpers.decorator.base_class import base_class
+
+_HAS_VERSION_STATUS_CODES: tuple[int, ...] = (200, 404)
+
+
+@base_class
+class PackagistRegistryGateway(AbstractGateway):
+    """Thin HTTP gateway over Packagist's Composer v2 metadata.
+
+    Reads `p2/<vendor>/<package>.json`, the file composer itself downloads:
+    a version listed there is one a `composer update` run right after will
+    find, which the tag pushed to GitHub is not until Packagist has read it.
+    """
+
+    def has_version(self, package: str, version: str) -> bool:
+        """Return True iff `package` lists `version` (with or without its `v`).
+
+        False on 404: a package Packagist does not know yet, or a version not
+        yet through its CDN.
+        """
+        response = self.make_request(
+            endpoint=f"p2/{package}.json",
+            expected_status_codes=_HAS_VERSION_STATUS_CODES,
+            fatal_if_unexpected=False,
+            quiet=True,
+        )
+        if response is None or response.status_code != 200:
+            return False
+
+        try:
+            releases = response.json().get("packages", {}).get(package, [])
+        except ValueError:
+            return False
+
+        wanted = version.removeprefix("v")
+        return any(
+            str(release.get("version", "")).removeprefix("v") == wanted
+            for release in releases
+        )

wexample_wex_addon_dev_php-12.11.0/src/wexample_wex_addon_dev_php/resources/package_gitlab_ci.yml

@@ -0,0 +1,4 @@
+include:
+  - remote: 'https://gitlab.wexample.com/wexample-public/ci-cd/-/raw/main/.gitlab-ci.type.composer.package.yml'
+variables:
+  MAIN_BRANCH_NAME: main

{wexample_wex_addon_dev_php-12.9.0 → wexample_wex_addon_dev_php-12.11.0}/src/wexample_wex_addon_dev_php/workdir/php_package_workdir.py

@@ -18,6 +18,7 @@ from wexample_wex_addon_app.workdir.mixin.with_runner_workdir_mixin import (
 from wexample_wex_addon_dev_php.workdir.php_workdir import PhpWorkdir
 
 if TYPE_CHECKING:
+    from wexample_config.const.types import DictConfig
     from wexample_filestate.config_value.readme_content_config_value import (
         ReadmeContentConfigValue,
     )
@@ -67,6 +68,34 @@ class PhpPackageWorkdir(WithRunnerWorkdirMixin, PhpWorkdir):
             )
         }
 
+    def prepare_value(self, raw_value: DictConfig | None = None) -> DictConfig:
+        from wexample_filestate.const.disk import DiskItemType
+        from wexample_helpers.helper.file import file_read
+        from wexample_helpers.helper.module import module_get_path
+
+        import wexample_wex_addon_dev_php
+
+        raw_value = super().prepare_value(raw_value=raw_value)
+
+        # Every package is tested by GitLab at each push, the way a consumer
+        # installs it. The file is only an include: the job itself lives in
+        # the ci-cd repository, one place to change for every package. Created
+        # when absent, never rewritten: a package may add to it.
+        raw_value["children"].append(
+            {
+                "name": ".gitlab-ci.yml",
+                "type": DiskItemType.FILE,
+                "should_exist": True,
+                "default_content": lambda _: file_read(
+                    module_get_path(wexample_wex_addon_dev_php)
+                    / "resources"
+                    / "package_gitlab_ci.yml"
+                ),
+            }
+        )
+
+        return raw_value
+
     def search_imports_in_codebase(
         self, searched_package: PhpPackageWorkdir
     ) -> list[SearchResult]:
@@ -273,3 +302,55 @@ class PhpPackageWorkdir(WithRunnerWorkdirMixin, PhpWorkdir):
                 "sh", "-c", script,
             ]
         )
+
+    def _wait_for_registry(self) -> None:
+        """Poll Packagist until the version just tagged is listed (max 20 min).
+
+        The apps update their lock right after a suite publishes, and composer
+        reads Packagist, not GitHub: without the wait, the version pushed a few
+        seconds earlier is not found yet ("found [dev-main] but it does not
+        match your minimum-stability"). A package published to the private
+        remote only never reaches Packagist, so nothing is waited for.
+        """
+        from wexample_helpers.helper.polling_callback_manager import (
+            PollingCallbackManager,
+        )
+
+        from wexample_wex_addon_dev_php.common.packagist_registry_gateway import (
+            PackagistRegistryGateway,
+        )
+
+        if not self.is_published_publicly():
+            return
+
+        package = self.get_package_name()
+        version = self.get_setup_version()
+        gateway = PackagistRegistryGateway(
+            base_url="https://repo.packagist.org",
+            io=self.io,
+            timeout=10,
+        )
+
+        max_attempts = 40
+        delay_seconds = 30
+
+        self.log(f"Waiting for {package} {version} to appear on Packagist…")
+
+        def on_retry(attempt, max_a, delay, _exc, _msg) -> None:
+            self.log(
+                f"Not yet available (attempt {attempt}/{max_a}), retrying in {delay}s…"
+            )
+
+        PollingCallbackManager(
+            callback=lambda: gateway.has_version(package, version) or None,
+            max_attempts=max_attempts,
+            delay_seconds_callback=lambda _attempt: delay_seconds,
+            on_retry_callback=on_retry,
+            timeout_message=(
+                f"Timed out waiting for {package} {version} on Packagist after "
+                f"{max_attempts * delay_seconds // 60} minutes."
+            ),
+        ).run()
+
+        self.success(f"{package} {version} is available.")
+