Trabajando con GitHub desde PyCharm

10.1 Clonación de un repositorio

¿Recuerdas que te hablé de los 3 lugares donde se almacenan archivos? Te lo recuerdo: está el repositorio remoto, el repositorio local y el directorio de trabajo.

Bien, ahora necesitas clonar tu repositorio remoto (el que creaste en GitHub) a tu repositorio local (el que está en tu ordenador).

Así que abre PyCharm y comencemos...

Paso 1. Si aún no has creado proyectos, selecciona el botón:

Si ya has creado, entonces:

Paso 2. Indica el url de tu repositorio remoto que quieres clonar en tu ordenador.

Este método es útil si clonas el repositorio de alguien más.

Si clonas el tuyo, es más fácil simplemente iniciar sesión en GitHub a través de PyCharm.

Paso 3. No confíes en nadie. Ni siquiera en ti mismo.

PyCharm advierte que no debes ejecutar código de repositorios desconocidos. Como es tu propio repositorio, marca la casilla "confiar".

Paso 4. Si tienes Windows, el antivirus estándar advertirá sobre archivos que le son desconocidos. A los antivirus no les gustan los programas que no conocen.

¡PERO! Vamos a crear precisamente esos programas, así que dile a tu IDE que indique al antivirus que no bloquee tus futuros programas. Haz clic en el botón «Automatically», luego — «YES».

10.2 Primer commit

Si clonaste un repositorio recién creado, sólo contendrá un archivo — README.md

Paso 1. Abre el archivo README.md.

¡Importante! La extensión md significa Markdown, un formato primitivo para estilizar archivos de texto. Puedes ver cómo funciona haciendo clic en el botón en la esquina superior derecha.

Cambia este archivo como quieras: puedes escribir cualquier mensaje de bienvenida o descripción del repositorio...

Paso 2. Después de realizar cambios en el archivo, PyCharm lo muestra con un color azul en el árbol de archivos a la izquierda. Los archivos modificados se marcan en azul si los cambios en tu directorio de trabajo no se han añadido a tu repositorio local.

Paso 3. Commit.

Después de hacer todos los cambios planificados en el archivo o archivos (y comprobar que son correctos), necesitas subirlos a tu repositorio local de git. Por ahora, sólo están en tu carpeta de trabajo.

Para eso necesitas hacer clic en el botón Commit y marcar todos los archivos cuyos cambios quieras subir al repositorio local:

Paso 4. En la parte inferior izquierda añade un comentario describiendo tus cambios.

Paso 5. Y haz clic en el botón «Commit».

Paso 6. Comprobación.

Cambia a tu proyecto y comprueba el color de los archivos: si los archivos dejaron de estar en azul, significa que todos los cambios de tu directorio de trabajo se han añadido correctamente a tu repositorio local.

10.3 Trabajando con archivos

Paso 1. Vamos a crear algunos archivos en PyCharm.

Estamos escribiendo código en Python — que sean archivos:

1. main.py
2. init.py

Paso 2. Agregamos el archivo al repositorio local.

Tan pronto como PyCharm vio que creaste un archivo, inmediatamente sugirió añadirlo a tu repositorio local. PyCharm sólo rastrea cambios en los archivos de tu directorio de trabajo que ya están en tu repositorio local. Sólo estos se marcarán en azul.

Si un archivo está en tu directorio de trabajo, pero no en el repositorio local, se marca en rojo, como en la imagen de abajo:

En principio, siempre puedes hacer clic en Add, pero esta vez hagamos clic en «Cancel» y luego añadamos el archivo manualmente. Para que recuerdes cómo hacerlo.

Paso 3. Escribamos tu código favorito en el archivo.

Yo, por ejemplo, escribí: print("first commit")

Paso 4. Ahora vamos a añadir nuestro archivo main.py al repositorio local.

Simplemente haz clic en cualquier parte del archivo con el botón derecho del ratón y selecciona Git -> Add File

Si todo salió bien, el archivo añadido se iluminará en verde.

Paso 5. Luego commiteamos el archivo siguiendo el esquema de siempre:

10.4 Primer push

Ahora necesitamos subir nuestros cambios en el repositorio local al repositorio remoto en GitHub. Cuando varios programadores trabajan en un proyecto, sincronizan sus cambios de código de esta manera.

Paso 1. Haz clic en el botón Push.

En realidad, esto es muy fácil de hacer: solo necesitas usar el botón Push en el menú superior del IDE:

Paso 2. Confirma los commits realizados.

En este paso, puedes revisar todos los cambios realizados y asegurarte de que no rompiste accidentalmente algo importante. O que no olvidaste agregar un archivo del cual dependen otros archivos.

Paso 3. Verificación.

Si todo salió bien, verás mensajes como estos:

Paso 4. Ahora abre tu repositorio de GitHub y verifica:

¡Magia de la tecnología!

10.5 Uso de archivos .gitignore

Si añadiste archivos de soporte a tu proyecto y no quieres que accidentalmente llamen la atención en GitHub, puedes añadirlos a las excepciones. Para eso está el archivo llamado «.gitignore». Es muy fácil y cómodo.