https://github.com/elkowar/yolk

Templated dotfile management without template files!
https://github.com/elkowar/yolk

config configuration dotfiles rust rust-lang unixporn

Last synced: 25 days ago
JSON representation

Templated dotfile management without template files!

• Host: GitHub
• URL: https://github.com/elkowar/yolk
• Owner: elkowar
• License: mit
• Created: 2024-11-18T09:33:48.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2024-12-15T16:39:29.000Z (26 days ago)
• Last Synced: 2024-12-15T17:26:06.205Z (26 days ago)
• Topics: config, configuration, dotfiles, rust, rust-lang, unixporn
• Language: Rust
• Homepage: https://elkowar.github.io/yolk
• Size: 1.61 MB
• Stars: 13
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

        


    


# Yolk – Painfree Templated Dotfile Management

![Static Badge](https://img.shields.io/badge/homepage-yellow?style=for-the-badge&link=https%3A%2F%2Felkowar.github.io%2Fyolk)

![Crates.io Version](https://img.shields.io/crates/v/yolk-dots?style=for-the-badge)

![GitHub Release](https://img.shields.io/github/v/release/elkowar/yolk?display_name=release&style=for-the-badge)

![GitHub License](https://img.shields.io/github/license/ElKowar/yolk?style=for-the-badge)



Yolk is a dotfile management tool with a unique spin on templating,

sitting somewhere in between [GNU Stow](https://www.gnu.org/software/stow/) and [chezmoi](https://www.chezmoi.io/).

## WARNING

This is pre-alpha software. In its current state, do not trust it. At all.

Always make backups of everything before trying to use yolk, until it's in a stable state.

You have been warned.

## The Concept

Yolk allows you to use simple templates in your configuration files without having to worry about keeping a separate template file and the generated config file in sync.

This is achieved through a design that allows all templates to be included inside comments in your actual configuration file.

Let's demonstrate:

```toml

# Use a different font on one host

# {% if SYSTEM.hostname == "epic-desktop" %}

font="Fira Code"

# {% else %}

# font="Iosevka"

# {% end %}

[colors]

# Load your colors from your yolk configuration

background="#282828" # {< replace_color(data.colors.background) >}

foreground="#ebdbb2" # {< replace_color(data.colors.foreground) >}

```

Yolk will now be able to run the corresponding modifications on the file itself, allowing you to set

templated values while keeping the template directly in the same file.

### User Configuration

Yolk template expressions and configuration are written in the [Luau](https://luau.org/) scripting language.

You can provide custom data to use in your templates via the `yolk.lua` file in your yolk directory,

which allows you to fetch data dynamically from your system, or reference different static data depending on your system.

### Version Control

How does this work with git?

Given that the concrete files in use on your system may be different across machines,

adding those to version control directly would result in a lot of merge conflicts frequently.

Yolk solves this by only commiting a "canonical" version of your templates, generated right before you commit.

This means that the version of your configuration seen in git will always be generated from a consistent, stable context.