wexample-wex-addon-dev-php 12.8.1__tar.gz → 12.10.0__tar.gz

{wexample_wex_addon_dev_php-12.8.1 → wexample_wex_addon_dev_php-12.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-wex-addon-dev-php
-Version: 12.8.1
+Version: 12.10.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
@@ -13,9 +13,9 @@ Requires-Dist: attrs>=23.1.0
 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>=18.3.0
-Requires-Dist: wexample-wex-addon-app>=33.4.0
-Requires-Dist: wexample-wex-addon-dev-javascript>=8.4.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
 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.8.1
+Version: 12.10.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.
 
@@ -267,17 +267,15 @@ This package is part of the Wexample Suite — a collection of high-quality, mod
 
 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.
-
 ## Dependencies
 
 - attrs: >=23.1.0
 - cattrs: >=23.1.0
 - wexample-filestate-php: >=6.5.0
 - wexample-filestate-symfony: >=2.1.0
-- wexample-wex-addon-ai: >=18.3.0
-- wexample-wex-addon-app: >=33.4.0
-- wexample-wex-addon-dev-javascript: >=8.4.0
+- wexample-wex-addon-ai: >=19.0.0
+- wexample-wex-addon-app: >=34.0.0
+- wexample-wex-addon-dev-javascript: >=8.5.0
 
 ## Versioning & Compatibility Policy
 
@@ -303,6 +301,8 @@ This packages suite embodies this spirit. Trusted by professionals and enthusias
 
 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.
 
+Built and maintained by [Romain Weeger](https://weeger.io).
+
 ## Known Limitations & Roadmap
 
 Current limitations and planned features are tracked in the GitHub issues.
@@ -322,7 +322,6 @@ See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_php/i
 ## Useful Links
 
 - **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-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/)

{wexample_wex_addon_dev_php-12.8.1 → wexample_wex_addon_dev_php-12.10.0}/README.md

@@ -1,6 +1,6 @@
 # wex_addon_dev_php
 
-Version: 12.8.1
+Version: 12.10.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.
 
@@ -244,17 +244,15 @@ This package is part of the Wexample Suite — a collection of high-quality, mod
 
 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.
-
 ## Dependencies
 
 - attrs: >=23.1.0
 - cattrs: >=23.1.0
 - wexample-filestate-php: >=6.5.0
 - wexample-filestate-symfony: >=2.1.0
-- wexample-wex-addon-ai: >=18.3.0
-- wexample-wex-addon-app: >=33.4.0
-- wexample-wex-addon-dev-javascript: >=8.4.0
+- wexample-wex-addon-ai: >=19.0.0
+- wexample-wex-addon-app: >=34.0.0
+- wexample-wex-addon-dev-javascript: >=8.5.0
 
 ## Versioning & Compatibility Policy
 
@@ -280,6 +278,8 @@ This packages suite embodies this spirit. Trusted by professionals and enthusias
 
 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.
 
+Built and maintained by [Romain Weeger](https://weeger.io).
+
 ## Known Limitations & Roadmap
 
 Current limitations and planned features are tracked in the GitHub issues.
@@ -299,7 +299,6 @@ See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_php/i
 ## Useful Links
 
 - **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-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/)

{wexample_wex_addon_dev_php-12.8.1 → wexample_wex_addon_dev_php-12.10.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-wex-addon-dev-php"
-version = "12.8.1"
+version = "12.10.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" },
@@ -22,9 +22,9 @@ dependencies = [
     "cattrs>=23.1.0",
     "wexample-filestate-php>=6.5.0",
     "wexample-filestate-symfony>=2.1.0",
-    "wexample-wex-addon-ai>=18.3.0",
-    "wexample-wex-addon-app>=33.4.0",
-    "wexample-wex-addon-dev-javascript>=8.4.0",
+    "wexample-wex-addon-ai>=19.0.0",
+    "wexample-wex-addon-app>=34.0.0",
+    "wexample-wex-addon-dev-javascript>=8.5.0",
 ]
 
 [project.readme]

wexample_wex_addon_dev_php-12.10.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.8.1 → wexample_wex_addon_dev_php-12.10.0}/src/wexample_wex_addon_dev_php/resources/design_rules/php_code.md

@@ -29,3 +29,14 @@ is already a decision made.
 - Helper classes are `final`-shaped by use: only `public static` methods, no state, no
   instantiation. A helper that needs a constructor has stopped being a helper and belongs
   in `Class/`.
+- A Symfony service outlives the request it serves: a FrankenPHP worker keeps the
+  container from one visitor to the next. So a service keeps nothing of a request in
+  itself. Its dependencies are `readonly`; what a request produces (assets asked for,
+  a decision about the current user, a submission's outcome) is passed along or read
+  where it is used, never stored in `$this`. Where a service must hold such state, it
+  implements `ResetInterface` and empties it in `reset()`. A memo of what the code or the
+  configuration says — a chart read from a bundled file, a registry built from tagged
+  services — is marked `#[WorkerSafe('why')]` (symfony-helpers). Nothing request-bound is
+  read in a constructor either: `$requestStack->getCurrentRequest()` there is the first
+  request, for good. The container of an app in `strict` mode refuses to build when a
+  service is none of the three (`WorkerSafeServicesCompilerPass`).

{wexample_wex_addon_dev_php-12.8.1 → wexample_wex_addon_dev_php-12.10.0}/src/wexample_wex_addon_dev_php/workdir/php_package_workdir.py

@@ -273,3 +273,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.")
+