translate command

src/Commands/TranslateTranslationsCommand.php

@@ -0,0 +1,56 @@
+<?php
+
+namespace Elegantly\Translator\Commands;
+
+use Elegantly\Translator\Facades\Translator;
+use Illuminate\Console\Command;
+
+class TranslateTranslationsCommand extends Command
+{
+    public $signature = 'translator:translate {--from=} {--to=} {--all}';
+
+    public $description = 'Translate translations from the given locale to the target one.';
+
+    public function handle(): int
+    {
+        $from = (string) $this->argument('from');
+        $to = $this->argument('to');
+        $all = (bool) $this->argument('all');
+
+        $namespaces = Translator::getNamespaces($from);
+
+        $targets = collect($to ? [(string) $to] : Translator::getLanguages())->filter(fn ($locale) => $locale !== $from);
+
+        foreach ($targets as $target) {
+
+            $this->info("Translating from {$from} to {$target}:");
+
+            foreach ($namespaces as $namespace) {
+
+                if ($all) {
+                    $keys = Translator::getTranslations($from, $namespace)->dot()->keys()->toArray();
+                } else {
+                    $keys = Translator::getMissingTranslations($from, $target, $namespace);
+                }
+
+                if (! $this->confirm(count($keys)." found for {$target}.{$namespace}, would you like to continue?")) {
+                    continue;
+                }
+
+                $translations = Translator::translateTranslations(
+                    $from,
+                    $target,
+                    $namespace,
+                    $keys
+                );
+
+                $this->table(
+                    headers: ['key', 'Translation'],
+                    rows: $translations->dot()->map(fn ($value, $key) => ["{$namespace}.{$key}", $value])
+                );
+            }
+        }
+
+        return self::SUCCESS;
+    }
+}

src/Facades/Translator.php

@@ -2,13 +2,16 @@
 
 namespace Elegantly\Translator\Facades;
 
+use Elegantly\Translator\Translations;
 use Illuminate\Support\Facades\Facade;
 
 /**
- * @method static array getLanguages()
- * @method static array getNamespaces(string $locale)
+ * @method static array<int, string> getLanguages()
+ * @method static array<int, string> getNamespaces(string $locale)
+ * @method static Translations getTranslations(string $locale, string $namespace)
  * @method static Translations sortTranslations(string $locale, string $namespace)
- * @method static array getMissingTranslations(string $referenceLocale, string $targetLocale, string $namespace)
+ * @method static Translations translateTranslations(string $referenceLocale, string $targetLocale, string $namespace, array $keys)
+ * @method static array<int, string> getMissingTranslations(string $referenceLocale, string $targetLocale, string $namespace)
  * @method static array getAllMissingTranslations(string $referenceLocale)
  * @method static void sortAllTranslations()
  *

src/Translations.php

@@ -8,7 +8,7 @@
 /**
  * @extends Collection<string|int, array|string|int|float|null>
  */
-class Translations extends Collection
+final class Translations extends Collection
 {
     //
 
@@ -91,4 +91,18 @@ public function getMissingTranslationsIn(Translations $translations): array
             ->keys()
             ->toArray();
     }
+
+    public function only($keys): static
+    {
+        return new static(
+            $this->toBase()->dot()->only($keys)->undot()
+        );
+    }
+
+    public function except($keys): static
+    {
+        return new static(
+            $this->toBase()->dot()->except($keys)->undot()
+        );
+    }
 }

src/Translator.php

@@ -92,7 +92,7 @@ function (Translations $translations) use ($values) {
 
                 return $translations;
             }
-        );
+        )->only(array_keys($values));
     }
 
     public function setTranslation(
@@ -139,7 +139,7 @@ function (Translations $translations) use ($referenceLocale, $targetLocale, $nam
 
                 return $translations;
             }
-        );
+        )->only($keys);
     }
 
     public function translateTranslation(

tests/Unit/TranslationsTest.php

@@ -71,3 +71,29 @@
         'f.a',
     ]);
 });
+
+it('filters (nested) translations using only', function () {
+    $translations = new Translations([
+        'a' => 'text',
+        'b' => 'text',
+        'c' => [
+            'a' => 'text',
+            'b' => 'text',
+        ],
+        'd' => 'text',
+        'e' => 'text',
+        'f' => [
+            'a' => 'text',
+        ],
+    ]);
+
+    expect(
+        $translations->only(['a', 'c.a', 'd'])->toArray()
+    )->toBe([
+        'a' => 'text',
+        'c' => [
+            'a' => 'text',
+        ],
+        'd' => 'text',
+    ]);
+});