Skip to content

What's new in v0.4.2.0?

Version 0.4.2.0 is minor release that brings some improvements and bugfixes, without any breaking changes in CLI interface or configuration.

New & Noteworthy

Support for URL-based templates

Until now, Headroom allowed to use only either built-in templates or templates loaded from local file system. This version adds option to load templates from URL (at this moment only HTTP and HTTPS protocols are allowed). To use URL templates, just put the HTTP(S) address where you normally put path to local template, i.e.:

-t|--template-file https://example.com/path/haskell.mustache

For command line or

template-paths:
  - /some/local/haskell.mustache
  - https://example.com/path/rust.mustache

for YAML configuration.

Note that you can freely combine all template types (i.e. built-in templates, local templates and URL templates), but in case that same template will be define from multiple sources, following order will be applied to select one (left to right from least to most preferred):

built-in template > URL template > local template

Also note that naming convention is the same as for local templates, i.e.

http(s)://path/to/<FILE_TYPE>.<TEMPLATE_TYPE>

See configuration chapter for more details.

Automatically exclude source paths ignored by GIT

It may happen that some (otherwise valid) source files inside your source directory are for some reason set to be ignored by Git, therefore you also need Headroom to ignore them. Until now, this has to be done manually using the exclude-source-paths/--exclude-source-path=PATH YAML/CLI options. Thanks to the vcs-ignore library, Headroom can not exclude these files for you by scanning Git's ignore rules. All you need to do is use either exclude-ignored-paths: true YAML option or --exclude-ignored-paths CLI option.

See configuration chapter for more details.

Other bugfixes and improvements

  • minor tweaks and performance improvements