Pkl 0.32.0 Release Notes

Pkl 0.32 was released on TBD.
The latest bugfix release is 0.32.0. (All Versions)

The next release (0.33) is scheduled for TBD. To see what’s coming in the future, follow the Pkl Roadmap.

Please send feedback and questions to GitHub Discussions, or submit an issue on GitHub.

Pkl is hosted on GitHub. To get started, follow Installation.

Highlights 💖

News you don’t want to miss.

XXX

Noteworthy 🎶

Ready when you need them.

Standard Library Changes

`pkl:EvaluatorSettings`

Additions

New method: EvaluatorSettings.resolve()
New method: EvaluatorSettings.resolveForOs()
New property: EvaluatorSettings#ExternalReader.workingDir

`pkl:Project`

Additions

New property: Project.resolvedEvaluatorSettings

Breaking Changes 💔

Things to watch out for when upgrading.

Java API changes

Changes have been made to the Java API.

Removals and deprecations

The following APIs have been removed without replacement.

org.pkl.config.java.Config#makeConfig (#1531)

The following APIs have been deprecated for removal.

org.pkl.config.java.mapper.NonNull (#1607).

Changes

org.pkl.core.evaluatorSettings.PklEvaluatorSettings.parse no longer accepts a pathNormalizer argument.

Loading rule changes in `pkl:EvaluatorSettings`

Breaking changes have been made to how evaluator settings are loaded (#1394).

Loading rule changes for the external reader executable

The following changes have been made for the executable property in an external reader:

If the executable does not contain a slash (/ on POSIX, \ on Windows) character, it is always resolved against the PATH environment variable.
If it does contain a slash, it is resolved relative to the enclosing PklProject directory, instead of the current working directory.

Changes to `--external-module-reader` and `--external-resource-reader` CLI flags

The --external-module-reader and --external-resource-reader CLI flags will replace any external readers otherwise configured within a PklProject, instead of add to it (#1394).

This makes this behavior consistent with how other settings work.

Work In Progress 🚆

They missed the train but deserve a mention.

XXX

Contributors 🙏

We would like to thank the contributors to this release (in alphabetical order):