seidr/README.org
Christina Sørensen 8da774af66
chore: name project seidr
Signed-off-by: Christina Sørensen <christina@cafkafk.com>
2023-08-09 16:27:09 +02:00

1.4 KiB

Seiðr

A Rust GitOps/symlinkfarm orchestrator inspired by GNU Stow. Useful for dealing with "dotfiles", and with git support as a first class feature. Configuration is done throug a single yaml file, giving it a paradigm that should bring joy to those that use declarative operating systems and package managers.

Although this isn't really a case where it matters that much for performance, being written in rust instead of e.g. janky scripting languages does also mean it is snappy and reliable, and the extensive (hardly, but eventually) testing helps ensure regressions aren't introduced.

That said, we're in 0.Y.Z, here be dragons for now (although a little less each commit).

Installation

$ git clone https://github.com/cafkafk/seidr
$ cd seidr
$ cargo install --path .

Configuration

If you want a template, you can copy the file from src/test/config.yaml:

$ mkdir -p ~/.config/seidr/
$ cp src/test/config.yaml ~/.config/seidr/config.yaml

You should seriously change this file before running any commands.

The configuration format will likely break regularly in versions 0.Y.Z.