XDG

This module implements the XDG Base Directory Specification (the newest version, currently version 0.8) by the Free Desktop organisation (freedesktop.org). The full specification can be found on https://specifications.freedesktop.org/basedir-spec/basedir-spec-0.8.html .

The specification specifies where applications should look for files, depending on their use-case. All these locations can be set using environment variables.

Install

$ v install yochem.xdg

Usage

Module documentation can be found on the GitHub Pages of this repo: https://yochem.nl/xdg-v/ . But here is a table with the XDG variables and their defaults.

Environment Variable	V	Default return value
$XDG_CACHE_HOME	cache_home()	'$HOME/.cache'
$XDG_CONFIG_HOME	config_home()	'$HOME/.config'
$XDG_DATA_HOME	data_home()	'$HOME/.local/share'
$XDG_STATE_HOME	state_home()	'$HOME/.local/state'
$XDG_CONFIG_DIRS	config_dirs()	['/etc/xdg']
$XDG_DATA_DIRS	data_dirs()	['/usr/local/share', '/usr/share']
$XDG_RUNTIME_DIR	runtime_dir()	none

pathlib branch

I'm currently working on a pathlib module in vlib, see https://github.com/vlang/v/pull/16782 . For now, this repo has a pathlib branch to show how that would look. This branch will be the default when vlang/v#16782 is finished and merged.

License

MIT.