4 releases

0.0.4 Nov 12, 2023
0.0.3 Oct 12, 2023
0.0.2 Jul 13, 2023
0.0.1 Jul 8, 2023

#929 in Configuration

MIT license

8KB
122 lines

verstau

Symlink manager leveraging TOML configuration files. Written with the following use cases in mind:

  • Managing configuration files ("dotfiles" git repositories).
  • Managing multiple versions of manually installed software (e.g. inside /usr/local).

Configuration

Verstau looks for verstau.toml file in the given directory, which has the following syntax:

[my_file_1]
source = "my_file_1"
destination = "~/my_file"

[my_file_2]
source = "my_file_2"
destination = "/etc/my_file_2"

Usage

To apply the configuration, launch the following command (from the directory containing verstau.toml):

verstau apply

If the command fails, because a destination file already exists, and you are sure that you want to replace it, you can use --force option to overwrite existing files:

verstau apply --force

Or --skip-existing to add only new symlinks:

verstau apply --skip-existing

Example

This repository uses verstau to manage configuration files, both system-wide (/etc) and user-wide.

Dependencies

~6–12MB
~143K SLoC