Add --lang= parameter and simple file listing to sync XML tools

Allow all qaxml-*.php scripts to accept --lang=XX to specify the
target language directly, without requiring temp/lang from
configure.php. Also accept file paths as positional arguments
for checking specific files instead of the full translation tree.

Existing behavior without parameters is preserved. Relates to #199.

Author: lacatoire

scripts/translation/libqa/SyncFileList.php

@@ -21,32 +21,57 @@
 
 class SyncFileList
 {
-    static function load()
+    static function load( ?string $lang = null , array $files = [] )
     {
-        $file = __DIR__ . "/../../../temp/lang";
-        if ( ! file_exists( $file ) )
+        if ( $lang === null )
         {
-            fwrite( STDERR , "Language file not found, run 'doc-base/configure.php'.\n" );
-            exit();
+            $file = __DIR__ . "/../../../temp/lang";
+            if ( ! file_exists( $file ) )
+            {
+                fwrite( STDERR , "Language not found, run 'doc-base/configure.php' or use '--lang='.\n" );
+                exit();
+            }
+            $lang = trim( file_get_contents( $file ) );
+        }
+
+        $sourceDir = 'en';
+        $targetDir = $lang;
+
+        if ( count( $files ) > 0 )
+        {
+            $ret = [];
+
+            foreach ( $files as $file )
+            {
+                if ( ! file_exists( "$targetDir/$file" ) )
+                    continue;
+
+                $item = new SyncFileItem();
+                $item->sourceDir = $sourceDir;
+                $item->targetDir = $targetDir;
+                $item->file = $file;
+                $ret[] = $item;
+            }
+
+            if ( $ret === [] )
+                throw new Exception( "No matching files found." );
+
+            return $ret;
         }
 
-        $lang = trim( file_get_contents( $file ) );
         $cacheFilename = __DIR__ . "/../../../temp/qaxml.files.$lang";
 
         if ( file_exists( $cacheFilename ) )
         {
             return unserialize( gzdecode( file_get_contents( $cacheFilename ) ) );
         }
 
-        $sourceDir = 'en';
-        $targetDir = $lang;
-
         require_once __DIR__ . '/../lib/all.php';
 
-        $files = new RevcheckFileList( $sourceDir );
+        $revFiles = new RevcheckFileList( $sourceDir );
         $ret = [];
 
-        foreach( $files->iterator() as $file )
+        foreach( $revFiles->iterator() as $file )
         {
             if ( ! file_exists( "$targetDir/{$file->file}" ) )
                 continue;

scripts/translation/qaxml-attributes.php

@@ -22,10 +22,18 @@
 $argv   = new ArgvParser( $argv );
 $ignore = new OutputIgnore( $argv ); // may exit.
 $urgent = $argv->consume( "--urgent" ) != null;
-
-$list   = SyncFileList::load();
+$lang   = $argv->consume( prefix: "--lang=" );
+$files  = [];
+foreach ( $argv->residual() as $arg )
+    if ( strlen( $arg ) > 0 && $arg[0] != '-' )
+    {
+        $files[] = $arg;
+        $argv->use( $arg );
+    }
 $argv->complete();
 
+$list   = SyncFileList::load( $lang , $files );
+
 foreach ( $list as $file )
 {
     $source = $file->sourceDir . '/' . $file->file;

scripts/translation/qaxml-entities.php

@@ -22,19 +22,26 @@
 $argv   = new ArgvParser( $argv );
 $ignore = new OutputIgnore( $argv ); // may exit.
 $urgent = $argv->consume( "--urgent" ) != null;
+$lang   = $argv->consume( prefix: "--lang=" );
 
-$ents = [];
-foreach( $argv->residual() as $ent )
+$ents  = [];
+$files = [];
+foreach( $argv->residual() as $arg )
 {
-    if ( strlen( $ent ) > 2 && $ent[0] == '-' && $ent[1] != '-' )
+    if ( strlen( $arg ) > 2 && $arg[0] == '-' && $arg[1] != '-' )
     {
-        $ents[] = '&' . substr( $ent , 1) . ';';
-        $argv->use( $ent );
+        $ents[] = '&' . substr( $arg , 1) . ';';
+        $argv->use( $arg );
+    }
+    elseif ( strlen( $arg ) > 0 && $arg[0] != '-' )
+    {
+        $files[] = $arg;
+        $argv->use( $arg );
     }
 }
 $argv->complete();
 
-$list = SyncFileList::load();
+$list = SyncFileList::load( $lang , $files );
 
 foreach ( $list as $file )
 {

scripts/translation/qaxml-pi.php

@@ -21,9 +21,17 @@
 
 $argv   = new ArgvParser( $argv );
 $ignore = new OutputIgnore( $argv ); // may exit.
+$lang   = $argv->consume( prefix: "--lang=" );
+$files  = [];
+foreach ( $argv->residual() as $arg )
+    if ( strlen( $arg ) > 0 && $arg[0] != '-' )
+    {
+        $files[] = $arg;
+        $argv->use( $arg );
+    }
 $argv->complete();
 
-$list   = SyncFileList::load();
+$list   = SyncFileList::load( $lang , $files );
 
 foreach ( $list as $file )
 {

scripts/translation/qaxml-revtag.php

@@ -23,9 +23,17 @@
 $argv   = new ArgvParser( $argv );
 $ignore = new OutputIgnore( $argv ); // may exit.
 $ignore->appendIgnoreCommands = false;
+$lang   = $argv->consume( prefix: "--lang=" );
+$files  = [];
+foreach ( $argv->residual() as $arg )
+    if ( strlen( $arg ) > 0 && $arg[0] != '-' )
+    {
+        $files[] = $arg;
+        $argv->use( $arg );
+    }
 $argv->complete();
 
-$list   = SyncFileList::load();
+$list   = SyncFileList::load( $lang , $files );
 
 foreach ( $list as $file )
 {

scripts/translation/qaxml-tags.php

@@ -23,13 +23,20 @@
 $ignore = new OutputIgnore( $argv ); // may exit.
 $detail = $argv->consume( "--detail" ) != null;
 $tags   = explode( ',' , $argv->consume( prefix: "--content=" ) ?? "" );
-
+$lang   = $argv->consume( prefix: "--lang=" );
+$files  = [];
+foreach ( $argv->residual() as $arg )
+    if ( strlen( $arg ) > 0 && $arg[0] != '-' )
+    {
+        $files[] = $arg;
+        $argv->use( $arg );
+    }
 $argv->complete();
 
 if ( count( $tags ) == 1 && $tags[0] == "" )
     $tags = [];
 
-$list = SyncFileList::load();
+$list = SyncFileList::load( $lang , $files );
 
 foreach ( $list as $file )
 {

scripts/translation/qaxml-ws.php

@@ -22,9 +22,17 @@
 
 $argv   = new ArgvParser( $argv );
 $ignore = new OutputIgnore( $argv ); // may exit.
+$lang   = $argv->consume( prefix: "--lang=" );
+$files  = [];
+foreach ( $argv->residual() as $arg )
+    if ( strlen( $arg ) > 0 && $arg[0] != '-' )
+    {
+        $files[] = $arg;
+        $argv->use( $arg );
+    }
 $argv->complete();
 
-$list   = SyncFileList::load();
+$list   = SyncFileList::load( $lang , $files );
 
 foreach ( $list as $file )
 {