Cómo instalar Bootic CLI

Windows | Mac

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.

¿Intimidado/da?

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!

Crea «aplicación»

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:

  1. Anda a la sección aplicaciones de tu perfil - te autentificas con el mismo usuario de tu tienda Bootic.
  2. Crea una aplicación.
  3. El punto anterior te generará un Client Id y un Client secret, guárdalos.

Perfecto, ahora la instalación.

Ruby

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.

Window

Ruby para Windows

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 :)

Descarga de gema

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.

Configurar cliente

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:

  1. Tu correo, el de tu tienda Bootic
  2. Tu contraseña, el de tu tienda Bootic

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

La parte entretenida: Descargar y editar tu tienda

En este punto estás listo/ta para editar tu tienda Bootic, vamos a ello:

  1. Crea una carpeta en alguna parte de tu computador.
  2. Usando la consola (la pantalla negra de arriba) anda a esta nueva carpeta que creaste.
  3. Digita lo siguiente: bootic theme clone
  4. Te preguntará si quieres trabajar en un ambiente prueba, dile que «sí»
  1. Luego verás como todos los archivos que componen tu tienda serán descargados a tu PC.
  2. Ahora ve a tu editor favorito y abre esta carpeta de trabajo y realiza algún cambio.
  3. Vuelve a la consola (sí, la misma pantalla negre de antes... ¿no la cerraste verdad?)
  4. Estando en la raiz de tu proyecto digita lo siguiente: bootic theme push
  5. Lo anterior subirá a tu tienda el cambio que hiciste

Pero espera un segundo... ¿no hay algo más... automático?

¡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»

Mac

Ruby para Mac

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 tengo

¿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.

Instalar Homebrew

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.

¿Problemas?

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)

OK, Ruby... pero antes

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

Ahora sí: ¡RUBY!

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.

Finalmente Bootic CLI

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:

  1. Instalamos la gema: gem install bootic_cli
  2. La configuramos: bootic setup
  3. Ingresamos el Client ID
  4. Ingresamos el Client secret
  5. Ingresamos el correo
  6. Ingresamos la contraseña asociada a tu correo

Clonar la tienda a nuestro PC

Anda ahora a cualquier directorio dentro de tu PC, supongamos Proyectos, y clona tu tienda:

  1. Creamos el directorio: mkdir -p $HOME/Proyectos/tienda_bootic
  2. Vamos al directorio creado: cd $HOME/Proyectos/tienda_bootic
  3. Clonamos la tienda: bootic clone clone
  4. Abrimos el directorio con nuestro editor favorito y editamos
  5. Luego desde la misma terminal subimos el cambio: 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]