Looking for an English version?
Comandos Disponibles
-
clearlvcache - Una herramienta de G-CLI para limpiar la caché de LabVIEW.
-
vipc - Una herramienta de G-CLI para aplicar archivos VIPC.
-
lvbuildspec - Una herramienta de G-CLI para compilar especificaciones de compilación de LabVIEW.
-
vitester - Una herramienta de G-CLI para ejecutar pruebas de VI Tester
-
lunit - Una herramienta de G-CLI para ejecutar pruebas LUnit.
-
vipb - Una herramienta de G-CLI para compilar paquetes VIPM a partir de especificaciones de compilación .vipb.
-
vip - Una herramienta de G-CLI para instalar paquetes VIPM.
-
switcheroo - Una herramienta de G-CLI para intercambiar bibliotecas de código fuente y así probar PPLs y paquetes VIPM.
clearlvcache
Descripción
Esta herramienta limpia tanto la caché de AppBuilder como la caché de CompiledObject. Generalmente la uso como uno de los primeros pasos de un trabajo, especialmente si estás ejecutando tu trabajo en una VM en lugar de una imagen Docker. Puede que no sea tan útil para trabajos que se ejecutan en Docker, ya que presumiblemente cada ejecución del trabajo comienza desde cero al iniciar un nuevo contenedor.
NOTA: en G-CLI versión 3.0+ esto puede ser reemplazado con el comando ClearCache incorporado.
Opciones
Esta herramienta de G-CLI no tiene opciones. Simplemente la invocas directamente desde G-CLI.
Ejemplos
# Dejamos fuera las opciones de G-CLI para la simplicidad
# Es un ejemplo muy simple
g-cli clearlvcache
Repositorio
Para más información y para ver el código fuente, consulta el repositorio aquí:
https://gitlab.com/sas-gcli-tools/clearlvcache
vipc
Descripción
Esta herramienta te permite aplicar un archivo de configuración de paquetes VI (vipc) usando G-CLI. Indicas el archivo vipc y la versión de LabVIEW, y esta herramienta verificará si es necesario aplicarlo y lo aplicará si es necesario.
Opciones
Esta herramienta de G-CLI tiene las siguientes opciones:
| indicador | parámetros | requerido | descripción |
|---|---|---|---|
| --lv-version, -v | Versión de LabVIEW | no | Versión de LabVIEW en la que instalar el VIPC. Por defecto usa la versión interna del archivo VIPC. Si es LabVIEW de 64 bits debes especificarla. Ejemplo 22.3 (64-bit). |
| --timeout, -t | tiempo de espera de la API de VIPM | no | Tiempo de espera para la API de VIPM. Por defecto 300s |
Ejemplos
# Dejamos fuera las opciones de G-CLI para la simplicidad
# -- separa las opciones de g-cli de las opciones específicas de esta herramienta.
g-cli vipc -- -v "22.3 (64-bit)" myvipcfile.vipc # Aplica myvipcfile.vipc a LabVIEW 22Q3 64 bit
Repositorio
Para más información y para ver el código fuente, consulta el repositorio aquí:
https://gitlab.com/sas-gcli-tools/vipc
lvbuildspec
Descripción
Esta herramienta te permite compilar especificaciones de compilación de LabVIEW usando G-CLI. Puedes proporcionar manualmente un número de compilación o usar la funcionalidad de autoincremento integrada de LabVIEW.
Opciones
Esta herramienta de G-CLI tiene las siguientes opciones:
| indicador | parámetros | requerido | descripción |
|---|---|---|---|
| --project, --proj, -p | ruta del proyecto | sí | Proyecto que contiene la especificación de compilación. |
| --buildspec, -b | especificación de compilación a compilar | sí | Especificación de compilación específica a compilar. |
| --target, -t | destino para el cual compilar | no | Destino que contiene la especificación de compilación. Por defecto es MyComputer. |
| --version, -v | versión | no | Número de versión x.x.x.x a asignar a la compilación. Si se deja vacío, simplemente usa lo que esté configurado actualmente en el proyecto de LabVIEW. --manualversion y -mv también funcionan por compatibilidad con versiones anteriores, pero están obsoletos y eventualmente serán eliminados. |
| --no-clean, -nc | sin limpieza | no | Omite la limpieza; usa esto para instaladores para evitar un error de LabVIEW donde limpiar el instalador elimina los ejecutables y luego falla la compilación del instalador. |
Ejemplos
# Dejamos fuera las opciones de G-CLI para la simplicidad
# -- separa las opciones de g-cli de las opciones específicas de esta herramienta.
g-cli lvbuildspec -- -p myproject.lvproj -b myexe -v 1.2.3.4 # compila mi exe con el número de versión establecido en 1.2.3.4
Repositorio
Para más información y para ver el código fuente, consulta el repositorio aquí:
https://gitlab.com/sas-gcli-tools/lvbuildspec
vitester
Descripción
Esta herramienta ejecuta un conjunto de pruebas de vitester y genera un archivo de informe JUnit.
Opciones
Esta herramienta de G-CLI tiene las siguientes opciones:
| indicador | parámetros | requerido | descripción |
|---|---|---|---|
| --report, -r | ruta del informe | sí | Ruta donde escribir el informe JUnit. |
Ejemplos
# Dejamos fuera las opciones de G-CLI para la simplicidad
# es realmente así de simple.
g-cli vitester -- -r UnitTestReport.xml myproject.lvproj # esto apunta a un proyecto, también puedes apuntar a una Test Case o Test Suite Class
Repositorio
Para más información y para ver el código fuente, consulta el repositorio aquí:
https://gitlab.com/sas-gcli-tools/vitester
lunit
Descripción
Esta herramienta te permite ejecutar pruebas LUnit desde la CLI usando G CLI.
Opciones
Esta herramienta de G-CLI tiene las siguientes opciones:
| indicador | parámetros | requerido | descripción |
|---|---|---|---|
| --report, -r, | ruta del informe | sí | Ruta al informe |
| --parallel | parallel | no | Indicador para ejecutar las pruebas en paralelo |
Los argumentos finales se interpretan como rutas. Normalmente este es el proyecto de LabVIEW en el que quieres buscar pruebas para ejecutar.
Ejemplos
# Dejamos fuera las opciones de G-CLI para la simplicidad
# -- separa las opciones de g-cli de las opciones específicas de esta herramienta.
g-cli lunit -- -r UnitTestReport.xml mylabviewproject.lvproj # Ejecuta todas las pruebas lunit encontradas en mylabviewproject.lvproj
Repositorio
Para más información y para ver el código fuente, consulta el repositorio aquí:
https://gitlab.com/sas-gcli-tools/lunit
vipb
Descripción
Esta herramienta te permite compilar paquetes VIPM desde la CLI usando G CLI.
Opciones
Esta herramienta de G-CLI tiene las siguientes opciones:
| indicador | parámetros | requerido | descripción |
|---|---|---|---|
| --buildspec, -b, | especificación de compilación | sí | Ruta al archivo vipb a compilar |
| --version, -v | versión | no | Versión a compilar |
| --release-notes, -r | archivo de notas de versión | no | Ruta a un archivo que contiene las notas de la versión |
| --timeout, -t | tiempo de espera | no | Tiempo de espera en segundos; por defecto 1200 = 20 minutos |
Ejemplos
# Dejamos fuera las opciones de G-CLI para la simplicidad
# -- separa las opciones de g-cli de las opciones específicas de esta herramienta.
g-cli vipb -- -b MyBuildspec.vipb -v 1.2.3.4 # compila la versión 1.2.3.4
Repositorio
Para más información y para ver el código fuente, consulta el repositorio aquí:
https://gitlab.com/sas-gcli-tools/vipb
vip
Descripción
Esta herramienta te permite instalar un archivo VIP individual desde la CLI usando G CLI. Esto es útil para instalar paquetes con fines de prueba después de compilarlos. Para la gestión general de dependencias usa la herramienta vipc
Opciones
Esta herramienta de G-CLI tiene las siguientes opciones:
| indicador | parámetros | requerido | descripción |
|---|---|---|---|
| --local-vip-file | paquete a instalar | no | Instala un archivo de paquete específico |
| --timeout, -t | tiempo de espera de la API de VIPM | no | Tiempo de espera en segundos; por defecto 1200 = 20 minutos |
| --lv-version, -lv | Versión de LabVIEW | sí | Versión de LabVIEW en la que instalar el VIPC |
| --list | list | no | Lista todas las versiones de LabVIEW disponibles |
| --list_packages | list_packages | no | Lista todos los paquetes disponibles e instalados para una versión particular de LabVIEW |
Ejemplos
# Dejamos fuera las opciones de G-CLI para la simplicidad
# -- separa las opciones de g-cli de las opciones específicas de esta herramienta.
g-cli vip -- --lv-version "20.0 (64-bit)" --local-vip-file "path_to_my_package.vip" # instala mi paquete desde el archivo vip.
# para ver las versiones de LV
g-cli vip -- --list
# para ver los paquetes instalados y disponibles
g-cli vip -- --list_packages --lv-version "20.0 (64-bit)"
# para instalar un paquete específico desde VIPM (es decir, no un archivo local)
g-cli vip -- --lv-version "20.0 (64-bit)" "name_of_package-1.1.1.1"
Repositorio
Para más información y para ver el código fuente, consulta el repositorio aquí:
https://gitlab.com/sas-gcli-tools/vip
switcheroo
Descripción
Una herramienta de G-CLI para intercambiar bibliotecas de código fuente con PPLs y paquetes VIPM instalados para realizar pruebas. Te permite escribir pruebas una sola vez para el código fuente y luego reutilizar esas pruebas contra la biblioteca compilada/instalada.
Opciones
Esta herramienta de G-CLI tiene las siguientes opciones:
| indicador | parámetros | requerido | descripción |
|---|---|---|---|
| --test-dir, -t | directorio de pruebas | sí | Directorio de pruebas a cargar; estos son los llamadores de la biblioteca que vas a reemplazar. |
| --original, -o | biblioteca original | sí | Biblioteca a ser reemplazada |
| --replacement, -r | biblioteca de reemplazo | sí | La biblioteca original será reemplazada por esta. |
NOTA: para original y replacement puedes usar <vilib>, que será reemplazado por la ruta a vilib.
Ejemplos
# Dejamos fuera las opciones de G-CLI para la simplicidad
# -- separa las opciones de g-cli de las opciones específicas de esta herramienta.
g-cli switcheroo -- -t "tests" -o "mylib.lvlib" -r "mylib.lvlibp"
o
g-cli switcheroo -- -t "tests" -o "mylib.lvib" -r "<vilib>/myrenamedlib.lvlib"
Repositorio
Para más información y para ver el código fuente, consulta el repositorio aquí:
https://gitlab.com/sas-gcli-tools/switcheroo
Herramientas CLI de Terceros para otros comandos comunes
Estas son herramientas para las que no implementé comandos G-CLI, ya que ya están disponibles.
Pueden resultarte útiles. No las documentaré aquí, ya que los desarrolladores originales ya lo hicieron.