Release notes from carrot

2.4.5

2020-05-22T17:57:44Z

For Issue #38, added an elvis operator. See the docs for details.

As with previous releases, the recommended approach for using Carrot is via Maven or Gradle:

With Maven:

<dependency>
  <groupId>au.com.codeka</groupId>
  <artifactId>carrot</artifactId>
  <version>2.4.5</version>
</dependency>

With Gradle:

implementation 'au.com.codeka:carrot:2.4.5'

2.4.4

2020-04-09T21:17:21Z

Mostly just some internal cleanups. The one user-visible change is I removed a warning when an {% extends %} tag includes whitespace text.

As with previous releases, the recommended approach for using Carrot is via Maven or Gradle:

With Maven:

<dependency>
  <groupId>au.com.codeka</groupId>
  <artifactId>carrot</artifactId>
  <version>2.4.4</version>
</dependency>

With Gradle:

implementation 'au.com.codeka:carrot:2.4.4'

2.4.3

2020-01-09T05:40:23Z

Two minor enhancements in this release:

Issue #32 String concatentation. Now you can do things like:

{% set a = "foo" %}
{% set b = "bar" %}
{{ a + b }}

Issue #37 Escaping Java variables names. Normally, all identifiers in Carrot are Java identifiers (because we typically expect you to be querying Java objects). But if not and you want some otherwise disallowed characters in your set variables, for example, you can:

{{ my\-var }}

Will output the contents of variable "my-var".

As with previous releases, the recommended approach for using Carrot is via Maven or Gradle:

With Maven:

<dependency>
  <groupId>au.com.codeka</groupId>
  <artifactId>carrot</artifactId>
  <version>2.4.3</version>
</dependency>

With Gradle:

compile 'au.com.codeka:carrot:2.4.3'

v2.4.2

2018-11-30T22:04:43Z

This release adds a new type of operator, the ternary operator. See the documentation for more, but now you can do something like:

{{ foo == 0 ? "zero" : foo }}

Just like you would in normal Java.

As with previous releases, the recommended approach for using Carrot is via Maven or Gradle:

With Maven:

<dependency>
  <groupId>au.com.codeka</groupId>
  <artifactId>carrot</artifactId>
  <version>2.4.2</version>
</dependency>

With Gradle:

compile 'au.com.codeka:carrot:2.4.2'

v2.4.1

2017-10-03T15:03:02Z

This is a minor bugfix release. There was one new addition, however.

You can pass values to an {% include %} tag (see the documentation)
Fixed handling of null values
Don't swallow } or { at the very end of the input

As with previous releases, the recommended approach for using Carrot is via Maven or Gradle:

With Maven:

<dependency>
  <groupId>au.com.codeka</groupId>
  <artifactId>carrot</artifactId>
  <version>2.4.1</version>
</dependency>

With Gradle:

compile 'au.com.codeka:carrot:2.4.1'

v2.4.0

2017-08-22T12:13:50Z

Lots of refactoring in this release, but also some new features.

New {% include %} tag, for doing simple includes.
The CarrotEngine class is now immutable, and you can use a Builder to construct it.
You can use {% for key, value in map %} to iterate the key/value pairs of a map.
The {% set %} tag supports setting simple values, as well as blocks (via {% set name = value %}).

As with previous releases, the recommended approach for using Carrot is via Maven or Gradle:

With Maven:

<dependency>
  <groupId>au.com.codeka</groupId>
  <artifactId>carrot</artifactId>
  <version>2.4.0</version>
</dependency>

With Gradle:

compile 'au.com.codeka:carrot:2.4.0'

v2.3.0

2017-08-22T11:39:51Z

Maintenance release, with two main changes:

A dedicated Bindings interface, so bindings can be implemented from any class, not just a map.
Android support by reverting some features to Java 7

As with previous releases, the recommended approach for using Carrot is via Maven or Gradle:

With Maven:

<dependency>
  <groupId>au.com.codeka</groupId>
  <artifactId>carrot</artifactId>
  <version>2.3.0</version>
</dependency>

With Gradle:

compile 'au.com.codeka:carrot:2.3.0'

v2.2.0

2017-03-15T12:57:17Z

Features this release:

Set tag
Proper HTML-escaping, and some helpers to work with HTML-escaping.

As with previous releases, the recommended approach for using Carrot is via Maven or Gradle:

With Maven:

<dependency>
  <groupId>au.com.codeka</groupId>
  <artifactId>carrot</artifactId>
  <version>2.2.0</version>
</dependency>

With Gradle:

compile 'au.com.codeka:carrot:2.2.0'

v2.1.0

2017-03-15T10:29:27Z

This is the first release published here on GitHub, for complete documentation see here.