QT Pear es un conjunto de herramientas de línea de comandos diseñadas para facilitar la transpilación¹ de proyectos en QT.
Realizado para el cumplimiento de los requisitos de Introducción a la Programación del curso 2024-2025 en la CUJAE.

Características

• Transpilador de caracteres especiales: Asegura la compatibilidad con la CMD de Windows al manejar caracteres especiales y tildes.
• Creador de proyectos: Crea proyectos a partir de plantillas ya predefinidas.
• Auto indexado: Actualiza automaticamente el archivo de proyecto (*.pro) con todos los archivos C en los subdirectorios
• Auto prototipado: Actualiza automaticamente todos los archivos de encabezado (*.h) con sus prototipos

Instalación

Esta herramienta fue desarrollada con NodeJS, por lo que su instalación será realizada con npm:

npm i qtpear

Una vez instalado, puede comprobar si esta funcionando correctamente:

qtpear --version

Para ver la documentación integrada ejecute:

qtpear -h

¿Por qué usar Qtpear?

Esta es una herramienta personal para automatizar tareas repetitivas, además de que si eres usuario Linux, puedes crear software compatible con Windows utilizando estas utilidades.

Transpilado de caracteres

La terminal de Windows, a diferencia de otros sistemas tales como Linux, utiliza de manera predeterminada una codificación de caracteres DIFERENTE a UTF-8, por lo que los típicos caracteres de escape ASCII no son soportados. Presenta una forma de representación que para el parecer de muchos es extraña:

printf("\240"); // á
printf("\202"); // é
printf("\265"); // Á

Qtpear tiene el comando parse que clonará y convertirá el siguiente código:

#include "example.h"

void mostrarDialogo (char *nombre) {
  printf("Hola %s, ¿El camión está listo?\n", nombre);
  printf("No aún no, ¡mañana será mi cumpleaños!");
}

A este código:

#include "example.h"

void mostrarDialogo (char *nombre) {
  printf("Hola %s, \250El cami\242n est\240 listo?\n", nombre);
  printf("No a\243n no, \255ma\244ana ser\240 mi cumplea\244os!");
}

Simplificando así el flujo de desarrollo y evitar recordar la extensa e incómoda tabla de caracteres

Creador de proyectos

El QT5.3 ya viene con un creador de proyectos predeterminado, pero... ¿y si lo mejoramos con los requerimientos del curso?

Así, el comando create preguntará que plantilla utilizar y el nombre del proyecto. Esta es la plantilla logic

─ example/
   ├─ example.pro
   │
   ├─ Logica/
   │   ├─ logica.c
   │   └─ logica.h
   │
   └─ Interfaz/
       ├─ interfaz.c
       └─ interfaz.h

Autoprototipado

En algunos casos cuando el proyecto crece en tamaño, comienza a complicarse el mantenimiento de los prototipos de las funciones. Puede resultar problemático y aumenta la posibilidad de escribir los prototipos con errores.
Qtpear presenta el comando auto header que detectará todos los archivos C y autogenerará en sus respectivos archivos de encabezado (*.h) los prototipos.
Así los archivos:

// Archivo: example.h
#include <math.h>
int malPrototipo(int x, char *word);


// Archivo: example.c
#include "example.h"

int sumar(int x, int y) {
  return x * y;
}

int distancia(int x1, int x2, int y1, int y2) {
  return sqrt(
    pow(x1 - x2, 2) + pow(y1 - y2, 2)
  );
}

Actualizará el encabezado eliminando los prototipos no encontrados e insertando los actuales:

// Archivo: example.h
#include <math.h>

int sumar(int x, int y);
int distancia(int x1, int x2, int y1, int y2);

Licencia

Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.

Coded by Rodny Estrada