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

He aquí un ejemplo de un comando de Salesforce para crear un nuevo proyecto Salesforce DX que contiene un indicador y un argumento.

sf project generate -n MyProject

• El comando es: sf project generate
• El indicador -n es obligatorio y le dice al sistema cómo nombrar su nuevo proyecto.
• El argumento es MyProject, que es el nombre que estamos asignando 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 indicadores son booleanos (verdadero o falso) o le indican al sistema que usted quiere configurar una variable, por ejemplo, asignar un nombre a un proyecto.
  
  Los indicadores se identifican con uno o dos guiones - -- y seguidos de un valor. Algunos comandos pueden tener indicadores obligatorios. Algunos indicadores pueden requerir argumentos. Por ejemplo, al crear un nuevo proyecto Salesforce DX, si quiere asignarle un nombre al proyecto, use el indicador -n y, luego, agregue el nombre de su proyecto como el argumento -n MyProject.
  
  Los interruptores son muy parecidos 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 suelen seguir a un indicador después de un espacio.
  Ejemplo: -n MyProject

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, veamos el comando de Salesforce CLI para crear una organización borrador y aprender cómo el uso de indicadores puede agilizar 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 al archivo de definición de la organización borrador que describe la plantilla a la que se debe hacer referencia para crear la organización borrador.
  • El segundo indicador -d configura la organización borrador recientemente creada como predeterminada. Este indicador no requiere un argumento porque también puede escribirlo como un switch --set-default. Este indicador le dice al sistema que recuerde su nombre de usuario para que, cuando ejecute comandos para esta organización borrador más adelante (por ejemplo, cuando distribuya o extraiga metadatos), no tenga que ingresar el nombre de usuario o un alias porque ya configuró la organización borrador como predeterminada usando el indicador -d.
• Argumento: El nombre del archivo consultado project-scratch-def.json es el argumento en 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 SO.
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 su directorio de trabajo impreso:

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.