7_SEMANA_7_Entorno_Profesional_Git_GitHub_Streamlit

Guía Semanal 7: Mi Primer Entorno Profesional (De VSCode a GitHub)

Asignatura: Programación de Computadores / Fundamentos de Programación Temáticas: Entorno Local (VSCode), Ejecución de Streamlit y Sincronización con GitHub

1. El Propósito de esta Semana

Hasta ahora, Google Colab ha sido nuestro “laboratorio prestado” en la nube. Esta semana, tomarán posesión de su propio espacio de trabajo. El objetivo es configurar su computador para escribir código profesional, ver su aplicación web funcionando localmente y respaldarla en la nube usando GitHub.

2. Fase 1: Instalación (El Manual de Supervivencia)

Antes de abrir cualquier editor, cada estudiante debe cumplir estos tres requisitos: 1. Python: Descargar la versión más reciente. Punto Crítico: Durante la instalación, deben marcar obligatoriamente la casilla que dice “Add Python to PATH”. Sin esto, el computador no reconocerá las instrucciones. 2. Visual Studio Code (VSCode): Instalarlo y buscar en el menú de extensiones la extensión oficial de “Python” (creada por Microsoft). 3. Git: Descargar e instalar Git. En la instalación, dejar todas las opciones por defecto presionando “Next” hasta el final.

3. Fase 2: Creación del Proyecto y el Código

Vamos a replicar la aplicación que hicimos en Colab, pero ahora en nuestro propio computador.

1. Crea una carpeta en tu computador llamada proyecto_ingenieria.
2. Abre VSCode, ve a Archivo > Abrir Carpeta y selecciona esa nueva carpeta.
3. Dentro de VSCode, crea un archivo nuevo llamado app.py.
4. Escribe (o transcribe) el siguiente código en tu archivo app.py y guarda los cambios (Ctrl + S):

import streamlit as st
import math

# Función lógica
def volumen_cilindro(radio, altura):
    return math.pi * (radio**2) * altura

# Diseño de la Interfaz Web
st.title("Calculadora de Volumen para Tanques 💧")
st.write("Aplicación interactiva para Ingeniería Agrícola, Civil y Agroindustrial.")
st.divider()

# Entradas de datos
r = st.number_input("Radio del tanque en metros (r):", min_value=0.0)
h = st.number_input("Altura del tanque en metros (h):", min_value=0.0)

# Botón de ejecución
if st.button("Calcular Volumen"):
    v = volumen_cilindro(r, h)
    st.success(f"El volumen útil del tanque es de: {v:.2f} metros cúbicos.")

4. Fase 3: Ejecución Local de la Aplicación

En Colab usábamos comandos mágicos. En VSCode, usaremos la Terminal integrada.

1. En el menú superior de VSCode, selecciona Terminal > Nueva Terminal.

2. Instala la librería de Streamlit en tu computador ejecutando el siguiente comando y presionando Enter:

   pip install streamlit

3. Una vez termine la instalación, enciende tu aplicación ejecutando:

   streamlit run app.py

   (¡Tu navegador se abrirá automáticamente mostrando tu aplicación funcionando desde tu propio equipo!)

5. Fase 4: Configuración de Git y GitHub

Detén tu aplicación en la terminal haciendo clic en ella y presionando Ctrl + C. Ahora vamos a guardar el código en la nube.

Identificación inicial (Solo se hace una vez en la vida): En la misma terminal, preséntate ante Git con estos dos comandos (usa tus datos reales): * git config --global user.name "Tu Nombre Real" * git config --global user.email "tu_correo@ejemplo.com" (Usa el correo con el que te registrarás en GitHub).

Creación del repositorio en la nube: 1. Ve a GitHub y crea tu cuenta. 2. Haz clic en “New repository”, nómbralo calculadora-tanques y presiona crear.

6. Fase 5: El Ciclo de los 5 Comandos de Oro

Para subir el código desde VSCode a GitHub, ejecuta esta secuencia exacta en tu terminal de VSCode:

1. git init (Inicias el sistema de control de versiones en tu carpeta).
2. git add . (Preparas todos los archivos).
3. git commit -m "Mi primera app de ingeniería" (Guardas la “fotografía” de tu código).
4. git remote add origin [PEGA_AQUÍ_LA_URL_DE_TU_REPOSITORIO_GITHUB] (Conectas tu equipo con la nube).
5. git push -u origin main o git push -u origin master (Subes los archivos a GitHub).

(Nota: VSCode podría abrir una ventana del navegador pidiendo que autorices el inicio de sesión. Acéptalo).

7. Actividades de Aprendizaje Guiado

El “Salvavidas” de Errores con IA: Si ocurre un error rojo en la terminal al intentar usar Git, usa este prompt en tu asistente IA: > “Estoy aprendiendo a usar Git en VSCode y me salió este error: [PEGAR ERROR]. Explícame qué significa y dame los pasos numerados y exactos para solucionarlo.”

8. Resumen Cognitivo (Para escritura a mano)

El resumen de esta semana debe incluir: 1. Transición: Diferencia clave entre ejecutar en Colab y ejecutar localmente con streamlit run app.py. 2. Diagrama de Flujo: Dibuja cómo el código viaja desde tu computador (VSCode) hacia la nube (GitHub), anotando las 5 instrucciones del “Ciclo de Oro” en las flechas correspondientes. 3. Reflexión final: “Mi código ahora es parte de mi identidad profesional en GitHub”.