Templating

You can use handlebars template syntax in dot.yaml files and the defaults file.

This allows for e.g. access to environment variables.

Variables

Variable	Description	Example
config	The current config	depends: [ {{#each config.variables.some ~}} "{{this}}", {{/each }} ]
env	A map of Environment variables	some.file: {{ env.HOME }}/some.file
name	The name of the current dot	installs: apt install {{ name }}
os	The current os (either windows, linux or darwin) as used in dots	{{#if (eq os "windows")}}some: value{{/if}}
whoami	A map of information about the environment (see whoami). Provided by the whoami crate.	some.file: /home/{{ whoami.username }}/some.file
directories	A map of directories (see directories). Provided by the directories crate	some.file: {{ directories.home }}/some.file

whoami

Variable	Description
desktop_env	Information about the Desktop environment
devicename	The device name
distro	The os distro
hostname	The hostname
lang	An array of the users prefered languages
platform	The current platform
realname	The users full name
username	The current users username
arch	The CPU architecture of the system.

directories

Group	Variable
base	cache
base	config
base	data
base	data_local
base	home
base	preference
user	audio
user	desktop
user	document
user	download
user	home
user	picture
user	public
user	template
user	video

Helpers

Rotz comes with helpers provided by the handlebars_misc_helpers crate.

Theres also a number of inbuilt helpers provided

#windows, #linx and #darwin

These helpers are shorthands for checking the curent os.

Instea of {{ #if (eq os "windows") }}{{ else }}{{ /if }} they can be used like this {{ #windows }}{{ else }}{{ /windows }}.

eval

The eval helper can be used to evalate a string on the shell configured by shell_command.

The helper can be used like this {{ eval "some --shell command" }}