Calculadora React + Vite

Ya en el post anterior les compartí mi primer proyecto con javascript. Continuamos la ruta de aprendizaje con dos tecnologías con las que me estoy familiarizando: React y Vite Y qué mejor manera de empezar que con un clásico: una calculadora.

Debo admitir que me costó un poco más de lo que me esperaba. No soy gran fanático del diseño en general por lo que adelanto que seguramente utilice mucho bootstrap de aquí en adelante y algo de ayuda del buen chatbot (en lo que respecta exclusivamente al diseño). Resulta que las calculadoras son algo más que un if anidado, sobre todo en lo que respecta al comportamiento estable y las situaciones edge:

• Evitar los doble "00", el doble punto: "1.14.5"
• Manejo del doble operador
• Manejo del doble ==
• Cambio de operadores
• Permitir el ingreso de datos a través del teclado
• ...

En fin, situaciones que surgen del uso.

Un diseño muy a lo android que busca ser simple, moderno y funcional, con todo lo necesario para las operaciones del día a día.

Arquitectura de componentes

La calculadora está construida siguiendo una arquitectura de componentes reutilizables, una de las principales ventajas de React.

• Calculadora.jsx: Es el componente principal y el cerebro de la aplicación. Orquesta a todos los demás componentes y centraliza la lógica y el estado. Aquí se manejan los clics de los botones, se realizan las operaciones matemáticas y se actualiza el valor que se muestra en pantalla.

• Display.jsx: Un componente simple y reutilizable cuya única responsabilidad es mostrar los valores que recibe a través de sus props. No contiene lógica, simplemente refleja el estado actual de la calculadora que le es proporcionado por el componente anterior

• Teclado.jsx: Actúa como un contenedor para todos los botones de la calculadora. Su función es organizar y renderizar los componentes Boton.jsx en un diseño coherente de cuadrícula.

• Boton.jsx: Representa un botón individual en la calculadora. Es un componente altamente reutilizable que recibe propiedades (props) para definir su texto (ej. "7", "+", "="), su color y la función que debe ejecutar al ser presionado.

Flujo de Datos y Lógica

El funcionamiento sigue el patrón de diseño común en React de "levantamiento del estado" (lifting state up):

1. Estado Centralizado: Toda la lógica y los datos importantes (como el número actual, la operación pendiente y el resultado) residen en el estado del componente Calculadora.jsx.
2. Paso de Datos (Props): Calculadora.jsx pasa los datos necesarios a los componentes hijos. Por ejemplo, pasa el valor a mostrar al componente Display.jsx.
3. Actualización del Estado: Esta función, al ser llamada, actualiza el estado dentro de Calculadora.jsx con el nuevo valor o realiza la operación correspondiente.
4. Re-renderizado: Al cambiar el estado de Calculadora.jsx, React vuelve a renderizar este componente y sus hijos. Como resultado, Display.jsx recibe el nuevo valor y lo muestra en pantalla, completando el ciclo.

Tecnologías y Conceptos Utilizados

Me apoyé en un conjunto de herramientas y librerías muy populares en el mundo del front-end:

• React: El corazón de la aplicación. Toda la interfaz está construida con componentes reutilizables, como los botones (<Boton />) o la pantalla (<Display />). Fue mi primera inmersión real en el manejo del estado (useState) para la lógica de los cálculos.
• Vite: Como entorno de desarrollo, es increíblemente rápido. Permite tener un servidor de desarrollo casi instantáneo y una experiencia de "hot-reloading" que agiliza muchísimo el trabajo.
• Styled Components: Para el diseño, opté por esta librería de CSS-in-JS. Me encantó la idea de tener los estilos encapsulados dentro de cada componente, lo que hace que el código sea más ordenado y mantenible.
• Bootstrap y React-Bootstrap: Utilicé Bootstrap para la estructura general y algunos componentes base, aprovechando su sistema de grids.
• React Toastify: Para las notificaciones. Si intentas hacer una operación inválida (como dividir por cero), una pequeña notificación aparecerá para avisarte.
• React Helmet: Una herramienta genial para gestionar el <head> de la página y los aspectos relacionados al SEO del sitio.

Y por supuesto, en modo oscuro. Detesto los sitios y/o apps quema retinas.

Como siempre, el código está muy comentado. Les comparto los links al deploy y al repo en github.

• Deploy: https://calculadora-react-tna.netlify.app/
• Github: https://github.com/mcattani/calculadora_react_vite

Cada pequeña ayuda o gesto de apoyo significa un montón para mí. Si quieres ayudar puedes invitándome un cafecito:

JsTimer - Mi Primer Proyecto con JavaScript: Creando un temporizador

Recientemente empecé a interiorizarme un poco con el mundo del front-end. Les comparto mi primer proyecto: un temporizador completamente funcional creado desde cero.

Al mismo tiempo hice un temporizador en Gambas3 que compartiré en algún momento, pues aún no está terminado. No sé que tengo con los temporizadores...

¿Qué hace el proyecto?

Es simple, pero efectivo. Podemos:

• Establecer un tiempo: Puedes definir horas, minutos y segundos.
• Iniciar la cuenta regresiva: Con solo un clic, el tiempo empieza a correr.
• Ver el tiempo restante: Una pantalla digital muestra la cuenta regresiva.
• Sonar una alarma: Cuando el tiempo llega a 00:00:00, una alarma suena para avisarte.
• Detener la alarma: Un botón aparece para que puedas silenciar el sonido una vez que has escuchado el aviso.

No usé frameworks ni librerías complicadas, solo los tres pilares de la web:

1. HTML: Fue mi punto de partida. Lo usé para dar estructura a la página: un título, los campos para introducir el tiempo (<input type="number">), los botones (<button>) y, por supuesto, el <h2> donde se muestra el tiempo. También incluí una etiqueta <audio> que, aunque invisible, es la responsable de reproducir el sonido de la alarma.

2. CSS: Usé un fondo oscuro y semitransparente para el contenedor principal para que resaltara sobre una imagen de fondo. Con flexbox, centré todo perfectamente en la pantalla.

3. JavaScript (Vanilla): El cerebro de toda la operación y la parte que más me interesa realmente. El diseño no es lo mío por lo que probablemente en futuros proyectos use bootstrap o algunos templates que encuentre en la web.

   • Manipulación del DOM: Usé document.getElementById() para "conectar" mi código JavaScript con los elementos de mi HTML (botones, inputs, etc.).
   • Eventos: Con addEventListener("click", ...), puse a los botones a "escuchar" los clics del usuario para que supieran cuándo ejecutar una función.
   • setInterval: Esta fue la clave de todo. setInterval(funcion, 1000) es una función de JavaScript que me permitió ejecutar el código para actualizar el temporizador cada segundo (1000 milisegundos).
   • Lógica de tiempo: Tuve que desempolvar las matemáticas para convertir el total de segundos a un formato de horas:minutos:segundos. El operador módulo (%) -> esencial.
   • Funciones Flecha: Adopté la sintaxis moderna de JavaScript usando funciones flecha () => {}.

Pueden ver el timer en funcionamiento en este link: https://jstimer-tna.netlify.app/

Crear este proyecto desde cero fue una buena experiencia para arrancar. Me enfrenté a pequeños desafíos, como asegurarme de que el formato del tiempo siempre tuviera dos dígitos (ej. 09 en vez de 9) o detener correctamente el intervalo del temporizador.

Si estás aprendiendo, te animo a que intentes construir algo similar. No tienes que hacerlo perfecto, solo tienes que empezar.

Como siempre, les dejo el link al repo de GitHub: https://github.com/mcattani/jsTimer.git

Cada pequeña ayuda o gesto de apoyo significa un montón para mí. Si quieres ayudar:

.

Saludos!

Info Clima - Script de Python (v2)

Versión actualizada del script publicado en esta entrada: Info Clima - Script de Python para ver la información del Servicio Meteorológico Nacional

Esta versión ya no usa la información del SMN dado que el sitio me estaba dando problemas, específicamente con la descarga del archivo zip.

Esta versión se utiliza la API de WeatherApi

Para el uso del script es necesario crear una cuenta gratuita en el sitio y obtener la API KEY para insertar luego en el código.

Dado que sigo continuando mi aprendizaje sobre python y estaba leyendo sobre clases decidí reescribir el código utilizando esté método. Esto responde a una decisión completamente arbitraria aunque sí creo que el resultado es un código más ordenado o "limpio" si se quiere.

Las clases proveen una forma de empaquetar datos y funcionalidad juntos. Al crear una nueva clase, se crea un nuevo tipo de objeto, permitiendo crear nuevas instancias de ese tipo. Cada instancia de clase puede tener atributos adjuntos para mantener su estado. Las instancias de clase también pueden tener métodos (definidos por su clase) para modificar su estado. Fuente

Por el momento el script anterior será reemplazado por este, si en algún momento logro hacer funcionar el script anterior subiré ambas versiones al repo.

Nota: me olvidé de aclarar que la funcionalidad del script es exactamente igual, por un tema de comodidad si no se ingresa nada en el prompt obtiene los datos para 'Buenos Aires'. En este caso no hay que descargar un archivo ni descomprimirlo, simplemente solicitar los datos mediante la API. Lo cual introduce el uso de la librería json para convertir los datos recibidos en un diccionario.

Link al repo de GitHub: https://github.com/mcattani/script_clima

Espero les resulte de interés. Si es así los invito a dejar un comentario y si tienen ganas pueden invitarme un cafecito!:

CineBase (Python + Sqlite)

En esta ocasión y continuando con el aprendizaje de Python les quería compartir una aplicación cuyo objetivo es aprender a interactuar con una base de datos sqlite.

Ya he utilizado este tipo de base de datos en otros proyectos:

• Tachame la Lista!
• MyNotesDB

CineBase como he llamado a este script es un sistema de gestión de base de datos de películas. Encontré una muy amplia (no sé que tan precisa es, no es el punto igualmente) en Kaggle (sin atribución).

Un poco la intención de este script es la de:

• Familiarizarme con el uso y manejo de sqlite en python.
• Modularización y organización del código.
• Uso de 'gestores de contexto' para el manejo de la base de datos.
• Uso de librerías para el manejo de input del usuario, validación de entradas y aspectos estéticos.

Mientras estoy escribiendo esto también estoy leyendo sobre docstrings y type annotations por lo que también habrá algo de eso en el código.

Según Google (respuesta de la IA):

"Los docstrings en Python son cadenas de texto que se utilizan para documentar funciones, clases, módulos o métodos. Se escriben entre comillas triples y se colocan al principio del bloque de código. Los docstrings son una herramienta que ayuda a los programadores a entender el código y a otros programadores que quieran usarlo..."

"Las anotaciones de tipo en Python son una notación opcional que indica el tipo de los parámetros y resultados de una función. También se les conoce como sugerencias de tipo o type signatures..."

Cómo se puede observar en la captura arriba, el menú principal consta de varias opciones:

• Buscar películas por título, fecha de estreno, calificación y director.
• Buscar sinopsis de la películas
• Buscar directores
• Agregar y borrar películas y directores.

La primera versión de este script resultaba "medio plana" (aburrida) por lo que decidí hacer uso de algunas librerías para hacer el menú más amigable, agregar un poco de "ascii art" y mostrar los resultados en un formato más o menos amigable.

Las tres librerías utilizadas:

• Questionary
• PrettyTable
• Art

La instalación de las mismas es muy sencilla:

pip install -r requirements.txt

Intentando (palabra clave) mantener el código lo más prolijo y legible verán que, además de la base de datos, el código está escrito en tres bloques:

1. main.py: contiene la lógica principal del programa.
2. interfaz_usuario.py: módulo que se encarga de solicitar los inputs al usuario y validar los mismos.
3. interfaz_sql.py: módulo que maneja la lógica de búsqueda e ingreso de datos en la base.

Obviamente no pretendo que este programa sea un "ejemplo a seguir" en términos de calidad programística, quienes estén leyendo esto y estén versados en Python seguramente encontrarán un montón de cosas a corregir, criticar, etc. (tampoco creo que sea un horror, estoy bastante satisfecho).

La idea es ayudar a quienes como yo estamos aprendiendo y quieran experimentar con el uso de base de datos, utilizar librerías para mejorar la apariencia del código, etc.

Como siempre el código está bastante comentado.

Les dejo el link al repo en GitHub: https://github.com/mcattani/cinebase

Espero les resulte de interés. Si es así los invito a dejar un comentario y si tienen ganas pueden invitarme un cafecito!

Saludos!

Info Clima - Script de Python para ver la información del Servicio Meteorológico Nacional

Hace poco comencé un curso de introducción a Python por lo que en esta ocasión les dejo mi primer script más o menos funcional.

[Actualización 05/04/2024]: Ver la entrada actualizada: https://thenerdyapprentice.blogspot.com/2025/04/info-clima-script-de-python-v2.html

info_clima.py es un script que descarga la información del Servicio Meteorológico Nacional (SMN) y muestra los datos meteorológicos actualizados en la terminal.

   

Sé que a menos que estés leyendo esto desde Argentina quizás este proyecto no resulta de gran interés. Pero me pareció interesante su realización como ejercicio. Utiliza todas librerías que ya vienen con python por lo que este script debería funcionar out of the box sin ningún problema tanto en Windows como en Linux.

Contiene elementos que pueden resultar de interés si estas empezando a programar en python:

• Descarga de archivos de internet.
• Descompresión de archivos zip.
• Uso de ubicaciones temporales.
• Uso de 'listas de listas'
• Uso de colores en la terminal (algo XD)

El código está bastante comentado. Pero en resumidas cuentas el script descarga un archivo comprimido (zip) de la web del SMN y descomprime su contenido (una especie de archivo CSV pero utilizando el punto y coma para separar los valores) en una ubicación temporal.

Luego procesa este archivo convirtiéndolo en una 'lista de listas'.

Las listas de listas permiten representar esta estructura de manera natural, donde cada fila de la tabla se convierte en una sublista y cada columna se representa mediante elementos dentro de esas sublistas (Fuente)

El script solicita al usuario que ingrese la ubicación de la cual quiere conocer los datos, en caso de no ingresar nada por defecto devuelve la información de "Buenos Aires".

Por supuesto que hay mucho espacio para la mejora (de hecho no toda la información suministrada se muestra, solo la que a mi me resulta de interés). Creo que es un buen script de práctica para el que está aprendiendo.

Como siempre les dejo el link al repo de GitHub: https://github.com/mcattani/script_clima

Espero les resulte de interés. Si es así los invito a dejar un comentario y si tienen ganas pueden invitarme un cafecito!:

[Actualización 15/12/2024]: Decidí reescribir el script casi desde 0, me parecía que estaba bastante desordenado. Separé todas las operaciones más importantes en funciones. También decidí por ahora sacar el tema de los colores (quizás en una versión futura vuelva a agregarlas) y de la ubicación temporal (el script ahora borra los archivos después de utilizarlos).

Saludos!