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
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