Add --format flag to language update commands

features/language-core.feature

@@ -476,3 +476,74 @@ Feature: Manage core translation files for a WordPress install
         | en_US     | active     |
         | nl_NL     | installed  |
     And STDERR should be empty
+
+  @require-wp-4.0
+  Scenario: Core translation update with format flag
+    Given a WP install
+    And an empty cache
+
+    When I run `wp language core update --format=json`
+    Then STDOUT should be:
+      """
+      []
+      """
+    And STDERR should be empty
+
+    When I run `wp language core update --format=csv`
+    Then STDOUT should be empty
+    And STDERR should be empty
+
+    When I run `wp language core update --format=summary`
+    Then STDOUT should contain:
+      """
+      Success: Translations are up to date.
+      """
+    And STDERR should be empty
+
+  @require-wp-6.0 @require-php-7.2
+  Scenario Outline: Core translation update with dry-run and format flag
+    Given an empty directory
+    And WP files
+    And a database
+    And I run `wp core download --version=<original> --force`
+    And wp-config.php
+    And I run `wp core install --url='localhost:8001' --title='Test' --admin_user=wpcli --admin_email=admin@example.com --admin_password=1`
+
+    When I run `wp language core install en_CA ja`
+    Then STDERR should be empty
+
+    Given I try `wp core download --version=<update> --force`
+    Then the return code should be 0
+    And I run `wp core update-db`
+
+    When I run `wp language core list --fields=language,status,update`
+    Then STDOUT should be a table containing rows:
+      | language | status    | update    |
+      | en_CA    | installed | available |
+      | ja       | installed | available |
+
+    When I run `wp language core update --dry-run --format=json`
+    Then STDOUT should be JSON containing:
+      """
+      [{"Type":"Core","Name":"WordPress","Version":"<update>"}]
+      """
+    And STDERR should be empty
+
+    When I run `wp language core update --dry-run --format=csv`
+    Then STDOUT should contain:
+      """
+      Type,Name,Version,Language
+      """
+    And STDOUT should contain:
+      """
+      Core,WordPress,<update>
+      """
+    And STDERR should be empty
+
+    When I run `wp language core update --dry-run --format=summary`
+    Then STDOUT should be empty
+    And STDERR should be empty
+
+    Examples:
+      | original | update |
+      | 6.5      | 6.6    |

features/language-plugin.feature

@@ -446,6 +446,119 @@ Feature: Manage plugin translation files for a WordPress install
     And STDERR should be empty
 
   @require-wp-4.0
+  Scenario: Plugin translation update with format flag
+    Given a WP install
+
+    When I run `wp plugin install hello-dolly --force`
+    Then STDERR should be empty
+
+    When I run `wp language plugin update hello-dolly --format=json`
+    Then STDOUT should be:
+      """
+      []
+      """
+    And STDERR should be empty
+
+    When I run `wp language plugin update --all --format=csv`
+    Then STDOUT should be empty
+    And STDERR should be empty
+
+    When I run `wp language plugin update --all --format=summary`
+    Then STDOUT should contain:
+      """
+      Success: Translations are up to date.
+      """
+    And STDERR should be empty
+
+  @require-wp-4.0
+  Scenario: Plugin translation update with format flag and actual updates
+    Given a WP install
+    And an empty cache
+
+    When I run `wp plugin install akismet --version=3.2 --force`
+    Then STDERR should be empty
+
+    When I run `wp language plugin install akismet de_DE`
+    Then STDERR should be empty
+
+    When I run `wp plugin install akismet --version=4.0 --force`
+    And I run `wp language plugin list akismet --fields=plugin,language,update,status`
+    Then STDOUT should be a table containing rows:
+      | plugin  | language | update    | status    |
+      | akismet | de_DE    | available | installed |
+
+    When I run `wp language plugin update akismet --format=json`
+    Then STDOUT should be JSON containing:
+      """
+      [{"slug":"akismet","language":"de_DE","status":"updated"}]
+      """
+    And STDERR should be empty
+
+    When I run `wp language plugin uninstall akismet de_DE`
+    And I run `wp plugin install akismet --version=3.2 --force`
+    And I run `wp language plugin install akismet de_DE`
+    And I run `wp plugin install akismet --version=4.0 --force`
+    And I run `wp language plugin update akismet --format=csv`
+    Then STDOUT should contain:
+      """
+      slug,language,status
+      """
+    And STDOUT should contain:
+      """
+      akismet,de_DE,updated
+      """
+    And STDERR should be empty
+
+    When I run `wp language plugin uninstall akismet de_DE`
+    And I run `wp plugin install akismet --version=3.2 --force`
+    And I run `wp language plugin install akismet de_DE`
+    And I run `wp plugin install akismet --version=4.0 --force`
+    And I run `wp language plugin update akismet --format=summary`
+    Then STDOUT should contain:
+      """
+      Success: Updated 1/1 translation.
+      """
+    And STDERR should be empty
+
+  @require-wp-4.0
+  Scenario: Plugin translation update with dry-run and format flag
+    Given a WP install
+    And an empty cache
+
+    When I run `wp plugin install akismet --version=3.2 --force`
+    Then STDERR should be empty
+
+    When I run `wp language plugin install akismet de_DE`
+    Then STDERR should be empty
+
+    When I run `wp plugin install akismet --version=4.0 --force`
+    And I run `wp language plugin list akismet --fields=plugin,language,update,status`
+    Then STDOUT should be a table containing rows:
+      | plugin  | language | update    | status    |
+      | akismet | de_DE    | available | installed |
+
+    When I run `wp language plugin update akismet --dry-run --format=json`
+    Then STDOUT should be JSON containing:
+      """
+      [{"Type":"Plugin","Name":"Akismet Anti-spam: Spam Protection"}]
+      """
+    And STDERR should be empty
+
+    When I run `wp language plugin update akismet --dry-run --format=csv`
+    Then STDOUT should contain:
+      """
+      Type,Name,Version,Language
+      """
+    And STDOUT should contain:
+      """
+      Plugin,Akismet Anti-spam: Spam Protection
+      """
+    And STDERR should be empty
+
+    When I run `wp language plugin update akismet --dry-run --format=summary`
+    Then STDOUT should be empty
+    And STDERR should be empty
+
   Scenario: Handle plugins with text domain different from slug
     Given a WP install
     And an empty cache

features/language-theme.feature

@@ -330,6 +330,119 @@ Feature: Manage theme translation files for a WordPress install
     And STDERR should be empty
 
   @require-wp-4.0
+  Scenario: Theme translation update with format flag
+    Given a WP install
+
+    When I try `wp theme install twentyten`
+    Then STDOUT should not be empty
+
+    When I run `wp language theme update twentyten --format=json`
+    Then STDOUT should be:
+      """
+      []
+      """
+    And STDERR should be empty
+
+    When I run `wp language theme update --all --format=csv`
+    Then STDOUT should be empty
+    And STDERR should be empty
+
+    When I run `wp language theme update --all --format=summary`
+    Then STDOUT should contain:
+      """
+      Success: Translations are up to date.
+      """
+    And STDERR should be empty
+
+  @require-wp-4.0
+  Scenario: Theme translation update with format flag and actual updates
+    Given a WP install
+    And an empty cache
+
+    When I run `wp theme install twentyfifteen --version=2.0 --force`
+    Then STDERR should be empty
+
+    When I run `wp language theme install twentyfifteen de_DE`
+    Then STDERR should be empty
+
+    When I run `wp theme install twentyfifteen --version=2.5 --force`
+    And I run `wp language theme list twentyfifteen --fields=theme,language,update,status`
+    Then STDOUT should be a table containing rows:
+      | theme         | language | update    | status    |
+      | twentyfifteen | de_DE    | available | installed |
+
+    When I run `wp language theme update twentyfifteen --format=json`
+    Then STDOUT should be JSON containing:
+      """
+      [{"slug":"twentyfifteen","language":"de_DE","status":"updated"}]
+      """
+    And STDERR should be empty
+
+    When I run `wp language theme uninstall twentyfifteen de_DE`
+    And I run `wp theme install twentyfifteen --version=2.0 --force`
+    And I run `wp language theme install twentyfifteen de_DE`
+    And I run `wp theme install twentyfifteen --version=2.5 --force`
+    And I run `wp language theme update twentyfifteen --format=csv`
+    Then STDOUT should contain:
+      """
+      slug,language,status
+      """
+    And STDOUT should contain:
+      """
+      twentyfifteen,de_DE,updated
+      """
+    And STDERR should be empty
+
+    When I run `wp language theme uninstall twentyfifteen de_DE`
+    And I run `wp theme install twentyfifteen --version=2.0 --force`
+    And I run `wp language theme install twentyfifteen de_DE`
+    And I run `wp theme install twentyfifteen --version=2.5 --force`
+    And I run `wp language theme update twentyfifteen --format=summary`
+    Then STDOUT should contain:
+      """
+      Success: Updated 1/1 translation.
+      """
+    And STDERR should be empty
+
+  @require-wp-4.0
+  Scenario: Theme translation update with dry-run and format flag
+    Given a WP install
+    And an empty cache
+
+    When I run `wp theme install twentyfifteen --version=2.0 --force`
+    Then STDERR should be empty
+
+    When I run `wp language theme install twentyfifteen de_DE`
+    Then STDERR should be empty
+
+    When I run `wp theme install twentyfifteen --version=2.5 --force`
+    And I run `wp language theme list twentyfifteen --fields=theme,language,update,status`
+    Then STDOUT should be a table containing rows:
+      | theme         | language | update    | status    |
+      | twentyfifteen | de_DE    | available | installed |
+
+    When I run `wp language theme update twentyfifteen --dry-run --format=json`
+    Then STDOUT should be JSON containing:
+      """
+      [{"Type":"Theme","Name":"Twenty Fifteen"}]
+      """
+    And STDERR should be empty
+
+    When I run `wp language theme update twentyfifteen --dry-run --format=csv`
+    Then STDOUT should contain:
+      """
+      Type,Name,Version,Language
+      """
+    And STDOUT should contain:
+      """
+      Theme,Twenty Fifteen
+      """
+    And STDERR should be empty
+
+    When I run `wp language theme update twentyfifteen --dry-run --format=summary`
+    Then STDOUT should be empty
+    And STDERR should be empty
+
   Scenario: Handle themes with text domain different from slug
     Given a WP install
     And an empty cache

src/Core_Language_Command.php

@@ -339,6 +339,18 @@ public function uninstall( $args ) {
 	 * [--dry-run]
 	 * : Preview which translations would be updated.
 	 *
+	 * [--format=<format>]
+	 * : Render output in a particular format. When not specified, updates show
+	 *   progress messages and success/warning/error messages. When specified,
+	 *   the output format changes based on the selected format.
+	 * ---
+	 * options:
+	 *   - table
+	 *   - csv
+	 *   - json
+	 *   - summary
+	 * ---
+	 *
 	 * ## EXAMPLES
 	 *
 	 *     # Update installed core languages packs.
@@ -351,7 +363,7 @@ public function uninstall( $args ) {
 	 * @subcommand update
 	 *
 	 * @param string[] $args Positional arguments.
-	 * @param array{'dry-run'?: bool} $assoc_args Associative arguments.
+	 * @param array{'dry-run'?: bool, format?: string} $assoc_args Associative arguments.
 	 */
 	public function update( $args, $assoc_args ) { // phpcs:ignore Generic.CodeAnalysis.UselessOverridingMethod.Found -- Overruling the documentation, so not useless ;-).
 		parent::update( $args, $assoc_args );

src/Plugin_Language_Command.php

@@ -588,6 +588,18 @@ public function uninstall( $args, $assoc_args ) {
 	 * [--dry-run]
 	 * : Preview which translations would be updated.
 	 *
+	 * [--format=<format>]
+	 * : Render output in a particular format. When not specified, updates show
+	 *   progress messages and success/warning/error messages. When specified,
+	 *   the output format changes based on the selected format.
+	 * ---
+	 * options:
+	 *   - table
+	 *   - csv
+	 *   - json
+	 *   - summary
+	 * ---
+	 *
 	 * ## EXAMPLES
 	 *
 	 *     # Update all installed language packs for all plugins.
@@ -600,7 +612,7 @@ public function uninstall( $args, $assoc_args ) {
 	 * @subcommand update
 	 *
 	 * @param string[] $args Positional arguments.
-	 * @param array{'dry-run'?: bool, all?: bool} $assoc_args Associative arguments.
+	 * @param array{'dry-run'?: bool, all?: bool, format?: string} $assoc_args Associative arguments.
 	 */
 	public function update( $args, $assoc_args ) {
 		$all = \WP_CLI\Utils\get_flag_value( $assoc_args, 'all', false );

src/Theme_Language_Command.php

@@ -607,6 +607,18 @@ public function uninstall( $args, $assoc_args ) {
 	 * [--dry-run]
 	 * : Preview which translations would be updated.
 	 *
+	 * [--format=<format>]
+	 * : Render output in a particular format. When not specified, updates show
+	 *   progress messages and success/warning/error messages. When specified,
+	 *   the output format changes based on the selected format.
+	 * ---
+	 * options:
+	 *   - table
+	 *   - csv
+	 *   - json
+	 *   - summary
+	 * ---
+	 *
 	 * ## EXAMPLES
 	 *
 	 *     # Update all installed language packs for all themes.
@@ -619,7 +631,7 @@ public function uninstall( $args, $assoc_args ) {
 	 * @subcommand update
 	 *
 	 *  @param string[] $args Positional arguments.
-	 * @param array{'dry-run'?: bool, all?: bool} $assoc_args Associative arguments.
+	 * @param array{'dry-run'?: bool, all?: bool, format?: string} $assoc_args Associative arguments.
 	 */
 	public function update( $args, $assoc_args ) {
 		$all = \WP_CLI\Utils\get_flag_value( $assoc_args, 'all', false );