A Rust GitOps/symlinkfarm orchestrator inspired by GNU Stow.
Find a file
Christina Sørensen 39e7c02d55 build(flake): change flake inputs
Signed-off-by: Christina Sørensen <christina@cafkafk.com>
2024-01-27 15:52:36 +01:00
.github/workflows feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00
.reuse feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00
benches feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00
doc feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00
LICENSES feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00
src feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00
tests feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00
.envrc build(nix): do crane EZA style 2023-10-06 16:16:56 +02:00
.gitignore feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00
Cargo.lock build(deps): bump rustix from 0.38.7 to 0.38.24 2023-11-17 08:48:15 +01:00
Cargo.toml feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00
CHANGELOG.md feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00
cliff.toml feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00
CODE_OF_CONDUCT.md feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00
flake.lock build(flake): change flake inputs 2024-01-27 15:52:36 +01:00
flake.nix build(flake): change flake inputs 2024-01-27 15:52:36 +01:00
LICENSE feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00
README.md feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00
rust-toolchain.toml feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00
treefmt.nix feat(reuse): reuse compliance 2023-11-17 09:05:16 +01:00

SEIÐR

seidr

An experimental Rust GitOps/symlinkfarm orchestrator inspired by GNU Stow.

Built with Nix Contributor Covenant Unit tests Crates.io Crates.io

Warning

Seiðr is experimental. I'm gonna change how links work soon. Every update might mean rewriting your config. You're warned.

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

Dhall

I already daily drive seidr, and here's an example of how I keep it manageable with dhall. Writing the .yaml files by hand and keeping them up to date quickly felt like writing aterm .drv files for Nix by hand... that is to say not pleasant. This somewhat makes it better.

let {- First, we define some useful variables
    -}
    home
    : Text
    = "/home/ces/"

let config
    : Text
    = "${home}/.config/"

let gitProjectsDir
    : Text
    = "${home}/org/src/git/"

let nixosConfigName
    : Text
    = "afk-nixos"

let nixosConfigDir
    : Text
    = gitProjectsDir

let nixosConfigPath
    : Text
    = "${home}/org/src/git/${nixosConfigName}/"

let seidrConfigPath
    : Text
    = "${nixosConfigPath}/seidr/"

let {- Now, we create some schemes and types and such to make our lives easier

       TODO: We could totally also write some functions, but I haven't gotten to that yet.
    -}
    Flags
    : Type
    = < Clone | Fast >

let Repo
    : Type
    = { name : Optional Text
      , path : Optional Text
      , url : Optional Text
      , kind : Optional Text
      , flags : Optional (List Flags)
      }

let Link
    : Type
    = { name : Optional Text, rx : Text, tx : Text }

let {- Here, we define our repositories
    -}
    nixosConfigRepo
    : Repo
    = { name = Some nixosConfigName
      , path = Some nixosConfigDir
      , url = Some "git@github.com:cafkafk/afk-nixos.git"
      , kind = Some "GitRepo"
      , flags = Some [ Flags.Clone, Flags.Fast ]
      }

let ezaDevelopmentRepo
    : Repo
    = { name = Some "eza"
      , path = Some gitProjectsDir
      , url = Some "git@github.com:eza-community/eza.git"
      , kind = Some "GitRepo"
      , flags = Some [ Flags.Clone, Flags.Fast ]
      }

let {- Here, we define our repositories
    -}
    starship
    : Link
    = { name = Some "starship"
      , tx = "${seidrConfigPath}/starship.toml"
      , rx = "${config}/starship.toml"
      }

let {- And now we pull it all together -}
    categories =
      { seidr.repos
        =
        { -- dots = { name = "seidr", path = path },
          nixosConfigRepo
        , ezaDevelopmentRepo
        }
      , starship.links.starship = starship
      }

in  { categories }

Then it's as easy as running something like this:

dhall-to-yaml --file seidr.dhall --explain --output seidr.yaml
seidr -c seidr.yaml --help

Ofc, you replace --help with whatever you wanna do here.