{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Cambiar de tarea a mitad de camino\n",
    "\n",
    "Guardar lo que llevas sin hacer un commit del que te arrepientas\n",
    "\n",
    "Cuaderno de práctica del capítulo 8 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/guardar-a-medias/\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: \"U2F2ZWQgd29ya2luZyBkaXJlY3RvcnkgYW5kIGluZGV4IHN0YXRlIE9uIG1haW46IEN1c2NvIHBlbmRpZW50ZSBkZSBjb25maXJtYXIKPz8gcmVwb3J0ZS50eHQKY2l1ZGFkLG1vbnRvCkxpbWEsMTIwMA==\",\n",
    "    2: \"c3Rhc2hAezB9OiBPbiBtYWluOiBDdXNjbyBwZW5kaWVudGUgZGUgY29uZmlybWFy\",\n",
    "    3: \"ZGlmZiAtLWdpdCBhL3ZlbnRhcy5jc3YgYi92ZW50YXMuY3N2CmluZGV4IGI1MjU2YzEuLjdhNDA1NTEgMTAwNjQ0Ci0tLSBhL3ZlbnRhcy5jc3YKKysrIGIvdmVudGFzLmNzdgpAQCAtMSwyICsxLDQgQEAKIGNpdWRhZCxtb250bwogTGltYSwxMjAwCitBcmVxdWlwYSw4OTAKK0N1c2NvLDc2MA==\",\n",
    "    4: \"T24gYnJhbmNoIG1haW4KQ2hhbmdlcyBub3Qgc3RhZ2VkIGZvciBjb21taXQ6CiAgKHVzZSAiZ2l0IGFkZCA8ZmlsZT4uLi4iIHRvIHVwZGF0ZSB3aGF0IHdpbGwgYmUgY29tbWl0dGVkKQogICh1c2UgImdpdCByZXN0b3JlIDxmaWxlPi4uLiIgdG8gZGlzY2FyZCBjaGFuZ2VzIGluIHdvcmtpbmcgZGlyZWN0b3J5KQoJbW9kaWZpZWQ6ICAgdmVudGFzLmNzdgoKVW50cmFja2VkIGZpbGVzOgogICh1c2UgImdpdCBhZGQgPGZpbGU+Li4uIiB0byBpbmNsdWRlIGluIHdoYXQgd2lsbCBiZSBjb21taXR0ZWQpCglyZXBvcnRlLnR4dAoKbm8gY2hhbmdlcyBhZGRlZCB0byBjb21taXQgKHVzZSAiZ2l0IGFkZCIgYW5kL29yICJnaXQgY29tbWl0IC1hIikKc3Rhc2hAezB9OiBPbiBtYWluOiBDdXNjbyBwZW5kaWVudGUgZGUgY29uZmlybWFy\",\n",
    "    5: \"RHJvcHBlZCByZWZzL3N0YXNoQHswfSAoMGU3NTAzZjM0NWNjMmViNzIxNWIxZDhlMmU2NjJkY2ZiYjA5MjljYSk=\",\n",
    "    6: \"U2F2ZWQgd29ya2luZyBkaXJlY3RvcnkgYW5kIGluZGV4IHN0YXRlIE9uIG1haW46IENhdGFsb2dvIGRlIGNsaWVudGVzIHBvciByZXZpc2FyCm1ldGFzLmNzdgp2ZW50YXMuY3N2\",\n",
    "    7: \"T24gYnJhbmNoIG1haW4KQ2hhbmdlcyBub3Qgc3RhZ2VkIGZvciBjb21taXQ6CiAgKHVzZSAiZ2l0IGFkZCA8ZmlsZT4uLi4iIHRvIHVwZGF0ZSB3aGF0IHdpbGwgYmUgY29tbWl0dGVkKQogICh1c2UgImdpdCByZXN0b3JlIDxmaWxlPi4uLiIgdG8gZGlzY2FyZCBjaGFuZ2VzIGluIHdvcmtpbmcgZGlyZWN0b3J5KQoJbW9kaWZpZWQ6ICAgdmVudGFzLmNzdgoKVW50cmFja2VkIGZpbGVzOgogICh1c2UgImdpdCBhZGQgPGZpbGU+Li4uIiB0byBpbmNsdWRlIGluIHdoYXQgd2lsbCBiZSBjb21taXR0ZWQpCgljbGllbnRlcy5jc3YKCXJlcG9ydGUudHh0CgpubyBjaGFuZ2VzIGFkZGVkIHRvIGNvbW1pdCAodXNlICJnaXQgYWRkIiBhbmQvb3IgImdpdCBjb21taXQgLWEiKQpEcm9wcGVkIHJlZnMvc3Rhc2hAezB9IChkNmJkYWJkYzZlOTk1OTUyNTEzZTRlYjZmZDM5NDA4MjNiMjQ4ZmRmKQpObyBzdGFzaCBlbnRyaWVzIGZvdW5kLg==\",\n",
    "}, lenguaje=\"bash\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## El problema"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Estás a mitad del reporte de ventas por canal. No está terminado, no vale la\n",
    "pena guardarlo. Y entra un WhatsApp: hay que arreglar algo urgente ahora\n",
    "mismo.\n",
    "\n",
    "Tienes tres opciones y dos son malas: hacer un commit de algo a medias y\n",
    "ensuciar la historia, o perder lo que llevas. La tercera es el cajón."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%consola\n",
    "mkdir tienda\n",
    "cd tienda\n",
    "git init -q\n",
    "printf 'ciudad,monto\\nLima,1200\\n' > ventas.csv\n",
    "git add ventas.csv\n",
    "git commit -q -m \"Primeras ventas de Lima\"\n",
    "printf 'Arequipa,890\\n' >> ventas.csv\n",
    "printf 'reporte a medias\\n' > reporte.txt\n",
    "git status --short"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Al cajón"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%consola\n",
    "git stash push -u -m \"Reporte por canal a medias\"\n",
    "git status --short\n",
    "ls"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Carpeta limpia y `reporte.txt` desapareció. No se perdió: está\n",
    "guardado aparte, y ahora puedes hacer el arreglo urgente con el proyecto tal\n",
    "como estaba 🧹\n",
    "\n",
    "Ese `-u` importa. Sin él, los archivos que Git todavía no conoce\n",
    "(los del capítulo 4, los *untracked*) se quedan\n",
    "en la carpeta y el cajón se los salta."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Ver qué hay en el cajón"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%consola\n",
    "git stash list"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Se pueden guardar varios y por eso llevan número. El `{0}` es el\n",
    "más reciente. Y el mensaje que pusiste con `-m` es lo que te salva\n",
    "cuando hay tres y no te acuerdas de cuál era cuál."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## El arreglo urgente"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%consola\n",
    "printf 'canal,meta\\nBodegas,8000\\n' > metas.csv\n",
    "git add metas.csv\n",
    "git commit -q -m \"Urgente, entran las metas por canal\"\n",
    "git log --oneline"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Y sacar lo tuyo del cajón"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%consola\n",
    "git stash pop\n",
    "git status --short"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Todo de vuelta, encima del arreglo urgente. `pop` saca y borra del\n",
    "cajón; `apply` saca y lo deja ahí por si acaso."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## El error de sacar de un cajón vacío"
   ]
  },
  {
   "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 stash pop"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Y la queja que tiene que salir es esta:\n",
    "\n",
    "```\n",
    "No stash entries found.\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Corto y claro. Si te sale esto y sabes que guardaste algo, casi siempre es\n",
    "que estás en otro repositorio: **el cajón es de cada proyecto**, no\n",
    "de la máquina."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### La trampa\n",
    "\n",
    "Guardas lo que llevas en el cajón, haces el arreglo urgente y te vas a almorzar. Al volver sigues con otra cosa, y a la semana te acuerdas del reporte.\n",
    "\n",
    "```\n",
    "$ git stash list\n",
    "\n",
    "stash@{0}: On main: Reporte por canal\n",
    "stash@{1}: On main: Prueba del IGV\n",
    "stash@{2}: On main: WIP on main: 8a2b19c\n",
    "stash@{3}: On main: WIP on main: 3c1f80a\n",
    "stash@{4}: On main: WIP on main: 5d9c2f1\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",
    "Llevas dos días de trabajo a medias y te vas de vacaciones. ¿Dónde lo dejas?\n",
    "\n",
    "a) En el stash, que para eso está\n",
    "\n",
    "b) En una rama, con un commit aunque esté a medias\n",
    "\n",
    "c) Sin guardar, total nadie va a tocar la laptop\n",
    "\n",
    "d) En el stash pero con un mensaje bien claro"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Ejercicios"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 1. Guarda un cambio y limpia\n",
    "\n",
    "Toca el CSV, mándalo al cajón y comprueba que la carpeta\n",
    "quedó limpia."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%revisa 1\n",
    "# tu turno"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 2. Mira el cajón\n",
    "\n",
    "Lista lo que hay guardado."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%revisa 2\n",
    "# tu turno"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 3. Espía sin sacar\n",
    "\n",
    "Mira qué hay dentro del cajón sin recuperarlo todavía."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%revisa 3\n",
    "# tu turno"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 4. Sácalo dejando copia\n",
    "\n",
    "Usa `apply` en vez de `pop` y\n",
    "comprueba que el cajón sigue lleno."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%revisa 4\n",
    "# tu turno"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 5. Vacía el cajón a mano\n",
    "\n",
    "Tira el cajón que ya recuperaste."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%revisa 5\n",
    "# tu turno"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 6. Guarda también lo que Git no conoce\n",
    "\n",
    "Crea un archivo nuevo de clientes y guárdalo con\n",
    "`-u`, que es el que se lleva los desconocidos."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%%revisa 6\n",
    "# tu turno"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 7. Saca de un cajón que ya vaciaste\n",
    "\n",
    "Recupera lo guardado y después intenta sacar otra vez."
   ]
  },
  {
   "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": [
    "**El cajón es para minutos y solo existe en tu máquina. Para algo que\n",
    "va a dormir ahí, mejor un commit.**"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Preguntas frecuentes"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "¿Qué hace git stash?Guarda los cambios que tienes a medias en un cajón aparte y te deja la carpeta limpia. Sirve cuando tienes que cambiar de rama de golpe y no quieres hacer un commit a medio hacer.\n",
    "\n",
    "¿Cómo recupero lo que guardé con stash?Con git stash pop, que lo devuelve y lo saca del cajón. Con git stash apply lo devuelve y lo deja guardado también.\n",
    "\n",
    "¿Cuántas cosas puedo tener en el stash?Las que quieras, se apilan. git stash list te las enseña, y ahí empieza el problema: un stash de hace tres semanas ya nadie recuerda qué traía."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "---\n",
    "\n",
    "Ese era el capítulo 8 de **Git desde cero**. El texto completo, con las salidas de cada bloque, está en https://missyera.com/guias/git-desde-cero/guardar-a-medias/\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
}