Bajar un proyecto y hacerlo funcionar

Este es el capítulo que pidió aquella persona en LinkedIn: "he visto varios desarrollos compartidos allí pero todavía me cuesta entender cómo instalarlos".

Y tiene toda la razón en que cuesta, porque en GitHub hay un botón verde grande que dice Code y lo que ofrece primero es justo lo que menos conviene 🟢

El botón verde por dentro

Al pulsarlo salen cuatro opciones. Traducidas:

La regla es fácil: si vas a usar el proyecto, clona. El ZIP es para curiosear un rato y borrar.

Clonar de verdad

Para verlo funcionando sin depender de internet, primero fabricamos un proyecto y lo dejamos en un servidor de práctica, como en el capítulo 12. Ese va a hacer de "proyecto que encontraste".

mkdir analisis-ventas
cd analisis-ventas
git init -q
printf 'ciudad,monto\nLima,1200\nArequipa,890\nCusco,760\n' > ventas.csv
printf '# Analisis de ventas\n\nCalcula el total por ciudad.\n' > README.md
printf 'pandas\n' > requirements.txt
printf 'import pandas as pd\nprint(pd.read_csv("ventas.csv")["monto"].sum())\n' > total.py
git add .
git commit -q -m "Primera version del analisis de ventas"
cd ..
git clone -q --bare analisis-ventas servidor.git
echo "proyecto publicado en servidor.git"

proyecto publicado en servidor.git

Ahora hazte la idea de que servidor.git es una dirección de GitHub que te pasó alguien. Bajarlo es una línea:

git clone servidor.git mi-copia
cd mi-copia
ls

Cloning into 'mi-copia'...
done.
README.md
requirements.txt
total.py
ventas.csv

Ahí está todo. Y fíjate en el detalle que lo cambia todo: te trajiste la historia entera, no la foto de hoy.

git log --oneline
git remote -v

94953c4 Primera version del analisis de ventas
origin	/home/miss-yera/servidor.git (fetch)
origin	/home/miss-yera/servidor.git (push)

El remoto quedó apuntado solo. clone hace tres cosas de un tirón: crea la carpeta, copia el repositorio y configura origin 📦

Dónde cae la carpeta

git clone crea la carpeta dentro de donde estés parada. Si estabas en tu carpeta personal, ahí te la deja. Es el motivo número uno de "clone el proyecto y no lo encuentro".

pwd
cd ..
mkdir -p proyectos
cd proyectos
git clone -q ../servidor.git ventas
ls
pwd

/home/miss-yera/mi-copia
ventas
/home/miss-yera/proyectos

Ese nombre del final es opcional: sin él, la carpeta se llama como el proyecto. Con él, como tú quieras 📁

Los dos pasos que Git no hace

Clonar te da los archivos. No te da el programa funcionando, y aquí es donde la gente se queda mirando la pantalla.

Paso uno: leer el README. Siempre. Es el archivo que explica qué es esto y cómo se pone en marcha.

cd ventas
cat README.md
cat requirements.txt

# Analisis de ventas

Calcula el total por ciudad.
pandas

Paso dos: instalar lo que pide. Casi ningún proyecto se ejecuta tal cual: necesita librerías. El archivo que las lista se llama requirements.txt en Python, package.json en JavaScript, y siempre está en la raíz.

En Python son dos líneas, y la primera es la que casi todo el mundo se salta:

python3 -m venv .venv          # una caja aparte para este proyecto
source .venv/bin/activate      # entrar a la caja
pip install -r requirements.txt

Ese entorno virtual evita que las librerías de un proyecto se peleen con las de otro. Si nunca lo has hecho, está explicado con calma en Python desde cero 🐍

Actualizar cuando saquen algo nuevo

Aquí se ve por qué el ZIP no servía. Alguien mejora el proyecto original:

cd ../../analisis-ventas
printf 'Trujillo,1450\n' >> ventas.csv
git add ventas.csv
git commit -q -m "Entran las ventas de Trujillo"
git push -q ../servidor.git main
echo "cambio publicado"

cambio publicado

Y tú, en tu copia, te lo traes con una palabra:

cd ../proyectos/ventas
git pull -q origin main
cat ventas.csv
git log --oneline

ciudad,monto
Lima,1200
Arequipa,890
Cusco,760
Trujillo,1450
2f95f84 Entran las ventas de Trujillo
94953c4 Primera version del analisis de ventas

Trujillo apareció y la historia creció. Con un ZIP habrías tenido que descargar otro, descomprimirlo y comparar carpetas a mano 🙃

$ cd ~/Escritorio/herramienta-main
$ ls -a
.  ..  README.md  requirements.txt  src

$ git pull
fatal: not a git repository (or any of the parent directories): .git

Comprueba que se entendió

Ejercicios

cd ~
mkdir catalogo-clientes
cd catalogo-clientes
git init -q
printf 'cliente,ciudad,canal\nBodega Inti,Cusco,Bodegas\n' > clientes.csv
printf '# Catalogo de clientes\n\nUn CSV por canal.\n' > README.md
git add .
git commit -q -m "Catalogo inicial de clientes"
cd ..
git clone -q --bare catalogo-clientes clientes-servidor.git
echo "publicado"

publicado

git clone clientes-servidor.git clientes
cd clientes
ls

Cloning into 'clientes'...
done.
README.md
clientes.csv

git log --oneline
git remote -v

fc01d00 Catalogo inicial de clientes
origin	/home/miss-yera/clientes-servidor.git (fetch)
origin	/home/miss-yera/clientes-servidor.git (push)

cat README.md

# Catalogo de clientes

Un CSV por canal.

cd ../catalogo-clientes
printf 'Mayorista Norte,Piura,Mayoristas\n' >> clientes.csv
git add clientes.csv
git commit -q -m "Entra el mayorista de Piura"
git push -q ../clientes-servidor.git main
cd ../clientes
git pull -q origin main
cat clientes.csv

cliente,ciudad,canal
Bodega Inti,Cusco,Bodegas
Mayorista Norte,Piura,Mayoristas

cd ..
git clone -q --depth 1 clientes-servidor.git clientes-ligero
cd clientes-ligero
git log --oneline

warning: --depth is ignored in local clones; use file:// instead.
68b5ac0 Entra el mayorista de Piura
fc01d00 Catalogo inicial de clientes

cd ..
mkdir ocupada
printf 'algo\n' > ocupada/notas.txt
git clone clientes-servidor.git ocupada

fatal: destination path 'ocupada' already exists and is not an empty directory.

Lo que te llevas

Clonar trae los archivos, la historia y el enlace al original. El ZIP solo trae los archivos de hoy.