Repository navigation
Releases
la-liquid 1.4.0
Added
- LQ006: an extra
{at the start of an output ({{{ x }}). Logic Apps doesn't fail, but writesLiquid 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 libraryWhat's Changed
Full Changelog: v1.3.0...v1.4.0
la-liquid 1.3.0
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
PATHof 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 libraryWhat'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
Maintenance release: no changes in what the tool reports.
Changed
- The conformance tests run in
en-USonly, 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 libraryWhat's Changed
Full Changelog: v1.2.0...v1.2.1
la-liquid 1.2.0
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:
forloopproperties 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 plainelse, the condition is ignored - LQ051: parentheses in a condition
- LQ052: a filter in a condition is ignored
- LQ053:
forloopinsideJSONArrayForis always empty - LQ054: a comparison or
and/orinassignis not evaluated - LQ055: two texts with numbers are compared as text (
'100' < '20'), typical for XML input
- LQ050:
- 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:
containson a list of text is always false - LQ131: text compared with a number gives a wrong result (
'999.50' > 1000is true) - LQ132:
blankdoesn't match a missing value or whitespace,emptydoesn't match an empty object - LQ133:
true/falsebecomesTrue/Falsein 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 reportsSizeof an object. - Hints for engine errors: a text filter on a list (
Default,Slice),Sortwith mixed types, a list index out of range, a list filter on a single value, and invalid JSON fromTrue/Falseor aLiquid 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
Minuscalls 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 libraryFull Changelog: v1.1.1...v1.2.0
la-liquid 1.1.0
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|detailedand--no-color(alsoNO_COLOR).la-liquid explain [code]: what a code means, an example and the fix. Without a code it lists all codes.- Library:
DiagnosticCatalogwith the documentation of every code, andDiagnostic.Title,Values,Explanation,FixandOutputLine.
Changed
- Findings that describe the same problem are reported once, at the place in the map to fix: a
Liquid errorcaused byMinus/Timeson text or byincludeis reported at that call, as an error, with the output line; a missing value caused by.@xis 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.
testshows 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 jsonis 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 libraryFull Changelog: v1.0.2...v1.1.0
la-liquid 1.0.2
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
New Contributors
Full Changelog: v1.0.1...v1.0.2
la-liquid 1.0.1
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
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