Depura DotLiquid de forma local en VS Code

Desarrolladores de Logic Apps, ¡alégrense —o al menos dejen de maldecir! Una nueva extensión de VS Code depura plantillas DotLiquid localmente con el motor exacto que usa Azure. Por fin.

El depurador de DotLiquid para VS Code pone fin a la pesadilla de Liquid en Logic Apps — theAIcatchup

Key Takeaways

  • La coincidencia exacta con el motor DotLiquid elimina las conjeturas en los despliegues de Logic Apps.
  • Renderizados en menos de 100 ms y depuración paso a paso exponen las cadenas de filtros al instante.
  • Ahorra horas en transformaciones de plantillas B2B —adiós a los bucles de espera en la nube.

Estás hasta el cuello en el historial de ejecuciones de Logic Apps a las 2 de la mañana, preguntándote por qué tu plantilla DotLiquid convirtió un simple pedido de ventas en XML incomprensible.

VS Code DotLiquid Debugger acaba de llegar como una vía intravenosa de cafeína. ¿La vista previa de Liquid de Shopify? Bonita, pero inútil aquí—Logic Apps Standard mastica DotLiquid, no esa variante. Los comportamientos chocan. Las plantillas brillan en la vista previa, fallan en producción. ¿Y el bucle de pruebas por defecto? Actualiza. Despliega. Espera. Entrecierra los ojos en el historial. Repite. Para manipular datos B2B, eso no es desarrollo; es tortura medieval.

¿Esta extensión? Ejecuta tus archivos .liquid localmente, usando el mismísimo motor DotLiquid 2.0.361 de Azure. Las mismas entrañas de NuGet, la misma peculiar división de enteros, los mismos filtros en minúscula-oración. Nada de simulaciones. Nada de “casi lo mismo”. Si renderiza limpio aquí, producción no morderá—en su mayoría.

Mira. He visto herramientas prometer paridad antes. No cumplen. Pero esta es una delgada piel de VS Code sobre un renderizador .NET real. Frontend en TypeScript, backend DotLiquid vía tuberías NDJSON. La primera compilación tarda (justo), ¿después? Renderizados en menos de 100 ms. De tecla a salida. Dichosos.

Por qué la depuración de Liquid en Logic Apps era un infierno puro

Presiona Ctrl+Shift+L en cualquier archivo .liquid. ¡Boom!—panel de vista previa. Se actualiza automáticamente al guardar, o por tecla (con debounce, gracias a Dios). Nada de esperas en la nube.

¿Entrada pareada? Solo suelta un .liquid.json al lado con datos de prueba. ¿No existe? Un banner te regaña para que lo crees. Inteligente.

Pero lo matador: el botón Debug. Reproducción paso a paso. Asignaciones, bucles, ifs—cada uno en el foco. La línea fuente brilla. El panel de variables vuelca el estado. ¿Vars no asignadas? Atenuadas. Obvio qué está vivo.

La barra deslizante recorre pasos. Prev/Siguiente. Salta al final. Pinpoint por qué esa var está hecha basura.

¿Cadenas de filtros? Desglose glorioso:

499.9 | Times:5 → 2499.5 | DividedBy:100 → 24.995 | Round:2 → 25.0

Filtros matemáticos (Times, DividedBy, todo eso), strings (Upcase, Replace), arrays (Split, Map)—31 cubiertos. ¿Logic Apps? Cero visibilidad. Esto aísla fallos en cadena al instante. ¿Lío de cuatro filtros? Ve la divergencia. Sin conjeturas.

¿ifs? Condiciones mostradas, check verde si se toma. Ramas no tomadas? Saltadas—refleja DotLiquid al pie de la letra. Misterio de ramas resuelto.

Las variables enlazan a líneas de asignación—clic, salta. Trozos de salida mapean de vuelta a la fuente. Clic en JSON “grandTotal”: 336.20—zap a la línea de cálculo. ¿XML? ¿JSON? ¿Texto plano? Todo bien. Nada de spew de debug hacky.

Paneles colapsables, redimensionables. Limpio.

¿Coincide esto realmente con la producción de Azure Logic Apps?

Respuesta corta: Jodidamente cerca.

Esta es la parte crítica: usa el mismísimo motor —no una simulación. No una implementación compatible. El mismo paquete NuGet, la misma versión, los mismos filtros en minúscula-oración, el mismo comportamiento de envoltura de contenido, las mismas peculiaridades de división de enteros.

Eso de la documentación. Afirmación audaz. Pero sí—subproceso .NET de larga duración, compilado a demanda, NDJSON para concurrencia. Maneja los cuatro sabores de salida de Logic Apps: JSON plano, XML, lo que sea.

¿Escéptico? Yo también. El ecosistema de Microsoft adora trampas—Shopify Liquid vs DotLiquid como prueba A. Pero esto las esquiva. Local == motor de prod. Menos despliegues. Menos sustos en la factura.

Mi hot take, no mencionada en el original: Esto evoca la era del inspector de Node. ¿Depuración JS pre-2010s? Console.logs y oraciones. Luego cayó Inspector—bienaventuranza de depuración paso a paso. Los devs de Liquid vivían en esa edad de piedra. Esto los arrastra a 2024. Predicción audaz: Espera un pico de migrantes de Shopify a Logic Apps. ¿Por qué pelear con lag en la nube si lo local es instantáneo?

¿Giro corporativo? Ninguno aquí—es open-ish, práctico. No hype. Victoria rara.

El verdadero cambio en el flujo de trabajo

Viejo modo: Ajusta plantilla. Ejecución de Logic App. Espera 30s+. Autopsia de historial. Maldecir filtros.

Nuevo: Edita .liquid. Ve render en vivo. Debug paso. Arregla cadena. Listo.

Transformaciones B2B—pedidos de ventas a facturas—florecen con esto. ¿Errores costosos? Desvanecidos.

¿Rarezas? Compilación de calentamiento. Mac Cmd+Shift+L. Menor.

¿Arrays? Los bucles brillan—paso por iteración, vars actualizan en vivo. Nada de caja negra.

¿Manipulación de strings? ¿Truncate fallido? Rastreable.

¿Bombas matemáticas—sorpresas de Modulo, Floor vs Round? Expuestas.

Usuarios de Logic Apps: Instala ya. Marketplace de VS Code, busca “DotLiquid Debugger”. Gratis. Cero excusas.

Pero espera—¿atrapa todo? Nah. Rarezas de contexto runtime (filtros custom? Nah), pero ¿90% de dolores? Clavados.

¿Y el editor inline de Logic Apps? Basura para plantillas complejas. ¿Esto? Pro.

Diviago un poco: Me recuerda el infierno de depuración temprana de Terraform. Herramientas como esta maduran ecosistemas. Microsoft, tomen nota—intégrenlo.

Por qué los devs ignoran esto a su propio riesgo

Cuello de botella aplastado.

Sorpresas en prod recortadas.

Hacks de debug obsoletos.

Si manipulas Liquid en Logic Apps—deja de sufrir.

Esto no es relleno. Es cirugía en tu flujo de trabajo.

Humor seco aparte: Por fin, una herramienta que no te dan ganas de tirar la laptop.


🧬 Related Insights

Preguntas frecuentes

¿Qué es VS Code DotLiquid Debugger?

Extensión de VS Code para depuración local de plantillas DotLiquid usando el motor exacto de Azure Logic Apps Standard. Vistas previas instantáneas, debug paso a paso.

¿Cómo depuro plantillas DotLiquid en VS Code?

Instala la extensión, abre archivo .liquid, Ctrl+Shift+L (Cmd en Mac). Agrega .liquid.json para datos, presiona Debug para pasos.

¿Funciona DotLiquid Debugger con Logic Apps?

Sí—coincide con DotLiquid 2.0.361 al pie de la letra. Filtros, rarezas, salidas alineadas para menos fallos en prod.

Elena Vasquez
Written by

Senior editor and generalist covering the biggest stories with a sharp, skeptical eye.

Worth sharing?

Get the best AI stories of the week in your inbox — no noise, no spam.

Originally reported by dev.to