Lingo check

Haz que la CI falle si las traducciones están desactualizadas y comprueba los catálogos de React.

lingo check falla cuando las traducciones están desactualizadas. Compara cada archivo de origen con .lingo/lock.json, exige que existan todos los archivos de destino y, en los proyectos @lingo.dev/react, también comprueba los catálogos extraídos, las declaraciones, el contexto y las traducciones.

sh
lingo check --json

Qué comprobaciones se ejecutan #

ComprobaciónSe ejecuta cuando
Comprobación de archivos.lingo/config.json contiene files o el proyecto no es de React.
Comprobaciones de ReactEl package.json de la raíz, o el más cercano a --src, incluye @lingo.dev/react, @lingo.dev/react-next o @lingo.dev/react-tanstack, o existe el archivo de declaraciones generado (lingo.d.ts por defecto).

En un proyecto de React con files se ejecutan ambas comprobaciones. Si ningún patrón files coincide con un archivo, la comprobación falla con no-source-files, al igual que lingo push, salvo en los proyectos de React, donde solo se ejecutan las comprobaciones de React y se indica en stderr. Un proyecto sin files ni React falla con el mismo error de configuración que lingo push.

lingo check no necesita ninguna clave de API ni escribe nada. Aparte de la telemetría de la CLI, que DO_NOT_TRACK=1 desactiva, no realiza ninguna llamada de red. Termina con el código 1 si detecta algún problema o encuentra un error de configuración (por ejemplo, una colisión de destinos o un Lockfile dañado), y con el código 0 en caso contrario.

Comprobación de archivos #

Los archivos de origen son los que enviaría lingo push. Los destinos son las rutas en las que escribiría el comando push para cada idioma de destino configurado.

CasoProblemaSolución
Un archivo de origen coincide con su entrada en el Lockfile y existen sus archivos de destinoninguno
Ningún patrón files coincide con un archivono-source-filesCorrige los patrones files
Un archivo de origen ha cambiado desde su última traducciónsource-changedlingo push --wait, o lingo pull si aún hay un push en curso
Un archivo de origen no tiene una entrada en el Lockfilesource-not-pushedlingo push --wait
Falta un archivo de destino y su archivo de origen está actualizadomissing-targetlingo push --backfill-missing --wait
Falta un archivo de destino y su archivo de origen ha cambiado o nunca se ha enviadomissing-targetlingo push --wait
Un archivo de destino se ha editado manualmenteninguno
No hay Lockfile y existen todos los archivos de destinoninguno, con una nota en stderr
No hay Lockfile y falta un archivo de destinomissing-target, con una nota en stderrlingo push --backfill-missing --wait, después incluye los archivos de destino y .lingo/lock.json en un commit

Se ignoran las entradas del Lockfile cuyas rutas ya no están configuradas como archivos de origen. Las advertencias sobre destinos inferidos y archivos YAML omitidos que muestra lingo push también aparecen aquí, en stderr.

Cómo interpretar un problema #

TipoPosible solución
missing-contextAñade contexto útil al mensaje extraído.
stale-jsoncVuelve a generar el catálogo de origen y examínalo.
stale-typesVuelve a generar las declaraciones e inclúyelas en la comprobación de tipos de la aplicación.
missing-translationExamina una clave activa que no tenga ningún valor de destino activo con contenido.
orphanedAntes de limpiar, determina si el mensaje se ha eliminado o si la extracción no lo ha detectado.

Consulta los problemas de la comprobación de archivos y sus soluciones en Comprobación de archivos.

Salida JSON #

La salida JSON contiene issues y stats. La salida en formato legible enumera los mismos problemas para su uso local.

Cada problema tiene type y message. Los problemas de React pueden tener src; los de archivos tienen file, y un problema missing-target también tiene locale.

Las estadísticas contienen messages, locales, missingContext, missingTranslations, orphaned, staleJsonc y staleTypes, cuyos valores son cero o falso cuando no se han ejecutado las comprobaciones de React. El número de idiomas incluye los destinos detectados y el idioma de origen. Cuando se ha ejecutado la comprobación de archivos, stats.files contiene lockfile, sources, locales, changedSources y missingTargets. Estos valores describen la coherencia, no la calidad lingüística medida.

Ejecútalo en CI #

Ejecútalo en cada solicitud de incorporación o de fusión, incluidas las que procedan de bifurcaciones:

yaml
- uses: actions/checkout@v4
- run: npx @lingo.dev/cli@latest check

Usa los mismos parámetros que en la extracción #

--src, --out, --types y --source-locale solo se aplican a las comprobaciones de React. El valor por defecto de --src es src, y el de --source-locale es en. --out tiene prioridad sobre la ruta del catálogo configurada y, después, sobre locales; --types tiene prioridad sobre la ruta de las declaraciones configurada y, después, sobre lingo.d.ts. Las rutas se resuelven desde la raíz del proyecto. El valor por defecto del idioma de origen es independiente de la configuración de localización. El valor por defecto de --json es falso y se aplica a ambas comprobaciones.

Ejecuta la extracción con esos mismos parámetros para poner al día lo que esté desactualizado. Examina las advertencias y las diferencias y, después, vuelve a ejecutar la comprobación y la compilación de la aplicación. Limpia solo las entradas que hayas confirmado como obsoletas y, a continuación, vuelve a generar las declaraciones.

Limitaciones #

  • La comprobación de archivos trabaja a nivel de archivo. No informa de las claves que faltan dentro de un archivo de destino existente, salvo en los catálogos .jsonc de React.
  • No se comprueban los idiomas dentro de un único catálogo compartido, como un archivo .xcstrings, y cualquier edición manual dentro de él cuenta como un cambio en el archivo de origen.
  • Un repositorio que haya pasado de la CLI a la GitHub App debería eliminar .lingo/lock.json.
  • Los errores de configuración, como dos archivos de origen que se resuelven al mismo destino o un Lockfile dañado, hacen que el proceso termine con el código 1, con un mensaje en stderr y sin JSON.
  • Los hashes de origen reflejan los bytes exactos, por lo que el checkout en el que se ejecutó lingo push y el checkout de CI deben usar los mismos finales de línea. Añade * text=auto eol=lf a .gitattributes.

En los catálogos de React, los destinos son los archivos .jsonc del directorio del catálogo. Cuando los patrones files coinciden con el catálogo de origen (por ejemplo, locales/en.jsonc), también se exige que exista el archivo de cada idioma de destino configurado.

Solo las advertencias de extracción por falta de contexto se convierten en problemas de contexto. Las advertencias sobre expresiones dinámicas y la información sobre colisiones no constituyen aquí un criterio exhaustivo de fallo; la propia extracción impone el fallo cuando hay colisiones. Un texto de relleno con contenido en el idioma de origen también puede superar la comprobación de presencia sin ser una traducción.

Usa extract --check cuando solo necesites comprobar que los bytes generados están actualizados. Mantén la validación del formato nativo y la revisión del contenido junto con esta herramienta; superar la comprobación no garantiza nada sobre los recursos de Android, la representación de Markdown ni el significado de las traducciones más allá de lo que realmente comprueba.