DEV Community: Marcelo Andrade R.

Como trabajo

Marcelo Andrade R. — Tue, 14 Jun 2022 17:16:35 +0000

He trabajado de forma remota por casi 9 años y al principio como en todo cambio traté de hacer las cosas de la misma manera que se hace en presencial, tener un horario de 9 a 18, asistir a reuniones, pedir permiso para salir del trabajo, etc. etc. Pero luego de este tiempo he cambiado muchas cosas y vale la pena compartir la forma en la que trabajo en la actualidad.

Me pareció interesante un documento que encontré en la web de Tom Willmot - CEO de Human Made así que voy a hacer un fork de este documento y adaptarlo a mi realidad.

Descripción de mi rol

Trabajo como Ingeniero de Software / Consultor de Tecnología para algunos clientes nacionales e internacionales.

Mis responsabilidades

Dependiendo del cliente con el que tengo un contrato activo tengo diferentes responsabilidades, entre las que están:

Diseñar y crear software de calidad para el manejo de los procesos de negocio de mis clientes
Mantener los servicios funcionando para que no haya interrupciones en el trabajo de los usuarios de los sistemas
Estar al día en actualizaciones de los sistemas para evitar incidentes de seguridad
Dar soporte de las aplicaciones que soy responsable
Dar mi opinión acerca de consultas de parte de mis clientes en el área de tecnología
Presupestar nuevos desarrollos

Como trabajo

Este es un documento vivo en el que indico mi forma de trabajar, si has trabajado conmigo y este documento no refleja tu experiencia dejame saber para actualizarlo.

Cuando trabajo

Usualmente trabajo de Lunes a Viernes y casi nunca en fin de semana. Hago 2 o máximo 3 secciones en los días de trabajo, la primera sección es de 6:30 a 8:00 y la segunda sección de 9:00 a 13:00, hay veces que tengo trabajo extra o estoy en medio de un proyecto con fecha límite, ahí uso la tercera sección de 21h00 a 22h30.

Todos las horas son UTC-5 hora Ecuador continental. Los tiempos intermedios son para asuntos personales y familiares y generalmente no contesto durante estos períodos.

Es posible que ciertos días tenga que tomar citas médicas o cosas que no puedo aplazar en las secciones de trabajo. Haré saber a las personas con las que estoy trabajando directamente.

Donde trabajo

Desde un oficina en casa compartida con mi esposa e hijas, vivo en Quito, Ecuador.

Como trabajo

Mi día a día es generalmente 1 o 2 reuniones planificadas máximo a la semana, y el resto del tiempo lo dedico al desarrollo de software, operación de los servicios y al aprendizaje de nuevas tecnologías.

Lo más importante para mí es entender la necesidad del cliente para realizar un nuevo requerimiento o cambio en los procesos para poder entregar la mejor solución posible en el menor tiempo.

Las tareas pendientes que tengo en su mayoría tienen un lugar para vivir, si son cambios o requerimientos dependiendo del cliente pueden vivir en jira o trello. Y las consultas y soporte en la bandeja de entrada de mi correo electrónico. Trato de tener un Inbox Zero así que todo lo que está en mi inbox necesita mi atención.

Comunicaciones

Trato de comunicarme de la mejor manera, pongo especial énfasis en la comunicación escrita, ya que al trabajar remoto, la mejor manera de compartir información es de forma asíncrona y escrita.

Mis canales de comunicación instantánea están siempre abiertos. Con los clientes internacionales casi siempre es Google Chat o Slack, y para los nacionales WhatsApp.

En mi teléfono no tengo notificaciones audibles, así que solo veré las notificaciones cuando tome el teléfono. Cuando estoy frente a mi laptop si tengo las notificaciones activadas.

Siempre prefiero un email a una reunión.

Si yo inicio la comunicación escrita no espero una respuesta inmediata a menos que lo indique, pueden responder cuando estén listos, pero voy a recordarles de responder en un tiempo prudencial si no he tenido una respuesta.

Prefiero comunicación escrita por las siguientes razones:

Porque tengo registro de los intercambios
Puedo reflexionar y pensar mejor mis respuestas.

Solo si la conversación no está llevando a nada haremos una reunión virtual y aclararemos las cosas.

Cancelar reuniones o llamadas

Trato de no cancelar de último momento a menos que sea una emergencia y espero lo mismo de los demás.

Redes Sociales

Tengo cuentas en la mayoría de sitios, pero no publico mucho. Facebook para mis redes personales. Twitter y LinkedIn para profesionales.

Cosas que amo

Amo a mi familia, la principal razón para seguir adelante.

Me gusta solucionar problemas. Aprender de diferentes industrias y tecnologías. Conocer gente interesante. Salir a caminar en el campo. Leer. Escribir cada semana. Ver buenas series.

Newsletter #53

Marcelo Andrade R. — Thu, 09 Jun 2022 16:24:32 +0000

Hey, I've been writing weekly for a while, if you'd like to subscribe to my newsletter, it's in spanish but I can start writing in English soon depending on demand:

ConvertKit Public Page

Last publication:

🎨 DevTools, Design Systems y más

Creating a shark with a serverless function

Marcelo Andrade R. — Tue, 07 Jun 2022 17:43:38 +0000

There is a new challenge from Digital Ocean, it was easy to complete, I choose to create the function from the control panel and was super easy to setup with PHP and just calling the API with curl.

You can see my robot shark called Marcelo in the aquarium

Generando datos de prueba rapidamente

Marcelo Andrade R. — Thu, 17 Mar 2022 16:45:00 +0000

Durante las pruebas manuales, muchas veces se necesita ingresar datos de prueba en los formularios de los sistemas en los que trabajo. La carga mental de estar programando y probando generalmente afecta el pensar nuevos datos randómicos para datos de pruebas, y lo más fácil es usar datos ya predefinidos como "asdf", "qwerty", "test1", "test2", pero encontré una manera más fácil de generar estos datos.

La práctica que me ha ayudado a agilizar esta parte del proceso de prueba manual es usar 2 herramientas, la una es un expansor de texto, la idea de este tipo de herramientas es minimizar el tipeado de información al usar shortcuts cuando se escribe algo, por ejemplo, si en tus emails siempre saludas o te despides con el mismo texto, puedes configurar al expansor para que al ingresar :saludo se auto expanda a Hola, Te saluda Marcelo ahorrandote tiempo y energía. Para esta parte uso espanso es multiplataforma y muy fácil de instalar y configurar.

Para la segunda parte uso un generador de datos falsos faker es una librería de PHP que permite generar datos de prueba, hay librerías simlares para otros lenguajes, pero esta me queda bien porque puedo instalarla como librería global con composer usando composer global require fakerphp/faker luego puedo usar directamente en la línea de comandos con: php -r "require_once '/home/marcelo/.config/composer/vendor/autoload.php'; echo Faker\\Factory::create()->firstName();" cada vez que ejecuto este comando me da un nuevo primer nombre.

Ahora al unir ambas tengo este tipo de definición en la configuración de espanso:

Cada vez que digito :fn en cualquier aplicación, se autoexpande a un nombre aleatorio, lo mismo con :ln en cualquier aplicación, se autoexpande a un apellido aleatorio, y de igual manera para :city, :state, :address, :zip.

Revisando la documentación de faker puedes agregar aún más shortcuts a espanso.

Pub/Sub con Redis

Marcelo Andrade R. — Mon, 07 Mar 2022 12:27:53 +0000

Durante esta semana tuve que hacer refactoring de una parte del sistema en el que trabajo tenemos un portal de cliente en el que los usuarios pueden seleccionar reportes a descargar y se genera un pdf o un zip con toda la información equerida.

El problema era que estos reportes pueden llegar a ser bastante grandes y estaban dando timeouts al generarlos online durante el request HTTP, dejando a los usuarios en espera con una pantalla en blanco sin saber cual fue el error cuando falla.

Hicimos algunas optimizaciones para generar el reporte más rápido pero aún así podía demorar algunos minutos, queríamos hacer algo que no le deje al usuario sin feedback, ya teníamos la opción de poner la generación de este reporte en una cola para que sea consumida por unos procesos en background, pero el usuario no sabía que estaba haciendo el sistema durante su espera hasta recibir el email de que el reporte ha finalizado.

Así que decidimos siempre generar los reportes en background, pero dándole al usuario un monitoreo del proceso mientras se genera. Para esto investigue las opciones existentes para mostrar mensajes generados durante el proceso de creación del reporte. La opción que mejor se acoplaba era enviar mensajes desde el servidor web usando SSE (Server Sent Events) de tal forma que no se necesite hacer demasiados requests haciendo polling, pero hubo que hacer algunas configuraciones en nginx para no hacer buffering de la respuesta de la aplicación pero una vez hecho eso, desde el front end se crea un EventSource y en cada mensaje se muestra información en pantalla. Primera parte resuelta, pero ya que el proceso que está generando el reporte no tiene forma de comunicarse con el servidor
para mostrar el porcentaje de avance se necesita un middleman para emparejar ambos, es aquí donde necesitaba un sistema PUB/SUB (Publisher/subscriber). Si hubiera estado usando postgres esto ya lo tiene resuelto, usando LISTEN and NOTIFY. Pero como usamos mariadb en este proyecto hubo que agregar un nuevo componente al sistema.

El componente fue redis, sabía de este pero no lo había usado antes, es un almacenamiento en memoria de diferentes estructuras de datos, se puede usar como base de datos, cache o broker de mensajes.

La característica que estamos usando en este momento se llama Pub/Sub , y lo que permite es publicar mensajes a un canal específico y otros procesos pueden suscribirse a escuchar mensajes de un canal o canales que le interesa.

Para implementarlo simplemente agregue redis como dependencia en mi docker-compose.yml e instale el paquete php-redis para poder tener las clases que me permitan conectarme al servidor de redis, una vez hecho eso el código es bastante simple, en la clase que maneja los procesos de background simplemente se hace un $redis->publish('job_1', "Iniciando reporte"); y en el controller que maneja los SSE se hace un $redis->listen(['job_1'], fn ...); donde fn es el callback que se llama cada vez que se envía un nuevo mensaje al canal denominado job_1, este nombre de canal es dinámico.

Este sistema ha estado trabajando muy bien desde la puesta a producción, el consumo de memoria de redis tampoco es elevado, le puse 1GB de RAM pero solo consume 3 MB.

¿Por qué? la mágica pregunta al desarrollar software

Marcelo Andrade R. — Wed, 16 Feb 2022 12:43:46 +0000

Cuando el negocio nos solicita un requerimiento, generalmente
como técnicos tendemos a empezar la solución de este
lo antes posible, tal vez preguntemos acerca de
quienes lo van a usar, que información necesitamos
guardar para luego usar en reportes, los permisos que deberá
tener, y empezamos a validar en nuestra mente la mejor manera
de desarrollarlo en el sistema, pero una pregunta importante que muchas veces
no hacemos y que deberíamos hacer frecuentemente es:

¿Por qué?

¿Por qué se necesita aumentar un campo a un formulario?
¿Por qué es necesario ejecutar un reporte cada cierto tiempo?
¿Por qué mover un botón a otra parte de la pantalla?
¿Por qué enviar un nuevo correo electrónico al cliente luego de una acción?
¿Por qué debemos capturar el tráfico de un sitio web?
¿Por qué Inserte aquí el requerimiento?

Esto nos permite tener una perspectiva diferente, poder conocer
las razones del negocio para solicitarlo, nos ayuda
a entender de mejor manera los objetivos que se quieren lograr
con el requerimiento, el poder no solo pensar desde el punto de
vista técnico sino como parte de la empresa.

Al principio es posible que no obtengamos la respuesta que
queremos, es posible que nos den una respuesta vaga como:
mejorar la experiencia de usuario, pero no debemos quedarnos ahí
debemos usar la técnica de los 5 ¿Por qué?
debemos encontrar la raíz del requerimiento, para así tener
la mejor forma de medir si un requerimiento va a cumplir o no
el objetivo del negocio.

Muchas veces el lado del negocio solo piensa que como técnicos
solo debemos dedicarnos a ese sector y no opinar acerca
de posibles alternativas que pueden ayudar a conseguir
el objetivo planteado. Y como técnicos no solo debemos
entrenarnos en los últimos frameworks, o lenguajes o aplicaciones
sino también y tal vez en mayor medida en aprender
cómo funciona la empresa, cómo hace dinero, a quién servimos,
qué esperan los clientes de la empresa, etc. De tal forma
que seamos los coadyuvantes del mejoramiento de la empresa
en su totalidad no solo del departamento de tecnología de información.

Una vez que conocemos los objetivos y también tenemos una
mayor comprensión del negocio, podemos dar nuestra opinión
acerca de las mejores opciones de solución, muchas veces la solución no
es cambiar los sistemas, puede ser necesario cambiar
procesos internos, o contratar software o servicios de terceros,
o incluso dejar de hacer cosas que no contribuyen a fortalecer los objectivos
de la empresa.

Aplicaciones web ambiciosas con Ember.js

Marcelo Andrade R. — Thu, 24 Jun 2021 14:47:06 +0000

Cuando se trata de crear aplicaciones de página única o SPA en inglés,
como desarrolladores tenemos muchas opciones de dónde escoger
hay frameworks y librerías muy conocidas como angular en el área de framework
y vue | react en el área de librería.

Hoy quiero hablarles de un framework no muy usado o conocido
pero que merece ser mencionado: Ember.js. He trabajado
con este framework por al menos 6 años, y la forma en la que llegué a este
fue un poco graciosa, en ese tiempo estaba dando los tests para entrar
a la comunidad de freelancers Toptal uno
de los pasos era realizar un pequeño proyecto y para esto escogí Ember.js y PHP en el backend
lo escogí como para aprender, había trabajado en el pasado con knockout.js, angular js,
backbone y por supuesto jQuery; pero quería algo que realmente ayudara en la productividad,
luego de ser aceptado en Toptal, la primera entrevista con un cliente era
para llenar un puesto para trabajar con Ember, en principio dude en aplicar
porque solo lo había aprendido para hacer este test, pero el reclutador me
animó y la entrevista fue muy bien y desde entonces estoy trabajando con este cliente
con 4 aplicaciones internas grandes hechas en Ember.

Una de los principios de Ember.js es que la evolución no debe ser drástica,
como en el caso de angular que hubo un re-write del framework y los que crearon
una app con angular js no pudieron pasar directamente a angular v2, la idea
de Ember era siempre hacer las transiciones de versiones lo más seguras
y fáciles posibles, para esto proveen con muchas herramientas, como deprecations
para que desde una versión anterior comiencen a notarse los cambios que se activarán
en las versiones posteriores y que alertan a los desarrolladores para cambiar el código de la aplicación
para una futura actualización sin novedades, también existen codemods
para que los cambios se hagan automáticamente, e incluso hay feature flags que
permiten probar características que saldrán públicas en futuras versiones
en versiones anteriores.

El framework ya lleva 10 años con una comunidad pequeña pero
con gente de mucha calidad y muy abierta e inclusiva. En cuestión de paquetes disponibles
para la comunidad hay una gran variedad, puedes chequear Ember Observer
donde se registran todos los addons que tienen compatibilidad con Ember.

Como ejemplos de aplicaciones públicas desarrolladass con Ember están LinkedIn, Heroku, Intercom, Square.

En cuestiones un poco más técnicas, el framework tiene muchas opiniones en su diseño
tal vez para muchos esto no es bueno, para mi es fantástico, no tienes que tomar decisiones
de qué usar cada 5 minutos, porque como comunidad ya se hizo esta decisión a travez
de procesos denominados RFC en github para realizar cambios. La estructura de las aplicaciones
es estándar, si has trabajado en una app ember, puedes trabajar en otra muy rápidamente
porque sabes dónde está y cómo funciona todo.

La URL en aplicaciones ember es tratada como una parte fundamental, ya que de la misma se puede derivar
el ruteo, estático y dinámico, y adicional parametros de consulta. Es el punto de entrada
hacia las rutas de la aplicación que a su vez manejan el modelo de datos que es transferido hacia
los templates que usan componentes para mostrar y manejar la interfaz al usuario.

Se puede hacer Test Driven Development muy fácilmente con tests unitarios para cada componente o utilidad
y tests e2e para ejecutar caminos complejos de interacciones de usuario.

Si a alguien le interesa más detalles de cómo funciona el framework, suscríbanse y dejenme saber.

Debería aprender PHP o está de bajada?

Marcelo Andrade R. — Thu, 17 Jun 2021 13:43:20 +0000

He escuchado muchas veces la pregunta si debería o no un nuevo programador o ingeniero salido de la universidad aprender PHP. La respuesta como todo en la vida, depende. Depende especialmente de hacia dónde quiera dirigir su carrera esta persona.

En el ambiente empresarial siempre hay un sentimiento de desprecio hacia el lenguaje PHP, y un tinte de superioridad hacia lenguajes más usados en estas instituciones como java o C#. Es verdad que desde hace mucho tiempo hasta las versiones 4 o 5 de PHP, realmente PHP tenía muchas "características" que no lo hacían ver bien en el ambiente empresarial, hacía conversiones automáticas de tipos de datos, si sumabas cadenas y números "asumía" lo que querías hacer y simplemente convertía la cadena a número y luego sumaba, es un lenguaje dinámico, hasta cierto punto demasiado dinámico para muchos gustos. Pero este lenguaje ha ido evolucionando bastante, se tiene soporte muy extendido de programación Orientada a Objetos y también Funcional, pero no se puede negar que aún con estas nuevas características un mal programador aún puede crear programas "Frankensteins" en este, usando código procedural, mezclando html con php para generar páginas dinámicas, etc.

Así que si la ídea es trabajar en empresas, PHP tal vez no sea la mejor recomendación para aprender.

Tampoco podemos tapar el sol con un dedo y disminuir todo lo que es posible hacer con PHP. Con el 79% del mercado de sitios web usando PHP, tampoco es que le va a faltar trabajo si se orienta la carrera hacia negocios en la web. Entre las grandes empresas de tecnología que usan PHP en alguna parte de su "stack" están Facebook, Slack, Wikipedia, entre otras. Muchos negocios pequeños también tienen su nido en la web a través de Wordpress, Drupal o Joomla que son CMS desarrollados en PHP.

PHP tiene mucahs ventajas, entre ellas por ejemplo a la hora de desplegar sitios web o applicaciones web en Internet, la mayoría de las empresas de hosting hacen muy fácil poner una aplicación PHP en sus servidores a través de subir archivos via sFTP o SCP, no lo recomiendo pero así se empieza. También se puede usar con muchas bases de datos, en la web las preferidas son mysql y postgres, pero de ser necesario también se puede conectar con bases oracle o sql server. El flujo de trabajo en PHP es muy rápido, pienso, hago el cambio en el archivo y hago f5 en el browser y ya puedo ver el cambio.

Ahora también hay muchos frameworks que van a evitar que te dispares en tu propio pie a la hora de hacer una aplicación PHP, mi recomendación es aprender el lenguaje tratar una aplicación pequeña en PHP puro (que no vaya a ponerse en producción) y luego aprender un framework de desarrollo PHP como symfony o laravel aparte de proveer mucha funcionalidad estos frameworks permiten mantener una aplicación ordenada y bien separada cada capa de programación.

Otra recomendación es leer este sitio web PHP The Right Way por favor la versión en Inglés porque la de español está bastante desactualizada. Este informa bastante bien cómo trabajar con PHP de una forma sensata y ordenada para evitar sorpresas.

Conclusión

Al final la decisión es propia y es cuestión de gustos. En mi caso al inicio de mi carrera luego de la universidad use PowerBuilder, java y tecnologías Microsoft, pero una vez que hice el cambio a PHP se abrieron muchas puertas, especialmente en el exterior por lo que si aprendes PHP recomendaría también aprender Inglés.

Gracias por llegar hasta aquí, ayúdame llenando esta encuesta, me gustaría saber en qué lenguaje trabajas

Usando transacciones en bases de datos

Marcelo Andrade R. — Thu, 27 May 2021 12:40:43 +0000

Al escribir la lógica de una aplicación que interactúa con una base de datos relacional
para almacenar la información, generalmente se puede tener varios
pasos para guardar cada pedazo en un lugar específico de la base, las bases de datos denominadas
ACID tienen una herramienta poderoza para evitar inconsistencias de datos
hoy nos concentraremos en la A de ACID Atomicidad.

Por ejemplo cuando se crea una factura, no solo se guarda como un documento en la base,
se tiene varias tablas como: factura, detalle_factura, inventario, producto, etc. Al enviar la información
desde la interfaz de usuario hacia la aplicación podemos tener una sola estructura con todos los
datos necesarios para crear la factura, pero a nivel de aplicación debemos analizar esa estructura
y leerla para que cada parte se guarde en una tabla específica de la base de datos, de tal forma
que tendremos un registro para factura con los datos de la cabecera, varios registros de detalle_factura
y adicionalmente se debe modificar las cantidades de los productos en el detalle del inventario de cada producto.

Si tomamos la vía rápida de hacerlo todo esperando que nada falle, tendremos código cómo:

<?php

// ... solo el código que interesa para el ejemplo
$factura = new Factura($datosDeFactura);
$factura->save();
foreach ($detalleDeFactura as $detalle) {
    $detalle = new DetalleFactura($detalle);
    $detalle->factura = $factura;
    $detalle->producto = Producto::findOrFail($detalle['producto_id']);
    $detalle->save();

    $inventario = new Inventario($detalle);
    $inventario->producto = Producto::findOrFail($detalle['producto_id']);
    $inventario->save();
}

Como podemos ver estamos usando algún tipo de ORM en el que creamos los objetos con datos y guardamos cada uno,
el problema sucede si digamos en la estructura de datos enviada, uno de los producto_id no está en la tabla de productos.
De tal forma que si enviamos una lista con 3 productos y el último id no está definido, en este código se creará
una factura con 2 detalles y 2 afectaciones a inventario, en el último producto el sistema dará un fallo y no podrá
seguir, pero en la base de datos ya se escribió parte de la información.

Para solucionar este gran inconveniente debemos usar una herramienta que todas las bases de datos relacionales
tienen, TRANSACCIONES.

A nivel de base de datos desde un cliente por ejemplo, es fácil comenzar una transacción con el comando:

BEGIN;

Luego se puede hacer varias operaciones de lectura y/o escritura:

INSERT INTO `factura` (numero, fecha, estado) 
VALUES ('001-001-1000', '2021-05-27', 'Facturada');

INSERT INTO `detalle_factura` (item, producto_id, cantidad, precio) 
VALUES ('1', 2000, 1, 500);

Al final se puede decidir si guardo todos los cambios o regreso al estado original antes de enviar el comando BEGIN. Si deseo escribir
uso el comando COMMIT, si quiero descartar todos los cambios uso el comando ROLLBACK.

COMMIT;
--- o 
ROLLBACK;

Esto nos asegura que en el COMMIT todas las operaciones realizadas se ejecutan como una sola operación o no se ejecuta nada,
a esto se le llama ATOMICIDAD.

En nuestro ejemplo de php, se puede implementar de varias formas, pero la que normalmente uso es hacer un try catch.

<?php

// ... solo el código que interesa para el ejemplo

try {
    $conexionBd->begin();

    $factura = new Factura($datosDeFactura);
    $factura->save();
    foreach ($detalleDeFactura as $detalle) {
        $detalle = new DetalleFactura($detalle);
        $detalle->factura = $factura;
        $detalle->producto = Producto::findOrFail($detalle['producto_id']);
        $detalle->save();

        $inventario = new Inventario($detalle);
        $inventario->producto = Producto::findOrFail($detalle['producto_id']);
        $inventario->save();
    }

    $conexionBd->commit();
} 
catch (\Exception $e)
{
    $conexionBd->rollback();
    throw $e;
}

Agregando estas líneas de código estamos asegurando que la factura se crea con los 3 productos enviados, o no se crea la factura, y
la integridad de los datos está asegurada sin datos basura en la base.

Encontrando errores en el código con git bisect

Marcelo Andrade R. — Tue, 18 May 2021 12:29:17 +0000

Cuando se usa git en un equipo de trabajo a veces alguien del grupo puede introducir un error en el código que no fue descubierto por los tests ni en la revisión de usuario, y se publica el error al sistema de producción. El momento que se recibe el reporte del error en producción generalmente desde el último despliegue hay varios commits hechos por varios desarrolladores, para encontrar dónde se introdujo el error podemos usar git bisect.

git bisect de acuerdo a su documentación nos indica que realiza una búsqueda binaria para encontrar el commit que introdujo un bug. Una búsqueda binaria es un algoritmo en el que se va reduciendo la búsqueda de un commit eliminando posibles commits "buenos" o "malos".

La búsqueda de nuestro bug de ejemplo puede comenzar de la siguiente manera:

git bisect start # Permite iniciar la búsqueda
git bisect bad   # Indica que la versión actual es la incorrecta
git bisect good 4f0dfa72bcdc2ba489629949883392aaa3a4e43b   # Es la referencia al último commit correcto puede ser un tag on un branch

Una vez que tenemos al menos un commit bueno y uno malo, git bisect seleccionara un commit en el medio del rango para verificación. Nos mostrará un mensaje que indica el commit que está en el área de trabajo cuantas revisiones quedan por hacer y un estimado de pasos hasta encontrar el error.

Cuando estemos en este paso tenemos que verificar el error existe en ese commit, si no existe, ejecutamos git bisect good y git bisect nos dará un nuevo commit para probar. En este paso podemos ejecutar tests, probar manualmente, ejecutar algún proceso que verifique si hay no error o simplemente ver el código. Si es un commit malo se ejecuta git bisect bad hasta que git bisect indique el mensaje que un commit es el primer bad commit (first bad commit).

Al final de la sesión de trabajo se ejecuta git bisect reset para volver al branch que estuvimos inicialmente.

Hay también una forma automática de verificar si un commit es válido, usando git bisect run your_script arguments. El script denominado your_script debe retornar un código de salida 0 para marcar un commit como bueno, y un código entre 1 y 127 (exceptuando 125) cuando el commit es malo. El 125 se usa para cuando no se puede probar y lo marca como skipped.

Si hay alguna duda, por favor no duden en suscribirse y responder directamente a mis emails.

Verificar rangos de fechas en PostgreSQL

Marcelo Andrade R. — Sat, 08 May 2021 22:13:58 +0000

Mi motor de base de datos favorito para proyectos nuevos es PostgreSQL o postgres. Es una base muy solida, open source, con más de 30 años de desarrollo, se ha ganado una gran reputación por su confiabilidad, robustez y desempeño.

Hoy les quiero compartir un pequeño tip que me ha servido mucho en un par de proyectos, en los cuales se requiere mantener un registro de datos históricos y que no debe haber superposición de un valor en un mismo rango de fechas. Por ejemplo, el valor del IVA generalmente es fijo, pero hubo un tiempo en que cambió. Una tabla para manejar estos cambios en el tiempo sería de la forma:

create table historico_iva(
    id serial,
    empresa_id integer not null,
    desde date not null,
    hasta date null,
    porcentaje_iva numeric(10,2)
)

Esta validación de datos se podría realizar a nivel de aplicación al verificar que no haya 2 valores de IVA para la misma fecha, por ejemplo digamos que el 1 de junio cambia el valor al 10% en la tabla habría los siguientes registros:

id	empresa_id	desde	hasta	porcentaje_iva
1	1	2000-01-01	2021-05-31	12
2	1	2021-06-01	null	10

Para buscar que valor de iva debo aplicar en una fecha específica puedo usar la consulta:

select porcentaje_iva 
from historico_iva 
where empresa_id = 1 
and current_date between desde and coalesce(hasta, 'Infinity')

Esta debe devolver siempre un solo valor, pero por cualquier error de programación o al editar datos en la base directamente en el registro 2 le pongo 2021-05-31 en la fecha desde, el día 31 de mayo no se sabría si fue 10 o 12 el IVA ya que la consulta devuelve 2 valores. O también que la fecha desde sea mayor a la fecha hasta en cuyo caso nunca retornaría un valor.

Para evitar este inconveniente se puede agregar un par de checks a nivel de base de datos, y para esto postgres ayuda mucho con una extensión para manejo de este tipo de validaciones denominada btree_gist.

Para nuestro ejemplo se debe agregar los siguientes CHECKs en la tabla:

--- activa la extension btree_gist
CREATE EXTENSION btree_gist;

--- verifica que la fecha desde sea menor a la fecha hasta
ALTER TABLE porcentaje_iva 
    ADD CHECK ( "desde" < "hasta");

-------- evita superposición de rango de fechas en una misma empresa
ALTER TABLE porcentaje_iva 
    ADD CONSTRAINT no_sobreponer_fechas_iva 
        EXCLUDE USING GIST (
            empresa_id WITH =,
            daterange("desde", coalesce("hasta", 'Infinity'), '[]') WITH &&
        );

Esto implica que al tratar de crear un registro de la misma empresa, que tenga fechas sobrepuestas
la base de datos no lo va a permitir y generará un error.

Cómo utilizar symplify/vendor-patches en proyectos php?

Marcelo Andrade R. — Fri, 30 Apr 2021 13:59:03 +0000

Es posible que alguna vez hayan encontrado un bug en una dependencia de un proyecto de php que utiliza composer, y el arreglo es simple y lo único que se requiere es cambiar 1 o 2 líneas de código en el paquete referenciado es decir en /vendor/usuario/paquete-con-error.

Como buen ciudadano del mundo open source, lo primero que se debe hacer es abrir un issue y crear un pull request con los cambios en el proyecto dependencia para que el dueño lo pueda aceptar y se arregle para todos los usuarios de ese paquete, pero no vamos a negar que este proceso toma bastante tiempo, y si necesitamos arreglar lo más pronto hay otras opciones.

Puedes crear un fork del proyecto en tu github y usar ese url de github en la version de composer.json, pero estarías tomando una responsabilidad manual de actualizar y aplicar el cambio cada vez que haya actualizaciones. Se puede copiar el paquete localmente que es más rápido pero con esto ya no hay actualizaciones.

O la mejor opción se puede usar "composer patches".

Hace un tiempo estaba trabajando en un proyecto laravel con el paquete de administración nova, y un addon para manejo de archivos infinety-es/nova-filemanager el paquete funcionaba muy bien con archivos públicos, pero para mi proyecto necesitaba guardar los archivos en un bucket privado de S3 y para descargarlos debía generar una url temporal con un tiempo de expiración máximo.

Analizando el código del paquete encontré 2 lugares donde se generaba la url del archivo para descarga en el archivo fuente src/Http/Services/NormalizeFile.php en la función toArray y en la función getImage lo único que había que hacer es realizar el siguiente cambio:

--- /dev/null
+++ ../src/Http/Services/NormalizeFile.php
@@ -50,7 +50,7 @@
             'mime' => $this->getCorrectMimeFileType(),
             'path' => $this->storagePath,
             'size' => $this->getFileSize(),
-            'url'  => $this->cleanSlashes($this->storage->url($this->storagePath)),
+            'url'  => $this->cleanSlashes($this->storage->temporaryUrl($this->storagePath, '+5 minutes')),
             'date' => $this->modificationDate(),
             'ext'  => $this->file->getExtension(),
         ]);
@@ -145,7 +145,7 @@
     private function getImage($mime, $extension = false)
     {
         if (Str::contains($mime, 'image') || $extension == 'svg') {
-            return $this->storage->url($this->storagePath);
+            return $this->storage->temporaryUrl($this->storagePath, '+5 minutes');
         }

         $fileType = new FileTypesImages();

Cómo se cambia esas 2 líneas en /vendor?

Se hace en 4 simples pasos:

Instalar el paquete que controla los parches

composer require cweagans/composer-patches symplify/vendor-patches --dev

Se crea una copia del archivo a cambiar en /vendor por la extensión .old

Por ejemplo en mi caso cambie vendor/infinety-es/nova-filemanager/src/Http/Services/NormalizeFile.php a
vendor/infinety-es/nova-filemanager/src/Http/Services/NormalizeFile.php.old

Abrir el archivo original vendor/infinety-es/nova-filemanager/src/Http/Services/NormalizeFile.php y realizar los cambios necesarios. Se verifica que los cambios funcionen ya que solo el archivo *.php funciona no el *.php.old.
Generar el parche usando el comando:

vendor/bin/vendor-patches generate

La herramienta de symplify genera todos los parches en el directorio /patches/:

ls -l patches
.rw-r--r-- 883 marcelo 30 Apr  7:16 infinety-es-nova-filemanager-src-http-services-normalizefile-php.patch

Y también genera la configuración de parches al composer.json:

    ...
    "extra": {
        "laravel": [],
        "patches": {
            "infinety-es/nova-filemanager": [
                "patches/infinety-es-nova-filemanager-src-http-services-normalizefile-php.patch"
            ]
        }
    },
    ...

Y eso es todo, la siguiente vez que realicen composer install, el parche se aplica automáticamente.

Referencias:

How to Patch a Package in Vendor, Yet Allow its Updates | Tomas Votruba