DEV Community: Rony Quispe

Crea tu primera app de escritorio con Python y PyQt5 (paso a paso)

Rony Quispe — Sat, 21 Jun 2025 18:01:00 +0000

¿Alguna vez quisiste crear tu propia app para automatizar algo, pero pensaste que era muy difícil? A mí me pasó.
Todo comenzó cuando una amiga que no le gusta ser oprimida por el sistema me dijo que quería poder descargar videos sin tener que inundarse de publicidad y virus.
Así que se me ocurrió crear una aplicación pequeña para ella. Una vez terminado vi que esto podría mejorar así que decidí crear algo un poco más completo.

Al ver todo lo que tenía que hacer, decidí investigar y me encontré con esta herramienta muy común en el campo de Python: PyQt5.

¿Por qué PyQt5? 🤔

Es de las opciones más completas y potentes si te encuentras en la necesidad de crear una interfaz gráfica con Python. Es multiplataforma, se desenvuelve bien al trabajar con hilos (threads) y a diferencia de una herramienta similar como Tkinter, tiene soporte para todo lo que necesitarás. Tablas, botones, comboboxes, diálogos, etc.

Instalación de PyQt5

Como toda librería de python, podremos instalarla usando el comando:
pip install PyQt5

Capítulo 1: El esqueleto

Aunque he mencionado una app al inicio que es medianamente completa, en este artículo solo nos limitaremos a crear una app base para que puedas comenzar a crear tu propia aplicación.

El esqueleto

Nuestra app tendrá lo siguiente:

Una ventana principal
Un campo para ingresar texto
Un botón que accionará un evento
Separar los archivos para mayor escalabilidad

Estructura del proyecto

mi_app/
├── core/
│   └── logic.py
├── gui/
│   └── main_window.py
├── main.py

Como se puede ver, tendremos en esencia 3 archivos:

El main: Será responsable de inicializar y lanzar la interfaz gráfica.
main_window: El responsable de construir todos los elementos gráficos.
logic: Que se encargará de manejar la lógica del negocio.

Capítulo 2: Los Elementos Gráficos en PyQt5 🔥💧🍃🪨

Main.py

import  sys
from PyQt5.QtWidgets import QApplication
from gui.main_window import MainWindow
def main():
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

if __name__ == "__main__":
    main()

Vemos que Main solo tiene un método definido el cual se ejecuta e instancia QApplication, que es el Widget de PyQt5 que se encarga de:

Manejar eventos del sistema operativo.
Gestionar recursos visuales.
Correr el ciclo de eventos que mantiene viva la ventana.

Luego creamos una instancia de nuestra Clase MainWindow el cual se mostrará gracias al método show()

Y por último pasamos todo esto al sistema.

MainWindow.py

Ahora tenemos nuestra clase MainWindow. Usando varios elementos widgets de nuestra librería.

Primero nombra la aplicación como Mi primera App PyQt5

Segundo, crea la variable input, label y button. Usando las clases QLineEdit, QLabel y QPushButton. Que en esencia son los widgets básicos para crear elementos en nuestra interfaz.

Luego, conectamos el botón con el método say_hello

Layout

Como vemos, luego de crear las variables anteriores. Se crea una variable llamada layout, que es la forma en la que la librería acomoda los elementos en la interfaz. Básicamente es un cuadro "invisible" en la cual se van insertando los widgets que vamos creando.

Por ultimo se crea un contenedor principal al cual establecemos el layout.

Sé que parece incongruente que un layout se agregue a un widget y un widget se agregue a layouts. Pero entenderás esto de manera más clara mientras vas creando tu aplicación

Y al final tendremos el método que será accionado al hacer click en el botón. El cual conseguirá el texto que se ingresó en el input y lo validará para mostrar en el label

Logic

Por último tenemos la clase Logic que se encargará de manejar las reglas del negocio. Esto es importante porque recordemos que es necesario separar la lógica de la interfaz.

Por simplicidad, haremos que la clase solo tenga un método el cual validará si el texto ingresado es o no un número. Y de serlo, deberá mostrar que el texto no es válido (tal como se ve en el método say_hello de la clase MainWindow)

Capítulo 3: El conjuro 🪄

Ahora al ejecutar esto nos aparecerá lo siguiente. Una simple ventana increíblemente chiquita. Con el input, el botón de acción y un label cuyo texto cambiará si ingresamos un texto en el input

Texto ingresado:

Capítulo 4: Viaje terminado

Y así es como se puede comenzar a crear aplicaciones de escritorio en Python. Con una estructura de archivos base que nos ayudará a separar los diferentes aspectos de nuestro programa.
Esto parece ser tonto al inicio pero es fundamental porque muchas veces podremos desconocer que tanto puede crecer un proyecto mientras se va desarrollando. Esto nos permite poder reducir muchos tiempos de desarrollo ya que está modulado desde el inicio.

Si haz llegado hasta aquí, ¡Muchas gracias por leer este artículo!, te animo a dejar un comentario de cualquier tipo. Y cualquier duda ten por seguro que te la responderé a la brevedad. 😁

💪Reinicia una migración específica en Laravel 'migrate:refresh'

Rony Quispe — Sat, 17 Jun 2023 19:17:06 +0000

Cuando trabajamos con Laravel y su potente sistema de migraciones de base de datos, a veces nos encontramos en situaciones en las que necesitamos reiniciar una migración específica sin tener que recurrir a complicados pasos de rollback. Afortunadamente, Laravel nos ofrece una solución elegante con el comando migrate:refresh. En este artículo, exploraremos cómo usar migrate:refresh para reiniciar una migración de un lote en particular, sin afectar las migraciones anteriores o posteriores.

Antes de comenzar debes conocer:

Laravel básico
Migraciones laravel básico
Comandos artisan

Comenzamos ✍️

Supongamos que estamos desarrollando una aplicación web para una escuela. Hemos realizado varias migraciones para configurar nuestras tablas, incluyendo las relacionadas con los cursos, las notas y los estudiantes.

Para enfocarnos en el tema, ignoraremos que hay dentro de las clases y que cambios tendrán, concentremonos en las migraciones 🐺

Migraciones 👷‍♂️

Migración de courses (Batch 1):
Creamos una migración inicial para la tabla de courses llamada 2023_06_17_012246_create_courses_table.php y la ejecutamos mediante php artisan migrate.

Migración de grades (Batch 2):
Posteriormente, agregamos otra migración para la tabla de grades llamada 2023_06_17_012637_create_grades_table.php.php y la ejecutamos con php artisan migrate. Esta migración se asigna al segundo lote (batch 2) en la tabla migrations.

Migración de students (Batch 3):
Continuamos con otra migración para la tabla de students llamada 2023_06_17_013600_create_students_table.php.php y la ejecutamos con php artisan migrate. Esta migración se asigna al tercer lote (batch 3) en la tabla migrations.

En la tabla migrations de nuestra base de datos se veria lo siguiente:

Situación

Ahora, supongamos que hemos realizado cambios en la migración de grades (2023_06_17_012637_create_grades_table.php.php) y deseamos reiniciar solo esa migración sin afectar las migraciones de cursos y estudiantes.

Ejecutamos el comando
php artisan migrate:refresh --path=database/migrations/2023_06_17_012637_create_grades_table.php.php
El comando migrate:refresh lo que hace es el ejecutar por cada migración su método down y luego su método up.
Este comando por si solo reiniciaria todos los archivos de migraciones. Por ello usamos el parámetro path, para indicar a laravel que solo ejecute esto para un archivo específico
sub(Es posible que en versiones anteriores de Laravel 10 debas comenzar el path con /database)

Este comando reiniciará la migración específica de grades, eliminando la tabla grades y recreándola de acuerdo con la definición de la migración create_grades_table.

Esto modificará el contador de batch, ya que eliminará el registro de migración inicial que tuvo grades_table y lo registrará de nuevo con el nuevo máximo número de batch.

Se vería lo siguiente:

Como se puede ver, la migración de grades fue eliminada y registrada de nuevo, cambiando su batch de 2 a 4.

⚠️⚠️ Recuerda, si la migración implica recrear una tabla o columna, la data que existe en la base de datos será eliminada. Este comando se repotencia si usas seeders para llenar nuevamente la tabla.⚠️⚠️

🎉¡Felicidades!, ahora sabes como realizar un migrate:refresh específico. 🥳

Ajá. ¿Pero que hago con esto? 🤡

Este comando te ayudará a corregir una migración sin tener que deshacer migraciones posteriores a estas. Asi no necesitarás crear nuevas migraciones, lo que conlleva a crear procesos innecesarios en tu desarrollo.