{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Tu primer repositorio\n",
    "\n",
    "Cuatro comandos, y qué hace cada uno de verdad\n",
    "\n",
    "Cuaderno de práctica del capítulo 3 de **Git desde cero**, de Miss Yera.\n",
    "\n",
    "Corre de arriba abajo. Si lo abres en Google Colab no necesitas instalar nada.\n",
    "\n",
    "Capítulo completo: https://missyera.com/guias/git-desde-cero/tu-primer-repositorio/\n",
    "\n",
    "Los ejercicios están al final y traen una celda vacía debajo de cada uno. Las\n",
    "respuestas viven en el cuaderno de soluciones, y merece la pena pelearse un\n",
    "rato antes de abrirlo 💛"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Antes de empezar\n",
    "\n",
    "Este capítulo son comandos de terminal, no Python. La celda de abajo baja el\n",
    "ayudante que los ejecuta y que **recuerda en qué carpeta quedaste**, que es lo\n",
    "que hace falta para que un `cd` de una celda siga valiendo en la siguiente.\n",
    "\n",
    "A partir de ahí, cada celda de comandos empieza por `%%consola`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "import urllib.request\n",
    "\n",
    "# El ayudante de los cuadernos. Trae la corrección de los ejercicios y, en los\n",
    "# capítulos de consola, la celda mágica que ejecuta los comandos. Se baja en\n",
    "# vez de venir pegado aquí para que siempre sea el último.\n",
    "urllib.request.urlretrieve(\n",
    "    \"https://missyera.com/static/cuadernos/revisa.py\", \"revisa.py\")\n",
    "import revisa\n",
    "revisa.carga({\n",
    "    1: \"Pz8gY2xpZW50ZXMuY3N2\",\n",
    "    2: \"QSAgY2xpZW50ZXMuY3N2\",\n",
    "    3: \"W21haW4gY2FkMGZhYV0gU2UgYWdyZWdhbiBsYXMgYm9kZWdhcyBkZSBMaW1hIHkgQXJlcXVpcGEKIDEgZmlsZSBjaGFuZ2VkLCAzIGluc2VydGlvbnMoKykKIGNyZWF0ZSBtb2RlIDEwMDY0NCBjbGllbnRlcy5jc3Y=\",\n",
    "    4: \"W21haW4gNTRkNmI1ZF0gRW50cmEgQ3VzY28gZW4gdmVudGFzIHkgZW4gY2xpZW50ZXMKIDIgZmlsZXMgY2hhbmdlZCwgMiBpbnNlcnRpb25zKCsp\",\n",
    "    5: \"NTRkNmI1ZCBFbnRyYSBDdXNjbyBlbiB2ZW50YXMgeSBlbiBjbGllbnRlcwpjYWQwZmFhIFNlIGFncmVnYW4gbGFzIGJvZGVnYXMgZGUgTGltYSB5IEFyZXF1aXBhCjJlMzE1M2UgUHJpbWVyYXMgdmVudGFzIGRlIExpbWEgcG9yIGJvZGVnYQoz\",\n",
    "    6: \"NTRkNmI1ZCBFbnRyYSBDdXNjbyBlbiB2ZW50YXMgeSBlbiBjbGllbnRlcwogY2xpZW50ZXMuY3N2IHwgMSArCiB2ZW50YXMuY3N2ICAgfCAxICsKIDIgZmlsZXMgY2hhbmdlZCwgMiBpbnNlcnRpb25zKCsp\",\n",
    "    7: \"T24gYnJhbmNoIG1haW4Kbm90aGluZyB0byBjb21taXQsIHdvcmtpbmcgdHJlZSBjbGVhbg==\",\n",
    "}, lenguaje=\"bash\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Los cuatro comandos"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Este es el capítulo más corto del libro y el que más vas a repetir. Cuatro\n",
    "comandos, en este orden, y ya tienes un repositorio funcionando.\n",
    "\n",
    "Primero la carpeta, y entrar en ella. Es en serio lo de entrar: si te saltas\n",
    "el `cd`, Git convierte en repositorio la carpeta donde estés\n",
    "parada, y ahí empiezan los problemas de la trampa del capítulo\n",
    "1."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%consola\n",
    "mkdir ventas-miss-yera\n",
    "cd ventas-miss-yera\n",
    "git init"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Mira dónde dice que lo creó: dentro de la carpeta, en un sitio llamado\n",
    "`.git`. Ese punto delante significa oculto, y por eso no lo ves en el\n",
    "explorador de archivos."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%consola\n",
    "ls -a"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Esa carpeta `.git` **es** el repositorio. Toda la\n",
    "historia vive ahí dentro. Si la borras, la carpeta vuelve a ser una carpeta\n",
    "normal y pierdes la memoria pero no los archivos."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## El error de empezar al revés"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Antes de crear nada, intento señalar un archivo que todavía no existe. Este\n",
    "error lo vas a ver mucho al principio:"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Esto revienta a propósito**, y de eso va. La celda te muestra la queja igual que te la mostraría tu terminal."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%consola\n",
    "git add ventas.csv"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Y la queja que tiene que salir es esta:\n",
    "\n",
    "```\n",
    "fatal: pathspec 'ventas.csv' did not match any files\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "*Did not match any files*: no encontró ningún archivo con ese nombre.\n",
    "Casi siempre es un nombre mal escrito o que estás en otra carpeta. Se resuelve\n",
    "con un `ls`, mirando qué hay de verdad ahí dentro."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## El estado, que es tu tablero"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Creo el archivo de ventas y pregunto cómo está la cosa:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%consola\n",
    "printf 'ciudad,monto,canal\\nLima,1200,bodega\\n' > ventas.csv\n",
    "git status"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Léelo despacio porque este mensaje te va a acompañar toda la vida:\n",
    "\n",
    "*On branch main*, estás en la rama principal. *No commits yet*,\n",
    "todavía no has guardado ningún momento. *Untracked files*, hay archivos\n",
    "que Git ve pero no está siguiendo.\n",
    "\n",
    "Y de yapa te dice qué hacer: *use git add*. Git es de los pocos\n",
    "programas que te propone el siguiente comando en el propio mensaje. Léelos, no\n",
    "los saltes."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Señalar y guardar, que son dos cosas"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%consola\n",
    "git add ventas.csv\n",
    "git status"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Cambió una palabra y cambió todo. Ahora dice *Changes to be committed*,\n",
    "cambios listos para guardarse, y el archivo aparece como *new file*.\n",
    "\n",
    "Ese sitio intermedio donde está ahora el archivo se llama\n",
    "**el área de preparación**, y es lo que hace distinto a Git. En\n",
    "otros sistemas guardas todo lo que cambió, sí o sí. Aquí eliges: tocaste ocho\n",
    "archivos en la mañana pero solo tres son de la misma tarea, señalas esos tres y\n",
    "haces un commit limpio.\n",
    "\n",
    "Ahora sí, guardo el momento:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%consola\n",
    "git commit -m \"Primeras ventas de Lima por bodega\""
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Y el estado vuelve a estar tranquilo:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%consola\n",
    "git status"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "*Nothing to commit, working tree clean*. Todo lo que hay en la carpeta\n",
    "está guardado en la historia. Cuando algo te asuste, este es el mensaje que\n",
    "quieres ver 🧘"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Tu hash no va a ser el mío"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Mira el commit completo:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%consola\n",
    "git log"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Esos cuarenta caracteres son el nombre del momento. Salen de mezclar lo que\n",
    "guardaste, quién lo firmó y a qué hora, así que **si tú haces los mismos\n",
    "pasos te va a salir otro número**, porque tu nombre y tu reloj son\n",
    "otros.\n",
    "\n",
    "Lo digo temprano porque es la duda que más veo: \"me salió distinto al del\n",
    "libro, ¿hice algo mal?\". No. Lo que tiene que coincidir es la forma, no el\n",
    "número.\n",
    "\n",
    "Y como cuarenta caracteres no se leen, casi siempre vas a usar la versión\n",
    "corta, que toma los siete primeros:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%consola\n",
    "git log --oneline"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Con siete basta para que no haya dos iguales en un proyecto normal, y ese es\n",
    "el que copias cuando alguien te pregunta en qué commit está algo."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### La trampa\n",
    "\n",
    "Terminas de configurar la conexión a la base de datos de la tienda, guardas las claves en un archivo `.env` al lado de tu código y haces tu primer commit del día como siempre.\n",
    "\n",
    "```\n",
    "$ git add .\n",
    "$ git commit -m \"Conexion a la base de ventas\"\n",
    "$ git push\n",
    "\n",
    "[main 8f2a91c] Conexion a la base de ventas\n",
    " 4 files changed, 62 insertions(+)\n",
    "```\n",
    "\n",
    "**¿Qué está mal?** La respuesta está en el cuaderno de soluciones. Míralo tú primero."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Comprueba que se entendió"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Comprueba que lo tienes\n",
    "\n",
    "Cambiaste cinco archivos pero solo tres son de la misma tarea. ¿Qué haces?\n",
    "\n",
    "a) `git add .` y un commit con todo\n",
    "\n",
    "b) `git add` con los tres archivos y un commit, y después los otros dos aparte\n",
    "\n",
    "c) Guardar los cinco y arreglarlo después\n",
    "\n",
    "d) Borrar los dos que no van y volver a escribirlos luego"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Ejercicios"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 1. Un segundo archivo, con los clientes\n",
    "\n",
    "Crea un CSV con dos bodegas y míralo en el estado, sin\n",
    "guardarlo todavía."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%revisa 1\n",
    "# tu turno"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 2. Señálalo y mira cómo cambia la marca\n",
    "\n",
    "Haz el `add` y vuelve a pedir el estado corto."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%revisa 2\n",
    "# tu turno"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 3. Guárdalo con un mensaje que se entienda\n",
    "\n",
    "Haz el commit. Regla del libro: el mensaje dice qué pasó,\n",
    "nunca dice \"cambios\" ni \"update\"."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%revisa 3\n",
    "# tu turno"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 4. Dos archivos, un solo commit, a propósito\n",
    "\n",
    "Toca los dos archivos y guárdalos juntos, porque esta vez sí\n",
    "son la misma tarea: agregar Cusco como ciudad nueva."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%revisa 4\n",
    "# tu turno"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 5. Lee la historia en dos formatos\n",
    "\n",
    "Pide el log corto y cuenta cuántos commits llevas."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%revisa 5\n",
    "# tu turno"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 6. Qué entró en el último commit\n",
    "\n",
    "Pide el detalle del último momento, solo los nombres de los\n",
    "archivos que tocó."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%revisa 6\n",
    "# tu turno"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 7. El commit vacío\n",
    "\n",
    "Intenta guardar un momento cuando no hay nada que guardar.\n",
    "Tiene que fallar, y el mensaje te va a resultar familiar."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%revisa 7\n",
    "# tu turno"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Lo que te llevas"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "**Señalar y guardar son dos pasos porque tú decides qué historia\n",
    "cuenta cada commit.**"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "---\n",
    "\n",
    "Ese era el capítulo 3 de **Git desde cero**. El texto completo, con las salidas de cada bloque, está en https://missyera.com/guias/git-desde-cero/tu-primer-repositorio/\n",
    "\n",
    "Que tengas lindo día! 🌸"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "name": "python",
   "version": "3.11"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}