Explore la estructura de comandos y la navegación

Objetivos de aprendizaje

Después de completar esta unidad, podrá:

• Nombrar las tres partes principales de una estructura de comando.
  
• Identificar el comando usado para cambiar de directorio mediante la línea de comandos.
  

Comandos generales

Echemos un vistazo a algunos comandos para ayudarle a aprender habilidades fundamentales, como navegar por la línea de comandos y crear directorios. Estas habilidades le ayudan a sentirse más cómodo cuando trabaja en la herramienta de la línea de comandos.

Antes de ejecutar un comando, analicemos cómo se estructuran los comandos.

Estructura de comandos

Todos los comandos tienen tres partes. Revisemos cada una de las partes y, luego, ejecutemos algunos comandos.

Ejemplo de comando:

$ command -flag arguments

Este es un ejemplo de un comando de Salesforce para crear un nuevo proyecto de Salesforce DX que contenga un indicador y un argumento.

sf project generate -n MyProject

• El comando es sf project generate
• El indicador -n es obligatorio y le indica al sistema qué nombre asignarle al nuevo proyecto.
  
• El argumento es MyProject, que es el nombre que le asignaremos al proyecto.
  

Echemos un vistazo a cada sección del comando y exploremos cómo está estructurado el comando hoy.

• Comando. El comando (a veces, denominado utilidad) viene primero. Le indica al sistema qué acciones quiere que realice la herramienta.
  
• Indicador. Los indicadores (a veces, llamados opciones) especifican un valor que desencadena un proceso o le indica al comando qué otras variables incluir. La mayoría de los valores de los indicadores son booleanos (verdadero o falso) o le indican al sistema que quiere establecer una variable, como la denominación de un proyecto.
  Los indicadores se identifican con uno o dos guiones - -- y están seguidos de un valor. Algunos comandos pueden tener indicadores obligatorios. Algunos indicadores pueden requerir argumentos. Por ejemplo, para crear un nuevo proyecto de Salesforce DX, si quiere asignarle un nombre, deberá usar el indicador -n y, luego, agregar el nombre del proyecto como el argumento -n MyProject.
  Los interruptores se parecen mucho a los indicadores, pero no requieren argumentos. Para los comandos de Salesforce CLI, creamos varias opciones de indicadores como interruptores para simplificar el trabajo en la herramienta de la línea de comandos.
  
• Argumentos. Los argumentos le indican al sistema qué variable quiere configurar o qué proceso quiere invocar. Los argumentos van detrás de un indicador, después de un espacio.
  Ejemplo: -n MyProject

En un argumento no debe haber espacios. Si el ejemplo anterior estuviera escrito así: -n My Project, el espacio entre My y Project se malinterpretaría como dos argumentos y probablemente fallaría.

Ahora que ya sabe qué son los indicadores y los argumentos, hablemos de cuándo y por qué usarlos.

Indicadores, interruptores y argumentos

Ya aprendió que la mayoría de los comandos pueden tener texto adicional obligatorio llamado indicadores, interruptores o argumentos. Según qué comandos ejecute, algunos indicadores y argumentos pueden cambiar el resultado de su proyecto.

Por ejemplo, veremos el comando de Salesforce CLI para crear una organización borrador y aprenderemos a usar indicadores para simplificar la ejecución de comandos más adelante.

sf org create scratch -f project-scratch-def.json -d

• Comando: la primera parte del texto es el comando, sf org create scratch. Le estamos diciendo al sistema que queremos crear una organización borrador.
  
• Indicadores: la parte restante del comando tiene dos indicadores.
  

• El primer indicador, -f, le indica al sistema que haga referencia a la definición de organización borrador que describe a qué plantilla hacer referencia a fin de crear la organización borrador.
  
• El segundo indicador, -d, establece la organización borrador recién creada como predeterminada. Este indicador no requiere un argumento porque también se lo puede escribir como un interruptor, --set-default. Este indicador le pide al sistema que recuerde su nombre de usuario de modo que, cuando ejecute comandos para esta organización borrador más adelante (por ejemplo, cuando extrae o transfiere metadatos), no tenga que ingresar el nombre de usuario o un alias porque ya estableció la organización borrador como predeterminada usando el indicador -d.
  

• Argumento: El nombre del archivo al que se hace referencia, project-scratch-def.json, es el argumento de este comando. Este archivo determina qué funciones y configuración de organización borrador (si hay alguna) se necesitan para esta nueva organización borrador.
  

A continuación, veamos cómo ejecutar comandos en la ventana de la línea de comandos.

En Mac, los siguientes comandos se ejecutan en bash o zsh. En Windows, los siguientes comandos se ejecutan en PowerShell.

Cómo ejecutar comandos

Para ejecutar un comando, escriba el comando en la ventana de la línea de comandos y pulse Intro. Si ve el símbolo del dólar $ (macOS/Linux) o el símbolo de mayor que > (Windows) en la línea siguiente, el comando se ejecutó. Si un comando no se ejecuta, aparece un error en la ventana de la línea de comandos y suele mostrarse una descripción del error. Cuando ejecute comandos, tenga en cuenta que las mayúsculas son importantes. Por ejemplo, myProject y MyProject son dos nombres de proyecto diferentes.

Ahora que sabe cómo ejecutar comandos en la herramienta de la línea de comandos, practique esta habilidad con comandos de navegación.

Comandos de navegación

Los comandos de navegación son los que probablemente ejecutará con más frecuencia. Para crear proyectos y directorios, debe aprender a entrar y salir de cada directorio.

Lea la línea de comandos para ver dónde se encuentra ahora:

Para ver en qué lugar de su directorio está, consulte siempre la ruta de la línea de comandos. Si abre una nueva ventana en la línea de comandos, es probable que llegue a la ruta del directorio inicial.

• Directorio inicial en macOS: yourname-ltm:~ yourname$
• Directorio inicial en Windows: PS C:\Users\yourname>

Cambie de directorio:

Para dar un paso más hacia el siguiente directorio, escriba cd (que significa "cambiar directorio") y escriba el nombre del directorio. Vayamos al directorio Documentos. Este comando es el mismo para ambos sistemas operativos.

cd Documents

Cree un directorio nuevo:

Ahora, cree un nuevo directorio vacío. Para hacerlo, escriba el comando mkdir con el nombre del directorio que desea crear. Este comando es el mismo para ambos sistemas operativos.

mkdir Resume

Acaba de crear un directorio nuevo dentro del directorio Documentos.

Navegue por varios directorios:

Si desea navegar más profundamente por varios directorios, debe usar el comando cd, pero agregar la ruta del directorio al que desea navegar. Según su sistema operativo, esta ruta puede escribirse de manera diferente. Ahora, navegue a un directorio llamado Resume en Documents. Suponga que está navegando a una carpeta que se encuentre dentro de otra. (Recuerde que las mayúsculas son importantes).

• macOs: cd ~/Documents/Resume
• Windows: cd ~\Documents\Resume

Debe estar en el directorio Resume.

Navegue a un nivel anterior:

En ocasiones, al navegar por varios directorios, es necesario retroceder un nivel. Para hacerlo, debe seguir usando el comando cd, seguido de dos puntos consecutivos. Este comando es el mismo para ambos sistemas operativos.

cd ..

Ya debe haber regresado al nivel Documents.

Si se pierde y necesita ver el directorio de trabajo actual:

Si quiere ver la ruta del directorio y su ubicación actual, ejecute este comando.

• macOs: pwd
• Windows: cd

Ya navega como un profesional.

Vea el historial de la línea de comandos

Para ver un registro del historial de comandos que ejecutó, escriba: history (historial). O bien, en Windows: utilice el acceso directo del teclado F7. Al ejecutar el comando, verá un registro de los comandos con números junto a cada comando.

Si desea volver a ejecutar un comando para macOS/Linux, puede escribir !, agregar el número del comando y pulsar Intro para volver a ejecutar el comando.

Por ejemplo: !499 volverá a ejecutar el comando de cambio de directorio.

A continuación, configuremos las herramientas de la línea de comandos.