En entradas anteriores explicaba cómo Comparar la estructura de dos Bases De Datos con DbWrench. En esta oportunidad voy a mostrar cómo hacerlo para bases de datos PostgreSQL sin necesidad de instalar ninguna herramienta extra.

Versiones más recientes de pgAdmin 4 incorporan una opción para comparar esquemas de bases de datos PostgreSQL. Esta utilidad lleva como nombre Schema Diff.

Inicialmente les comento que la versión que estoy usando de pgAdmin 4 es la 4.21 para Windows:

He creado dos bases de datos diferentes para demostrar la funcionalidad, una llamada movies y otra movies_copy.

La base de datos movies contiene solo dos tablas genres y series:

/* Tabla de Géneros */
CREATE TABLE public.genres
(
    id serial NOT NULL,
    name character varying NOT NULL,
    CONSTRAINT genres_pkey PRIMARY KEY (id)
);

/* Tabla de Series */
CREATE TABLE public.series
(
    id serial NOT NULL,
    name character varying NOT NULL,
    year character(4),
    id_genre integer,
    CONSTRAINT series_pkey PRIMARY KEY (id),
    CONSTRAINT series_genres_fk FOREIGN KEY (id_genre)
        REFERENCES public.genres (id) MATCH SIMPLE
        ON UPDATE NO ACTION
        ON DELETE NO ACTION
        NOT VALID
);

Mientras que la base de datos movies_copy contiene tres tablas genres, series (con un cambio en el year) y movies:

/* Tabla de Géneros */
CREATE TABLE public.genres
(
    id serial NOT NULL,
    name character varying NOT NULL,
    CONSTRAINT genres_pkey PRIMARY KEY (id)
);

/* Tabla de Series */
CREATE TABLE public.series
(
    id serial NOT NULL,
    name character varying NOT NULL,
    year character(5),
    id_genre integer,
    CONSTRAINT series_pkey PRIMARY KEY (id),
    CONSTRAINT series_genres_fk FOREIGN KEY (id_genre)
        REFERENCES public.genres (id) MATCH SIMPLE
        ON UPDATE NO ACTION
        ON DELETE NO ACTION
        NOT VALID
);

/* Tabla de Películas */
CREATE TABLE public.movies
(
    id integer serial NOT NULL,
    name character varying NOT NULL,
    year character(4),
    id_genre integer,
    CONSTRAINT movies_pkey PRIMARY KEY (id),
    CONSTRAINT movies_genres_fk FOREIGN KEY (id_genre)
        REFERENCES public.genres (id) MATCH SIMPLE
        ON UPDATE NO ACTION
        ON DELETE NO ACTION
);

Para hacer la comparación solo tenemos que ir al menú Tools -> Schema Diff:

Luego seleccionar las opciones que correspondan en Select Source y Select Target, y hacer click en Compare. Podremos ir explorando las diferencias encontradas.

1. Schema Diff - Nueva Secuencia de Tabla movies encontrada:
   
2. Schema Diff - Nueva Tabla movies encontrada:
   
3. Schema Diff - Diferencia en estructura de Tabla series:
   



Finalmente podemos generar un Script con los cambios encontrados seleccionando todos los items que queremos que sean incluidos y haciendo click en Generate Script:





El Script generado quedaría de la siguiente manera:

-- This script was generated by a beta version of the Schema Diff utility in pgAdmin 4. 
-- This version does not include dependency resolution, and may require manual changes 
-- to the script to ensure changes are applied in the correct order.
-- Please report an issue for any failure with the reproduction steps. 
BEGIN;
CREATE SEQUENCE public.movies_id_seq
    INCREMENT 1
    START 1
    MINVALUE 1
    MAXVALUE 2147483647
    CACHE 1;

ALTER SEQUENCE public.movies_id_seq
    OWNER TO postgres;

CREATE TABLE public.movies
(
    id integer NOT NULL DEFAULT nextval('movies_id_seq'::regclass),
    name character varying COLLATE pg_catalog."default" NOT NULL,
    year character(4) COLLATE pg_catalog."default",
    id_genre integer,
    CONSTRAINT movies_pkey PRIMARY KEY (id),
    CONSTRAINT movies_genres_fk FOREIGN KEY (id_genre)
        REFERENCES public.genres (id) MATCH SIMPLE
        ON UPDATE NO ACTION
        ON DELETE NO ACTION
)

TABLESPACE pg_default;

ALTER TABLE public.movies
    OWNER to postgres;

-- WARNING:
-- The SQL statement below would normally be used to alter the datatype for the id column, however,
-- the current datatype cannot be cast to the target datatype so this conversion cannot be made automatically.

 -- ALTER TABLE public.series
 --     ALTER COLUMN id TYPE integer;

ALTER TABLE public.series
    ALTER COLUMN year TYPE character(5) COLLATE pg_catalog."default";
CREATE INDEX "None"
    ON public.series(id_genre);

END;




De esta manera logramos comparar la estructura de dos Bases de Datos PostgreSQL únicamente usando la herramienta que nos brinda pgAdmin 4. Espero pueda ser de utilidad y comenta ¿qué te pareció esta funcionalidad? ¿la conocías?.

¿Les ha pasado que les piden unos cambios en el proyecto y luego de que los terminamos y hacemos commits de ellos, deciden que no los quieren? Git nos brinda una manera sencilla de volver nuestro branch a un commit anterior, o en otras palabras, volver en el tiempo.

Existen varias maneras que nos permiten lograr volver a un commit anterior, acá les voy a mostrar como hacerlo con el comando git reset.

Lo primero que debemos hacer es obtener el id (hash) del commit al cual queremos volver y lo podemos hacer de la siguiente forma:

git log --oneline

3ae884e (HEAD -> master) Se le pone corazón al formulario ASAP
1a61b76 Se agregan más opciones al formulario ASAP
0b448af Se agrega formulario ASAP
d4e428e Se agrega formulario de Proveedores
41df9f8 Se agrega formulario de Clientes
1a3a429 Se agrega formulario de Usuarios
2e7e6cd Primer commit

Supongamos en este caso que los cambios que no se quieren son a partir del commit con mensaje Se agrega formulario ASAP, entonces queremos volver al commit d4e428e descrito como Se agrega formulario de Proveedores.

Ejecutaríamos lo siguiente:

git reset --hard d4e428e

Si hacemos nuevamente un:

git log --oneline

d4e428e (HEAD -> master) Se agrega formulario de Proveedores
41df9f8 Se agrega formulario de Clientes
1a3a429 Se agrega formulario de Usuarios
2e7e6cd Primer commit

Podemos ver como ya se han removido todos los commits que seguían a Se agrega formulario de Proveedores. ¡Genial!

Pero como la vida es así de inesperada. Vuelven a decirnos que los cambios si van a requerirse.

¡Nooo! No puede ser... ¿Y ahora? Es el momento de mantener la calma, ya que git nos brinda la posibilidad de volver al futuro.

Lo único que tenemos que hacer es un:

git reflog

d4e428e (HEAD -> master) HEAD@{0}: reset: moving to d4e428e
3ae884e HEAD@{1}: commit: Se le pone corazón al formulario ASAP
1a61b76 HEAD@{2}: commit: Se agregan más opciones al formulario ASAP
0b448af HEAD@{3}: commit: Se agrega formulario ASAP
d4e428e (HEAD -> master) HEAD@{4}: commit: Se agrega formulario de Proveedores
41df9f8 HEAD@{5}: commit: Se agrega formulario de Clientes
1a3a429 HEAD@{6}: commit: Se agrega formulario de Usuarios
2e7e6cd HEAD@{7}: commit (initial): Primer commit

Allí podremos ver el historial completo de cambios de nuestro repositorio local e identificar el hash del commit que tiene el cambio al que queremos ir. En este caso el 3ae884e.

Basta nuevamente con hacer:

git reset --hard 3ae884e

Entonces podemos ver los resultados:

git log --oneline

3ae884e (HEAD -> master) Se le pone corazón al formulario ASAP
1a61b76 Se agregan más opciones al formulario ASAP
0b448af Se agrega formulario ASAP
d4e428e Se agrega formulario de Proveedores
41df9f8 Se agrega formulario de Clientes
1a3a429 Se agrega formulario de Usuarios
2e7e6cd Primer commit

¡Y listo! Ya podemos ver como recuperamos nuestro trabajo.

Gracias Doc. Git, por salvarnos la vida una vez más.

Y ustedes, ¿se han visto alguna vez en esta situación?

Cuando tenemos un teclado en Inglés es molesto no poder insertar los acentos ni letras como la ñ. La verdad nunca busqué una solución al respecto, sin embargo, aprovechando que instalé la nueva versión de Ubuntu 20.04 (Focal Fossa) hice un poco de investigación y me di cuenta de lo fácil que es dar una solución.

Lo que tuve que hacer fue ir al menú Configuración->Región e Idioma y en la opción Fuente de Entrada añadir la opción Inglés (EE.UU. internacional con teclas muertas) como sigue:

Quedando de la siguiente manera:

Ya con esto podemos insertar los acentos sin ningún problema. En el caso de la ñ solo basta con presionar la combinación de teclas shift + ~ y luego la letra n para obtenerla.

Bonus Extra: ¿Cómo insertar el signo de apertura de interrogación ó el de exclamación?

Presionar CTRL + SHIFT + u, y luego escribir bf (para interrogación ¿) o a1 (para exclamación ¡), después presionar ENTER y listo, debe aparecer el símbolo correspondiente. Más info acá.

Instalación de Laravel 7

Para el tutorial, he descargado la versión 7.14.1 de Laravel siguiendo las indicaciones de su documentación oficial.

Para la instalación del Laravel y del paquete que vamos usar requerimos tener instalado Composer.

Requerimientos mínimos para Instalar PHPJasper

• Java JDK 1.6 ó superior.
• PHP 7.2 ó superior.
• Función PHP exec() habilitada.

Instalación de PHPJasper en Laravel 7

Ingresar en el proyecto desde la línea de comandos y ejecutar el siguiente comando:

composer require geekcom/phpjasper

Luego actualizamos para que se descargue:

composer update

¡Y listo! Con eso lo tendrás instalado el paquete.

Uso de PHPJasper en Laravel 7

Si nunca han usado JasperReports pueden ver ésta entrada donde les muestro como crear un reporte en JasperReports desde cero. Les recomiendo Jaspersoft Studio para tal fin. En esta entrada para demostrar el uso de PHPJasper vamos a utilizar los reportes de ejemplo hello_world.jrxml y hello_world_params.jrxml que vienen con el paquete y se encuentran en la ruta vendor/geekcom/phpjasper/examples/.

Inicialmente tienes que añadir la librería donde la vas a usar (para este ejemplo en routes/web.php):

use PHPJasper\PHPJasper; 

La clase PHPJasper nos provee un método para compilar los reportes llamado compile() y se usa de la siguiente manera (no es necesario este paso si lo hace antes desde un programa como Jaspersoft Studio):

Route::get('/compilarReporte', function () {
    $input = base_path() .
    '/vendor/geekcom/phpjasper/examples/hello_world.jrxml';

    $jasper = new PHPJasper;
    $jasper->compile($input)->execute();

    return response()->json([
        'status' => 'ok',
        'msj' => '¡Reporte compilado!'
    ]);
});

Si todo sale bien al ingresar desde el navegador a la ruta del proyecto /compilarReporte debe recibir un json como respuesta:

{
  "status": "ok",
  "msj": "¡Reporte compilado!"
}

Esto va a crear un nuevo archivo en la ruta vendor/geekcom/phpjasper/examples. Una vez que tengas el archivo .jasper generado puedes ejecutar el reporte desde la ruta /reporte:

Route::get('/reporte', function () {
    $input = base_path() .
    '/vendor/geekcom/phpjasper/examples/hello_world.jasper';
    $output = base_path() .
    '/vendor/geekcom/phpjasper/examples';
    $options = [
        'format' => ['pdf']
    ];

    $jasper = new PHPJasper;

    $jasper->process(
        $input,
        $output,
        $options
    )->execute();

    $pathToFile = base_path() .
    '/vendor/geekcom/phpjasper/examples/hello_world.pdf';
    return response()->file($pathToFile);
});

Se debe ver en el navegador el resultado:

Otra de las posibilidades que nos da el paquete es enviar parámetros al reporte, para listar los parámetros que requiere el reporte vamos a usar lo siguiente:

Route::get('/listarParametrosReporte', function () {
    $input = base_path() .
    '/vendor/geekcom/phpjasper/examples/hello_world_params.jrxml';

    $jasper = new PHPJasper;
    $output = $jasper->listParameters($input)->execute();

    return response()->json([
        'status' => 'ok',
        'parms' => $output
    ]);
});

Si entramos a la ruta /listarParametrosReporte vamos obtener algo como esto:

{
  "status": "ok",
  "parms": [
    "P myString java.lang.String",
    "P myInt    java.lang.Integer",
    "P myDate   java.util.Date",
    "P myImage  java.awt.Image    This is the description of parameter myImage"
  ]
}

Luego de manera similar al primer ejemplo vamos a crear una ruta para compilar el reporte con parámetros:

Route::get('/compilarReporteParametros', function () {
    $input = base_path() .
    '/vendor/geekcom/phpjasper/examples/hello_world_params.jrxml';

    $jasper = new PHPJasper;
    $jasper->compile($input)->execute();

    return response()->json([
        'status' => 'ok',
        'msj' => '¡Reporte compilado!'
    ]);
});

Si todo sale bien al ingresar desde el navegador a la ruta del proyecto /compilarReporteParametros debe recibir un json como respuesta:

{
  "status": "ok",
  "msj": "¡Reporte compilado!"
}

Para ejecutar el reporte con parámetros necesitamos una imagen en el directorio vendor/geekcom/phpjasper/examples/ en este caso estoy usando el siguiente logo de JasperReports:

Luego defino una ruta para ejecutar el reporte con parámetros como sigue:

Route::get('/reporteParametros', function () {
    $input = base_path() .
    '/vendor/geekcom/phpjasper/examples/hello_world_params.jasper';
    $output = base_path() .
    '/vendor/geekcom/phpjasper/examples';
    $options = [
        'format' => ['pdf'],
        'params' => [
            'myInt' => 7,
            'myDate' => date('y-m-d'),
            'myImage' => base_path() .
            '/vendor/geekcom/phpjasper/examples/jasperreports_logo.png',
            'myString' => 'Hola Mundo!'
        ]
    ];

    $jasper = new PHPJasper;

    $jasper->process(
        $input,
        $output,
        $options
    )->execute();

    $pathToFile = base_path() .
    '/vendor/geekcom/phpjasper/examples/hello_world_params.pdf';
    return response()->file($pathToFile);
});

El resultado será el como sigue:

Depuración de errores con PHPJasper

Luego de seguir todos los pasos al pie de la letra puede ser que veas el siguiente error:

La clase PHPJasper nos provee una función llamada output() que nos retorna el comando que se esta tratando de ejecutar al generar el reporte. Para poder depurar este comando directamente desde el código lo puedes hacer reemplazando el comando execute con output:

    // Depuración de errores
    dd($jasper->process(
        $input,
        $output,
        $options
    )->output());

De esta manera podrás visualizar el comando que se trata de ejecutar. Solo es cuestión de copiarlo en la consola y ver el verdadero error que te ocurre.

Errores frecuentes con PHPJasper

• Falta de permisos de escritura en la ruta vendor/geekcom/phpjasper/examples/.
• El reporte de ejemplo usa la fuente Arial, es posible que si está en linux veas el siguiente error:

  net.sf.jasperreports.engine.util.JRFontNotFoundException: Font 'Arial' is not available to the JVM. See the Javadoc for more details. at net.sf.jasperreports.engine.util.JRFontUtil.checkAwtFont(JRFontUtil.java:321) at net.sf.jasperreports.engine.util.JRStyledText.getAwtAttributedString(JRStyledText.java:226)

  La solución detallada la encuentras aquí:

  sudo apt-get install ttf-mscorefonts-installer
  sudo cp -r /usr/share/fonts/truetype/msttcorefonts $JAVA_HOME/lib/fonts
      

Espero que sea de utilidad. Cualquier duda o aporte te invito a que la dejes en los comentarios :).

Se han preguntado ¿por qué al hacer un merge entre dos branchs, a veces se añade un nuevo commit que generalmente dice "Merge branch 'nombre_branch'" y en otras ocasiones no lo hace?. Existe una explicación para eso y acá se las voy a dar.

Existen al menos tres posibles resultados cuando hacemos un merge:

• Merge con avance rápido (fast-forward): se presenta cuando por ejemplo creamos un nuevo branch desarrollo a partir del branch master y agregamos cambios en este nuevo branch. Luego cuando vamos a hacer el merge del branch desarrollo a master, si master permanece sin ningún cambio, se producirá un avance rápido. Solo se añadiran los nuevos commits presentes en el branch desarrollo y no se generará ningún commit adicional.


• Merge de tres vías (3-way): siguiendo el ejemplo de crear un branch desarrollo a partir del branch master. Imaginemos que se existen nuevos commits en master al momento de querer hacer el merge del branch desarrollo, git se encarga de hacer la unión y se va a ver reflejado en un nuevo commit que por defecto tiene como mensaje similar a "Merge branch 'desarrollo'".


• Merge con conflictos: cuando se presenta un merge con conflictos por resolver, siempre se crea un nuevo commit que representa la solución de los conflictos.

Si quieres ampliar la información y verla de manera gráfica, puedes visitar el siguiente enlace.

Desde que aprendí el truco para mostrar el branch actual de git en el terminal de Linux, siempre lo uso cuando configuro cada nuevo entorno.

Es súper fácil, solo editar el siguiente archivo:

nano ~/.bashrc

Y copiar al final de todo lo siguiente:

mostrar_git_branch() {
     git branch 2> /dev/null | sed -e '/^[^*]/d' -e 's/* \(.*\)/ (\1)/'
}
export PS1="\u@\h \[\033[32m\]\w\[\033[36m\]\$(mostrar_git_branch)\[\033[00m\] $ "

Reiniciar la terminal y listo. Debe verse de la siguiente forma:

~/git_hacks (master) $

Podemos cambiar el color del branch sustituyendo el código [36m\], por el código correspondiente al color:

• Negro [30m\]
• Rojo [31m\]
• Verde [32m\]
• Amarillo [33m\]
• Azul [34m\]
• Magenta [35m\]
• Cyan [36m\]
• Blanco [37m\]

Referencias:

• https://sujipthapa.co/blog/git-pro-tip-show-your-branch-on-linux-ubuntu-terminal
• http://dvtprueba.blogspot.com/2014/10/linux-y-git-mostrar-el-branch-actual-en.html

Podemos lograr ser más eficientes si añadimos unos simples parámetros al ya conocido git log. Existen muchas opciones para usar, a continuación te muestro algunas de las más útiles.

Para obtener de manera resumida los commits con su hash corto usamos --oneline:

git log --oneline

b19d32b (HEAD -> master) Merge branch 'desarrollo'
71bfbc7 (desarrollo) Se agrega formulario
e68d063 Se agregan nuevos modelos
7c9ba01 Se amplía la funcionalidad
8c83c8c Fix de nueva funcionalidad
bcefff1 Se agrega nueva funcionalidad
45668ae Primer commit

Podemos ver de forma gráfica el historial de commits añadiendo --graph:

git log --oneline --graph

*   b19d32b (HEAD -> master) Merge branch 'desarrollo'
|\  
| * 71bfbc7 (desarrollo) Se agrega formulario
* | e68d063 Se agregan nuevos modelos
|/  
* 7c9ba01 Se amplía la funcionalidad
* 8c83c8c Fix de nueva funcionalidad
* bcefff1 Se agrega nueva funcionalidad
* 45668ae Primer commit

Es posible ver que archivos forman parte de cada commit con --stat:

git log --stat

commit 7c9ba0196ac53c706bd7caa465c489fc0bd501b1
Author: LCI
Date:   Fri Jun 5 22:35:11 2020 -0300

    Se amplía la funcionalidad

 index.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

Si queremos ver exactamente que cambios se hicieron podemos usar -p:

git log -p

commit 7c9ba0196ac53c706bd7caa465c489fc0bd501b1
Author: LCI
Date:   Fri Jun 5 22:35:11 2020 -0300

    Se amplía la funcionalidad

diff --git a/index.js b/index.js
index 40fcb78..529c767 100644
--- a/index.js
+++ b/index.js
@@ -1,3 +1,3 @@
 Primera línea
-Segunda línea
+Segunda línea se cambia
 Tercera línea

Podemos filtrar los últimos n commits agregando -n (número de commits):

git log --oneline -2

b19d32b (HEAD -> master) Merge branch 'desarrollo'
71bfbc7 (desarrollo) Se agrega formulario

Es posible buscar los commits que coincidan con una descripción agregando --grep="texto":

git log --oneline --grep="formulario"

71bfbc7 (desarrollo) Se agrega formulario

También se puede buscar dentro de las modificaciones de contenido de los archivos con -S "texto":

git log --oneline -S "se cambia"

7c9ba01 Se amplía la funcionalidad

Si queremos buscar los commits donde se encuentra un archivo se agrega -- archivo:

git log --oneline -- form.js

71bfbc7 (desarrollo) Se agrega formulario

Existen más opciones que podemos añadir al comando git log, si quieres leer más puedes ir a este link.