wexample-wex-addon-dev-php 12.3.0__tar.gz → 12.3.1__tar.gz

{wexample_wex_addon_dev_php-12.3.0 → wexample_wex_addon_dev_php-12.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-wex-addon-dev-php
-Version: 12.3.0
+Version: 12.3.1
 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,8 +13,8 @@ Requires-Dist: attrs>=23.1.0
 Requires-Dist: cattrs>=23.1.0
 Requires-Dist: wexample-filestate-php>=6.4.0
 Requires-Dist: wexample-filestate-symfony>=2.0.0
-Requires-Dist: wexample-wex-addon-ai>=16.0.0
-Requires-Dist: wexample-wex-addon-app>=32.0.0
+Requires-Dist: wexample-wex-addon-ai>=16.1.0
+Requires-Dist: wexample-wex-addon-app>=32.1.0
 Requires-Dist: wexample-wex-addon-dev-javascript>=8.2.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
@@ -23,7 +23,7 @@ Description-Content-Type: text/markdown
 
 # wex_addon_dev_php
 
-Version: 12.3.0
+Version: 12.3.1
 
 `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.
 
@@ -275,8 +275,8 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 - cattrs: >=23.1.0
 - wexample-filestate-php: >=6.4.0
 - wexample-filestate-symfony: >=2.0.0
-- wexample-wex-addon-ai: >=16.0.0
-- wexample-wex-addon-app: >=32.0.0
+- wexample-wex-addon-ai: >=16.1.0
+- wexample-wex-addon-app: >=32.1.0
 - wexample-wex-addon-dev-javascript: >=8.2.0
 
 ## Versioning & Compatibility Policy

{wexample_wex_addon_dev_php-12.3.0 → wexample_wex_addon_dev_php-12.3.1}/README.md

@@ -1,6 +1,6 @@
 # wex_addon_dev_php
 
-Version: 12.3.0
+Version: 12.3.1
 
 `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.
 
@@ -252,8 +252,8 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 - cattrs: >=23.1.0
 - wexample-filestate-php: >=6.4.0
 - wexample-filestate-symfony: >=2.0.0
-- wexample-wex-addon-ai: >=16.0.0
-- wexample-wex-addon-app: >=32.0.0
+- wexample-wex-addon-ai: >=16.1.0
+- wexample-wex-addon-app: >=32.1.0
 - wexample-wex-addon-dev-javascript: >=8.2.0
 
 ## Versioning & Compatibility Policy

{wexample_wex_addon_dev_php-12.3.0 → wexample_wex_addon_dev_php-12.3.1}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-wex-addon-dev-php"
-version = "12.3.0"
+version = "12.3.1"
 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,8 +22,8 @@ dependencies = [
     "cattrs>=23.1.0",
     "wexample-filestate-php>=6.4.0",
     "wexample-filestate-symfony>=2.0.0",
-    "wexample-wex-addon-ai>=16.0.0",
-    "wexample-wex-addon-app>=32.0.0",
+    "wexample-wex-addon-ai>=16.1.0",
+    "wexample-wex-addon-app>=32.1.0",
     "wexample-wex-addon-dev-javascript>=8.2.0",
 ]
 

wexample_wex_addon_dev_php-12.3.1/src/wexample_wex_addon_dev_php/services/symfony/commands/translations/translate.py

@@ -0,0 +1,89 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_cli.const.tags import AudienceTag, EffectTag, ScopeTag
+from wexample_cli.decorator.command import command
+from wexample_cli.decorator.option import option
+from wexample_wex_core.const.globals import COMMAND_TYPE_SERVICE
+
+from wexample_wex_addon_dev_php.const.tags import DomainTag
+from wexample_wex_addon_dev_php.services.composer.commands.service.install_local import (
+    APP_DIR,
+)
+
+if TYPE_CHECKING:
+    from wexample_app.response.abstract_response import AbstractResponse
+    from wexample_cli.context.execution_context import ExecutionContext
+    from wexample_wex_addon_app.service.app_service import AppService
+
+
+@option(
+    name="force",
+    type=bool,
+    default=False,
+    description="Translate again what an engine already translated; wording written by hand is kept",
+)
+@option(
+    name="locale",
+    type=str,
+    required=False,
+    default="",
+    description="Space-separated locales to translate into, enabled once done; every enabled locale but the default one if omitted",
+)
+@command(
+    type=COMMAND_TYPE_SERVICE,
+    description="Translate the interface and the content of a symfony app (wexample/symfony-translations)",
+    tags=[
+        DomainTag.LANGUAGE_PHP,
+        DomainTag.FRAMEWORK,
+        EffectTag.WRITE,
+        AudienceTag.AGENT_SAFE,
+        ScopeTag.APP,
+        ScopeTag.CONTAINER,
+    ],
+)
+def symfony__translations__translate(
+    context: ExecutionContext,
+    service: AppService,
+    force: bool = False,
+    locale: str = "",
+) -> AbstractResponse:
+    """The locales are the app's own, read by Symfony from framework.enabled_locales
+    and default_locale: nothing to list here. Naming one is how a new locale is
+    added, `translate-files` enabling it once its files are written, so the next
+    run without any takes it along.
+
+    The interface first, as the content locales follow the interface ones. The
+    bundles are translated too: the app is where their wording is read.
+
+    Run in the terminal rather than captured: a run sends every text to the
+    engine and takes minutes, which a captured output would spend in silence.
+    """
+    import sys
+
+    from wexample_app.response.interactive_shell_command_response import (
+        InteractiveShellCommandResponse,
+    )
+
+    container = service.addon_manager.get_service_docker_container_name(
+        service.name
+    )
+    if not container:
+        raise RuntimeError(f"No Docker container found for service '{service.name}'")
+
+    locales = " ".join(locale.split())
+    force_flag = " --force" if force else ""
+    script = (
+        f"cd {APP_DIR}"
+        f" && php bin/console translations:translate-files {locales} --include-bundles{force_flag}"
+        f" && php bin/console translations:translate-content{force_flag}"
+    )
+
+    # A terminal only when there is one: an agent runs this without.
+    tty = ["-ti"] if sys.stdin.isatty() else ["-i"]
+
+    return InteractiveShellCommandResponse(
+        kernel=context.kernel,
+        content=["docker", "exec", *tty, container, "/bin/sh", "-c", script],
+    )