RELEASES.md

📝 Release notes

0.8.1

February 23rd, 2024

• Fix bug with loop var access in nested template

0.8.0

October 28th, 2023

Features

• Add with_template_fn to Renderer This allows you to configure the way that included templates are resolved.

• Allow setting max_include_depth at renderer level This allows you to configure the maximum include depth on a per-renderer basis.

0.7.1

July 23rd, 2023

Features

• Add .template(name) function to engine This function is a shorthand for get_template that panics if the template does not exist.

Fixes

• Fix integer overflow when parsing index access

0.7.0

July 23rd, 2023

Features

• Redesign the render API This improvement allows us to add more configuration to the rendering process in the future. It also prevents the need for a proliferation of rendering functions. The new public Renderer struct is created using one of the three functions: render, render_from, or render_from_fn. And then the renderer can be consumed using .to_string() or .to_writer(..).

• Support ?. optional chaining operator

• Allow values to be fetched lazily This allows you to provide the global context from an outside source during rendering.

• Replace ValueCow::as_bool with truthiness function This change implements a truthiness function for evaluating conditionals. None, false, 0 integer and 0.0 float, empty string, list, and map as falsy. Everything else is truthy.

  Contributed by @lunabunn

0.6.0

November 20th, 2022

Features

• Expand supported filter argument types Adds the unit type, all integer primitive types, and f32.

Fixes

• Fix bug in value! macro
• Use index implementation for looking up spans This removes all the unsafe code in this library. I think the decrease in performance (about 5-10%) is worth not having any unsafe code.

0.5.0

November 14th, 2022

Features

• Add methods to remove templates and functions remove_template allows you to remove a template from the engine. remove_function allows you to remove a formatter or filter from the engine. add_formatter and add_filter now return the previous type of function if a function of the same name already existed in the engine.
• Add some From and FromIterator impls for Value
• Support and test on Rust 1.60
• Support Unicode identifiers

Fixes

• Parse list indices in lexer This fixes a bug where a path like lorem.123.ipsum would not parse correctly because the lexer would return a Token::Number for the span "123.ipsum". This requires adding an additional state to the lexer so that it knows when it is lexing a path versus a float literal.
• Refactor formatter and filter errors Move formatter types to new module, add fmt::Error type. Add filter error trait and kind.
• Add template name to error, update error format

0.4.0

October 3rd, 2022

Features

• Make various filter traits public This allows you to refer to them if you want to be generic over filters.
• Support else if This is simply desugared to a nested if statement in the parser.
• Support scientific notation for float literals
• Use Cow<str> for map keys and template sources This allows you to store template sources computed at runtime in the engine while preserving support for templates included in the binary.

Fixes

• Fix bug with include statement scopes
• Restrict maximum include depth. This prevents infinite recursion when including templates. This can be configured using the set_max_include_depth method on an Engine.
• Disallow configuring syntax using empty strings We now panic if you pass an empty string to SyntaxBuilder.