Instrucciones para ejecutar este proyecto

1. Abrir Git Bash para Windows o una terminal para Linux/Unix.

2. Ir al directorio de trabajo para el proyecto de curso

cd ~/Documents/coder_projects/django-coderhouse-project

3. Abrir VS Code y una terminal allí

code .

En seguida en VSCode damos Ctrl+j o Terminal/New Terminal y en esta terminal seguimos ejecutando los comandos que siguen a continuación.

4. Traer los cambios del repositorio remoto GitHub y cambiar de rama

git pull
git checkout class_19_playground_I
rm my_blog\db.sqlite3

5. Activar entorno virtual

(Windows)

.\venv\Scripts\activate

(Linux)

source venv/bin/activate

6. Instalar las dependencias del proyecto

pip install -r requirements.txt

7. Navegamos hacia la carpeta del proyecto my_blog

cd my_blog

8. Se crean las migraciones que son una "plantilla" para crear la base de datos con la que trabajará nuestro proyecto de Django

python manage.py makemigrations

9. Se ejecuta la migración para crear la base de datos con la que trabajará nuestro proyecto de Django

python manage.py migrate

10. Se crea el super usuario para nuestro proyecto de Django, Solo si no se ha creado

python manage.py createsuperuser

Ingrese Username, Email address y Password

11. Se levanta el servidor de Django que expone el servicio por el localhost en el puerto 8000 por defecto http://127.0.0.1:8000/

python manage.py runserver

• Recordar que para que cargen de manera adecuada los templates deben actualizar su nombre de usuario en el path que está en el módulo settings.py ubicado en my_blog\my_blog\settings.py

Para Windows

        'DIRS': [
            "C:/Users/<nombre_usuario>/Documents/coder_projects/django-coderhouse-project/my_blog/templates/"
        ],

Para Linux

        'DIRS': [
            "/home/<nombre_usuario>/Documents/coder_projects/django-coderhouse-project/my_blog/templates/"
        ],

• Es hora de ir al navegador y en una pestaña nueva navegar hacia http://127.0.0.1:8000/hello-world/ o http://localhost:8000/hello-world/ para visualizar el Hola Mundo que hicimos durante la clase. Es recomendable ir hacia los demás endpoints (ver my_blog/urls.py) creados durante la clase para experimentar con ellos y afianzar los conocimientos vistos.

• Si queremos levantar el servidor de Django en otro puerto lo especificamos de la siguente manera. e.g. http://127.0.0.1:8001/

python manage.py runserver 8001

Comandos útiles para Django

Crear proyecto

django-admin startproject <nombre del proyecto>
cd <nombre del proyecto>

Crear una aplicación en un proyecto

python manage.py startapp <nombre del app>

Actualizar la base de datos del proyecto con cambios en nuestros modelos

Se realiza en dos pasos la creación de las migraciones, una por aplicación, y luego se realiza la creación de las tablas en la base de datos.

python manage.py makemigrations
python manage.py migrate

Comandos básicos para Git

Git clone

Git clone es un comando para descargarte el código fuente existente desde un repositorio remoto (como Github, por ejemplo). Descarga la última versión de tu proyecto en un repositorio y la guarda en tu ordenador

git clone <https://link-con-nombre-del-repositorio>

Git branch

• Creando una nueva rama:

git branch <nombre-de-la-rama>

• Visualización de ramas:

git branch
git branch --list

• Borrar una rama:

git branch -d <nombre-de-la-rama>

Git checkout

• Para cambiarte a una rama existente

git checkout <nombre-de-la-rama>

• Para crear y cambiarte a esa rama al mismo tiempo

git checkout -b <nombre-de-tu-rama>

Git status

El comando de git status nos da toda la información necesaria sobre la rama actual:

• Si la rama actual está actualizada
• Si hay algo para confirmar, enviar o recibir (pull).
• Si hay archivos en preparación (staged), sin preparación(unstaged) o que no están recibiendo seguimiento (untracked)
• Si hay archivos creados, modificados o eliminadosstatus

git status

Git add

• Añadir un único archivo:

git add <archivo>

• Añadir todo de una vez:

git add -A
git add .

Importante: El comando git add almacena en el stage los cambios de los archivos sin embargo aún no quedan registrados en el repositorio hasta que se utilice el comando de confirmación git commit para registrar un punto de control de los cambios.

Git commit

Git commit establece un punto de control al cual puedes volver más tarde si es necesario. Resulta muy aconsejable escribir un mensaje corto para explicar qué hemos desarrollado o modificado en el código fuente.

git commit -m "mensaje de confirmación"

Git push

Después de haber confirmado tus cambios, el siguiente paso que quieres dar es enviar tus cambios al servidor remoto. Git push envía tus commits al repositorio remoto.

git push <nombre-remoto> <nombre-de-tu-rama>
git push origin <nombre-de-tu-rama>

Importante: Git push solamente carga los cambios que han sido confirmados con un git commit.

Git pull

El comando git pull se utiliza para recibir actualizaciones del repositorio remoto.

git pull <nombre-remoto> <nombre-de-tu-rama>
git pull origin master

Git remote

Sirve para cambiar la dirección url del repositorio que tenemos por origin.

git remote set-url origin <url_de_tu_repositorio_en_GitHub>
git remote set-url origin https://github.com/coder-live-class/django-coderhouse-project.git