En palabras muy simples una interfaz de línea de comandos (CLI en inglés) te permite dar instrucciones. Instrucciones que un programa informático entiende.
En palabras todavía más simples: ¿Recuerdas aquellas películas donde un hacker se apodera de todo el dinero de un banco solo usando un laptop?—aquel hacker estaba haciendo sus fechorías por medio de una línea de comandos.
No te asustes, nada de lo que a continuación leerás es una tarea marciana que solo un profesional de la computación puede hacer. Te cambio la perspectiva: Usando Bootic CLI podrás editar el diseño de una tienda desde la comodidad de tu editor de código favorito sin pasar por una interfaz web. ¿Te gusta la idea?... ¡vamos!
Antes de comenzar la instalación del CLI es necesario que tengas una aplicación creada en tu tienda Bootic. Para esto sigue los siguientes pasos:
Perfecto, ahora la instalación.
Para hacer uso de Bootic CLI es preciso tener instalado un intérprete Ruby en tu compurador, esto porque que el cliente es un programa ruby.
Alternativas existen muchas, acá te recomendamos RubyInstaller. Se instala como si instalaras un software más.
A continuación te dejamos un grupo de capturas. Importante: La versión 2.7 es más que suficiente, ten presente que las capturas de pantalla corresponden a la version 2.5, pero tu descarga la 2.7 :)
Luego de instalar ruby exitosamente en tu PC llegó la hora de convertirte en un/una hacker:
Anda y arranca una línea de comando (esto abrirá una consola), me refiero escribir cmd
en la siguiente ventana:
En la pantalla negra que acabas de abrir escribe lo siguiente: gem install bootic_cli
.
Esta acción instalará una cantidad de archivos a tu computador, espera a que finalice.
Cuando te diga que terminó de instalar las gemas digita lo siguiente: bootic setup
.
¿Recuerdas el Client Id y el Client secret?... es momento de usarlos:
Copia y pega tal cual cada registro.
Finalmente te solicitará dos cosas más:
Si todo salió bien verás un mensaje como el siguiente:
Alrighty! Getting access token for TU_CORREO... Great success! Your're now logged in as TU_CORREO (admin) For a list of available commands, run `bootic help`
Felicitaciones... has penetrado la matrix
En este punto estás listo/ta para editar tu tienda Bootic, vamos a ello:
bootic theme clone
bootic theme push
¡Por supuesto!—el CLI dispone de un módulo de observación el cual al detectar un cambio en tu ambiente de trabajo será subido inmediatamente a tu tienda:
Esto se activa desde la consola (sí, la misma pantalla negra). Anda a la raiz de tu proyecto y digita
lo siguiente: bootic theme watch
, ojo, no cierres esta ventana.
Ahora anda a tu editor, cambia algo y guarda... mágicamente tu tienda será actualizada.
Te dejo una captura de pantalla; donde puedes ver VS-Code, corriento watch en una terminal y a la derecha la tienda con un texto sobre la foto que dice «Editado con Bootic CLI»
Si eres usuario Mac la primera parte de este guía es exactamente igual, es decir, como primer paso debes crear una Aplicación y luego obtener el Client Id y el Client secret. Si ya los tienes continúa leyendo, de lo contrario por favor sigue los pasos anteriormete descritos.
¿Ya los tienes?.. perfecto. Ahora deja darte algo de contexto para lo que tendrás que hacer a continuación:
Para la instalación de ruby es preciso que antes instales un manejador de paquetes. Un manejador de paquetes es un pequeño programa que te ayuda a instalar y desintalar programas en tu computador. El manejador de paquetes que necesitas instalar se llama Homebrew.
Importante: Durante la instalación de Homebrew el asistente te pedirá instalar Xcode, y particularmente Command Line tools (incluído en Xcode). Homebrew no necesita de Xcode, pero si lo necesitarás para instalar futuras librerías, así que dile que «Sí» cuando te lo pregunten.
Sin más preámbulo instalemos Homebrew: abre la aplicación Terminal y luego pega el siguiente código:
Es extenso, asegúrate de copiarlo todo:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
El proceso de instalación tardará porque debe descargar Xcode además de Homebrew, paciencia. Una vez finalizado
Cuando veas:
... ==> Installation successful! ...
Quiere decir que todo está bien! — para asegurarte puede digitar lo siguiente en Terminal:
brew -v
Que debería mostrarte la versión instalada.
Si no te funciona el comando anterior o ves una advertencia del tipo /opt/homebrew/bin is not in your PATH
quizá tengas que hacer un ajuste adicional: En la misma terminal digita lo siguiente:
echo 'eval $(/opt/homebrew/bin/brew shellenv)' >> /Users/$USERNAME/.zprofile eval $(/opt/homebrew/bin/brew shellenv)
Para instalar ruby haremos uso de una herramienta que nos da la posiblidad de instalar la versión que queramos de ruby, esto sin afectar la instalación nativa que pueda tener en tu PC. Quién nos ayudará en esto será rbenv.
Por lo tanto debemos instalar rbenv… antes de instalar ruby. ¡Vamos!
brew install rbenv ruby-build
Paciencia de nuevo porque seguramente tardará un poco, cuando finalice debes digitar lo siguiente:
echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.zshrc
Y luego, esto otro:
source ~/.zshrc
Digital lo siguiente en nuestra terminarl:
rbenv install 2.7.1
Cuando finalice la instalación pon lo siguiente:
rbenv global 2.7.1
Al anterior comando nos asegura que sea la versión 2.7.1 la que tu sistema tome por defecto.
Ya tenemos todos los ingredientes, ahora solo nos falta instalar la gema y configurarla.
El paso a paso es ídentico que la versión Windows, acá la versión resumida:
gem install bootic_cli
bootic setup
Anda ahora a cualquier directorio dentro de tu PC, supongamos Proyectos, y clona tu tienda:
mkdir -p $HOME/Proyectos/tienda_bootic
cd $HOME/Proyectos/tienda_bootic
bootic clone clone
bootic theme push
Por supuesto watch
funcion exactamente igual que en la versión Windows:
bootic theme watch
Cualquier pregunta sobre esta guía la puedes hacer a [email protected]