Skip to content

Swift-Liquid 1.0.0

Choose a tag to compare

View all tags
@ThorFuchs ThorFuchs released this 14 Oct 20:13
· 39 commits to main since this release
1.0.0
d36018e

The first stable release of Swift-Liquid: Shopify Liquid templates in modern
Swift, with a focused public API, a command-line tool, and no SwiftPM dependencies.
Requires Swift tools/compiler 6.4 or later in Swift language mode 6.

Install

.package(url: "https://github.com/ThorFuchs/Swift-Liquid.git", from: "1.0.0")

Add .product(name: "Liquid", package: "swift-liquid") to your target.
Build the CLI with swift build -c release; run .build/release/liquid --help.

Library and CLI

  • One Liquid library and one liquid executable, extracted from RhoeLiquid
    with retained source attribution and Apache-2.0 licensing. Ruby Date adaptations
    retain their BSD terms; fixture licenses are included.
  • Checked Sendable values and engines, immutable reusable templates, ordered
    objects, and invocation-owned rendering state for concurrent use.
  • Standard open-source Shopify Liquid tags and filters, lax/strict/strict2 parser
    modes, explicit partials, ordered JSON input, and configurable resource limits.
  • Raising rendering and explicit renderWithDiagnostics recovery, with error
    order, line numbers, and partial names. Cancellation and operational failures
    remain errors in both APIs.
  • Ruby Date/Time recognition and missing-component defaults, deterministic
    reference clocks, fixed offsets, exact parsed decimal fractions, and Liquid
    date formatting.
  • CLI rendering and validation, stdin and JSON context support, explicit partial
    directories, diagnostics on stderr, and atomic output-file replacement.
  • Compiled DocC API reference and guides, public consumer examples, and documented
    language, error, date, concurrency, and performance contracts.

Qualification

  • All 1,098 pinned Golden Liquid cases preserved without exclusions, plus 221
    authored compatibility probes, 337 Ruby date source-table cases, and 376 public
    date-filter cases.
  • The pinned Ruby reference evaluates 2,032 checks: 1,502 successful renders,
    337 parsed grammar cases, 132 expected language errors, 26 recovered errors,
    and 35 explicit supported-year boundary checks. No failures, skips, or reference
    errors are accepted; recovered errors and boundaries are counted separately.
  • Debug and release tests, an independent public consumer, CLI behavior checks,
    AddressSanitizer, ThreadSanitizer, and simulator-SDK library compilation.
  • Five native release benchmark workloads with output checksums and environment
    receipts. Measurements establish a baseline; no comparative speedup is claimed.
  • Reproducible tracked-source archives, a clean extraction rebuilt and tested,
    compiled documentation archives, and SHA-256 checksums.

Compatibility contract

The target is Shopify's open-source Liquid core, pinned to Liquid 5.14.0, Ruby
4.0.1, Date 3.5.1, and Time 0.4.2. Shopify storefront objects and theme-only tags,
custom tag/filter APIs, Rhoe services, macros, inheritance, and document rendering
are outside this release.

The hosting timezone is UTC; supported calendar years are 1–9999. Values use
bounded Int and finite Double, with configurable resource budgets and native
Unicode case mapping. These are explicit compatibility boundaries, not proof of
equivalence for every possible Liquid program.

Runtime qualification covers macOS with Swift 6.4. Library compilation covers
the iOS, tvOS, watchOS, and visionOS simulator SDKs at the declared deployment
minimums; device execution and Linux are not qualified by those checks.

Downloads and documentation

  • Swift-Liquid-source.tar.gz: tracked source at the release commit, verified by a clean rebuild and test run.
  • Liquid.doccarchive.tar.gz: compiled DocC API reference and guides; extract it to open Liquid.doccarchive in Xcode.
  • Swift-Liquid-qualification.tar.gz: qualification and benchmark receipts, test logs, fixture/reference results, source inventory, and archive evidence.
  • SHA256SUMS: SHA-256 checksums for all three archives.

Download all four assets into one directory and verify them before extraction:

shasum -a 256 -c SHA256SUMS

API reference and guides · Language contract · Compatibility evidence · CLI reference

Qualified commit: d36018e6b6822ae408a6c1c439c2307484525b7b. Exact-commit qualification run.

Assets 6
Loading