Skip to content

Releases

la-liquid 1.4.0

Choose a tag to compare

@github-actions github-actions released this 27 Oct 13:32
3b3cf1c

Added

  • LQ006: an extra { at the start of an output ({{{ x }}). Logic Apps doesn't fail, but writes Liquid error: Value cannot be null. (Parameter 'input') instead of the value. Without a space after the extra brace it happens to work, which is reported as a warning. The cryptic render error is merged into this finding, at the place in the map to fix.

Downloads

Usage: see the usage guide.

Platform Executable (no .NET needed)
Windows x64 / ARM64 la-liquid-1.4.0-win-x64.zip / -win-arm64.zip
Linux x64 / ARM64 la-liquid-1.4.0-linux-x64.tar.gz / -linux-arm64.tar.gz
macOS Intel / Apple silicon la-liquid-1.4.0-osx-x64.tar.gz / -osx-arm64.tar.gz

Checksums are in SHA256SUMS.txt. With the .NET 8 or 10 SDK or runtime:

dotnet tool install --global LogicApps.Liquid.Cli --version 1.4.0   # the CLI
dotnet add package LogicApps.Liquid --version 1.4.0                 # the library

What's Changed

Full Changelog: v1.3.0...v1.4.0

la-liquid 1.3.0

Choose a tag to compare

@github-actions github-actions released this 27 Oct 13:02
0723c6b

Added

  • The tool and the library also target .NET 8. The Logic Apps extension for VS Code installs a .NET 8 SDK and puts it first in the PATH of the VS Code terminal; installing the tool there failed with "Settings file 'DotnetToolSettings.xml' was not found in the package". It now installs with .NET 8 or later.
  • The unit and conformance tests run on both .NET 8 and .NET 10.

Downloads

Usage: see the usage guide.

Platform Executable (no .NET needed)
Windows x64 / ARM64 la-liquid-1.3.0-win-x64.zip / -win-arm64.zip
Linux x64 / ARM64 la-liquid-1.3.0-linux-x64.tar.gz / -linux-arm64.tar.gz
macOS Intel / Apple silicon la-liquid-1.3.0-osx-x64.tar.gz / -osx-arm64.tar.gz

Checksums are in SHA256SUMS.txt. With the .NET 8 or 10 SDK or runtime:

dotnet tool install --global LogicApps.Liquid.Cli --version 1.3.0   # the CLI
dotnet add package LogicApps.Liquid --version 1.3.0                 # the library

What's Changed

  • Describe input file limitations as practical tips by @sahinozd in #4
  • Explain in the README why the tool was built by @sahinozd in #5
  • Feature/net8 support by @sahinozd in #6
  • Pass --framework to dotnet run now that the CLI targets two frameworks by @sahinozd in #7

Full Changelog: v1.2.1...v1.3.0

la-liquid 1.2.1

Choose a tag to compare

@github-actions github-actions released this 15 Oct 14:54
790b6ca

Maintenance release: no changes in what the tool reports.

Changed

  • The conformance tests run in en-US only, the culture of Logic Apps in Azure.
  • Documentation and examples use Central European Standard Time (Europe/Berlin) for the time zone, and describe culture differences as "a comma as decimal separator" or "a day-month culture".

Fixed

  • All ReSharper warnings: the filter methods that DotLiquid calls through reflection are marked as such, static readonly fields use PascalCase, and a broken reference in a documentation comment is fixed.
  • The one-time configuration of DotLiquid takes one lock instead of two.

Downloads

Usage: see the usage guide.

Platform Executable (no .NET needed)
Windows x64 / ARM64 la-liquid-1.2.1-win-x64.zip / -win-arm64.zip
Linux x64 / ARM64 la-liquid-1.2.1-linux-x64.tar.gz / -linux-arm64.tar.gz
macOS Intel / Apple silicon la-liquid-1.2.1-osx-x64.tar.gz / -osx-arm64.tar.gz

Checksums are in SHA256SUMS.txt. With the .NET 10 SDK or runtime:

dotnet tool install --global LogicApps.Liquid.Cli --version 1.2.1   # the CLI
dotnet add package LogicApps.Liquid --version 1.2.1                 # the library

What's Changed

Full Changelog: v1.2.0...v1.2.1

la-liquid 1.2.0

Choose a tag to compare

@github-actions github-actions released this 15 Oct 14:17

New checks, found by comparing the Logic Apps engine with Shopify Liquid, Microsoft's documentation, DotLiquid's issue list and questions on Microsoft Q&A. Every finding is confirmed on the real Logic Apps engine by the conformance tests.

Added

  • LQ005: a } inside {{ }}, also inside quotes ({{ x | Default: '{}' }}), ends the output, so the map fails to parse.
  • LQ029: forloop properties with the wrong casing (forloop.Last, also in Microsoft's documentation sample) are always empty.
  • Conditions and loops (new category):
    • LQ050: {% else if x %} is a plain else, the condition is ignored
    • LQ051: parentheses in a condition
    • LQ052: a filter in a condition is ignored
    • LQ053: forloop inside JSONArrayFor is always empty
    • LQ054: a comparison or and/or in assign is not evaluated
    • LQ055: two texts with numbers are compared as text ('100' < '20'), typical for XML input
  • Differences from Shopify Liquid, found with the actual values:
    • LQ129: whole numbers above 2,147,483,647 overflow in math filters (IDs, amounts in cents, timestamps in milliseconds)
    • LQ130: contains on a list of text is always false
    • LQ131: text compared with a number gives a wrong result ('999.50' > 1000 is true)
    • LQ132: blank doesn't match a missing value or whitespace, empty doesn't match an empty object
    • LQ133: true/false becomes True/False in a text filter, which breaks JSON output
  • LQ121 also reports a number passed to Date (Shopify Liquid reads it as a Unix timestamp), and LQ124 also reports Size of an object.
  • Hints for engine errors: a text filter on a list (Default, Slice), Sort with mixed types, a list index out of range, a list filter on a single value, and invalid JSON from True/False or a Liquid error.
  • Missing values (LQ023) explain .0 (use [0]) and .Size (use .size), and say "has no value" for variables that don't come from the input.

Fixed

  • A second finding with the same code on the same line was dropped (two Minus calls on one line).
  • LQ113 reported a difference for Split: ' ', which splits on runs of whitespace in Shopify Liquid too.
  • Render errors named the tool's own type for an input value; they now name the runtime's type, as Logic Apps does.
  • LQ043 called an empty value ("x": ,) an empty array item.
  • The symbols for error, warning and success (✖ ⚠ ✔) are emoji, which Windows Terminal draws two columns wide, so they covered the space after them. They are now ✗ ▲ ✓.

Downloads

Usage: see the usage guide.

Platform Executable (no .NET needed)
Windows x64 / ARM64 la-liquid-1.2.0-win-x64.zip / -win-arm64.zip
Linux x64 / ARM64 la-liquid-1.2.0-linux-x64.tar.gz / -linux-arm64.tar.gz
macOS Intel / Apple silicon la-liquid-1.2.0-osx-x64.tar.gz / -osx-arm64.tar.gz

Checksums are in SHA256SUMS.txt. With the .NET 10 SDK or runtime:

dotnet tool install --global LogicApps.Liquid.Cli --version 1.2.0   # the CLI
dotnet add package LogicApps.Liquid --version 1.2.0                 # the library

Full Changelog: v1.1.1...v1.2.0

la-liquid 1.1.0

Choose a tag to compare

@github-actions github-actions released this 15 Oct 13:28

Added

  • Readable output, now the default (--format pretty): findings grouped per map and sorted by line, the source line with a marker under the problem, the actual values and the fix, and a summary per category. Colors in the terminal and in Azure DevOps and GitHub Actions logs.
  • --format pretty|msbuild|json, --verbosity minimal|normal|detailed and --no-color (also NO_COLOR).
  • la-liquid explain [code]: what a code means, an example and the fix. Without a code it lists all codes.
  • Library: DiagnosticCatalog with the documentation of every code, and Diagnostic.Title, Values, Explanation, Fix and OutputLine.

Changed

  • Findings that describe the same problem are reported once, at the place in the map to fix: a Liquid error caused by Minus/Times on text or by include is reported at that call, as an error, with the output line; a missing value caused by .@x is reported with LQ025; the DotLiquid parse error is reported at the location the static checks found.
  • A filter in a loop is reported once per location, with up to three different values.
  • Missing values (LQ023) are located at their first use in the map, and static findings point at the problem itself (the filter or path) instead of the start of the tag.
  • test shows the findings of a test only when it fails (or with --verbosity detailed).
  • Scripts that read the output: the old one-line format is still available with --format msbuild; --format json is better for scripts.

Fixed

  • {% include %} and {% extends %} were also reported as unclosed blocks (LQ003).

Downloads

Usage: see the usage guide.

Platform Executable (no .NET needed)
Windows x64 / ARM64 la-liquid-1.1.0-win-x64.zip / -win-arm64.zip
Linux x64 / ARM64 la-liquid-1.1.0-linux-x64.tar.gz / -linux-arm64.tar.gz
macOS Intel / Apple silicon la-liquid-1.1.0-osx-x64.tar.gz / -osx-arm64.tar.gz

Checksums are in SHA256SUMS.txt. With the .NET 10 SDK or runtime:

dotnet tool install --global LogicApps.Liquid.Cli --version 1.1.0   # the CLI
dotnet add package LogicApps.Liquid --version 1.1.0                 # the library

Full Changelog: v1.0.2...v1.1.0

la-liquid 1.0.2

Choose a tag to compare

@github-actions github-actions released this 15 Oct 12:27
3ed78e2

la-liquid 1.0.2

Validate and run Liquid maps exactly like the Azure Logic Apps Liquid action. See the usage guide.

Executables (no .NET needed)

Platform Download
Windows x64 / ARM64 la-liquid-1.0.2-win-x64.zip / -win-arm64.zip
Linux x64 / ARM64 la-liquid-1.0.2-linux-x64.tar.gz / -linux-arm64.tar.gz
macOS Intel / Apple silicon la-liquid-1.0.2-osx-x64.tar.gz / -osx-arm64.tar.gz

Checksums are in SHA256SUMS.txt.

NuGet (needs the .NET 10 SDK or runtime)

Package Install
LogicApps.Liquid.Cli (dotnet tool) dotnet tool install --global LogicApps.Liquid.Cli --version 1.0.2
LogicApps.Liquid (library) dotnet add package LogicApps.Liquid --version 1.0.2

What's Changed

  • Report flattening of XML elements by Sort, Compact and Uniq (LQ128) a… by @sahinozd in #1

New Contributors

Full Changelog: v1.0.1...v1.0.2

la-liquid 1.0.1

Choose a tag to compare

@github-actions github-actions released this 15 Oct 12:09

la-liquid 1.0.1

Validate and run Liquid maps exactly like the Azure Logic Apps Liquid action. See the usage guide.

Executables (no .NET needed)

Platform Download
Windows x64 / ARM64 la-liquid-1.0.1-win-x64.zip / -win-arm64.zip
Linux x64 / ARM64 la-liquid-1.0.1-linux-x64.tar.gz / -linux-arm64.tar.gz
macOS Intel / Apple silicon la-liquid-1.0.1-osx-x64.tar.gz / -osx-arm64.tar.gz

Checksums are in SHA256SUMS.txt.

NuGet (needs the .NET 10 SDK or runtime)

Package Install
LogicApps.Liquid.Cli (dotnet tool) dotnet tool install --global LogicApps.Liquid.Cli --version 1.0.1
LogicApps.Liquid (library) dotnet add package LogicApps.Liquid --version 1.0.1

Full Changelog: v1.0.0...v1.0.1

la-liquid 1.0.0

Choose a tag to compare

@github-actions github-actions released this 15 Oct 12:02

la-liquid 1.0.0

Validate and run Liquid maps exactly like the Azure Logic Apps Liquid action. See the usage guide.

Executables (no .NET needed)

Platform Download
Windows x64 / ARM64 la-liquid-1.0.0-win-x64.zip / -win-arm64.zip
Linux x64 / ARM64 la-liquid-1.0.0-linux-x64.tar.gz / -linux-arm64.tar.gz
macOS Intel / Apple silicon la-liquid-1.0.0-osx-x64.tar.gz / -osx-arm64.tar.gz

Checksums are in SHA256SUMS.txt.

NuGet (needs the .NET 10 SDK or runtime)

Package Install
LogicApps.Liquid.Cli (dotnet tool) dotnet tool install --global LogicApps.Liquid.Cli --version 1.0.0
LogicApps.Liquid (library) dotnet add package LogicApps.Liquid --version 1.0.0

Full Changelog: https://github.com/sahinozd/LogicAppsStandard.Liquid/commits/v1.0.0