lingo purge
Consulta una vista previa de la eliminación de archivos de destino y qué entradas del Lockfile se eliminan.
lingo purge sirve para eliminar deliberadamente los archivos de destino derivados. En el modo de archivos normal, muestra una vista previa de las rutas seleccionadas; --yes ejecuta la eliminación. Con --file o --locale, solo elimina los destinos seleccionados y sus entradas del Lockfile, y conserva los estados de referencia del origen y las entradas de los demás destinos. Sin filtros, también elimina todo el Lockfile del proyecto.
Vista previa de un destino normal #
Para una estructura JSON con archivos separados:
lingo purge --locale de --file locales/en.jsonComprueba que el destino indicado sea el archivo que quieres eliminar. Guarda los resultados aceptados antes de añadir --yes. Si la regeneración falla más adelante, la eliminación ya se habrá realizado.
| Opción | Comportamiento |
|---|---|
--locale <locale> | Filtro de destinos que se puede repetir; usa los destinos configurados por defecto. No admite el idioma de origen. |
--file <value> | Filtro de rutas de origen que se puede repetir, o ruta de origen concreta para entradas con patrones glob. |
--lockfile-only | Elimina solo .lingo/lock.json; requiere --yes y no se puede combinar con --file ni con --locale. |
--yes, -y | Ejecuta la eliminación en lugar de mostrar la vista previa del modo de archivos. |
Se rechazan las rutas derivadas que quedan fuera de la raíz del proyecto, incluidas las que apuntan fuera de ella o a .git a través de un enlace simbólico; purge informa de ellas incluso sin --yes. Los archivos dentro de la raíz también pueden contener datos de origen o compartidos valiosos, así que comprueba su función además de su ubicación.
Selección de archivos #
Purge obtiene las rutas a partir de los orígenes concretos configurados y de los valores concretos de --file. Omite los patrones glob configurados, salvo que se proporcionen rutas de origen concretas. Para las entradas de configuración concretas, --file filtra por subcadena; no realiza una expansión general de patrones glob.
Purge omite los destinos cuya ruta coincide con la de origen e indica que sus traducciones se encuentran en el archivo de origen. Los catálogos XCStrings compartidos usan esta estructura, por lo que purge no puede eliminar un único idioma de ellos. Usa en su lugar el flujo de trabajo de corrección del catálogo de cadenas.
Cambios en el Lockfile #
Una purga con filtros elimina las entradas de los destinos seleccionados aunque sus archivos ya no existan. Conserva los hashes de origen, de modo que los cambios pendientes en el origen pueden seguir llegando a otros idiomas en un envío posterior. Si el Lockfile tiene un formato incorrecto, la purga con filtros se detiene antes de eliminar ningún destino; restáuralo o repáralo antes de volver a intentarlo.
Sin filtros, lingo purge --yes y lingo purge --lockfile-only --yes eliminan todo el Lockfile. La eliminación exclusiva del Lockfile sin --yes requiere confirmación en lugar de mostrar la vista previa normal de los archivos.
La ausencia del Lockfile cambia la planificación incremental; no garantiza que el modelo genere resultados nuevos, ya que la reutilización en el servidor es independiente. Para los casos habituales de archivos ausentes, usa la reposición. Para las entradas obsoletas de React, usa la limpieza. Si el trabajo se ha interrumpido, empieza por la recuperación y conserva el estado disponible.