4 releases

new 0.2.1 Jun 2, 2024
0.2.0 May 3, 2024
0.1.2 May 2, 2024
0.1.1 Apr 21, 2024

#289 in Configuration

Download history 152/week @ 2024-04-16 24/week @ 2024-04-23 310/week @ 2024-04-30 1/week @ 2024-05-14 6/week @ 2024-05-21 129/week @ 2024-05-28

136 downloads per month

Unlicense

27KB
594 lines

Homux is a home directory multiplexer.

How it works

A source directory is applied to the home directory of multiple hosts. In order to multiplex configurations across different hosts, the matchpick library is used to match different lines depending on which host is being applied to.

Let's look at an example configuration file, ~/.gitconfig. Suppose our home computer is named "homestation", while our computer at work is named "workstation". We wish to configure our email address differently on each host, while keeping our name the same:

# https://git-scm.com/docs/git-config
[user]
    name = Tux Linux

    ~>>>
    email = "Default@example.com"
    ~>>> homestation
    email = "PersonalAccount@example.com"
    ~>>> workstation
    email = "WorkAccount@example.com"
    ~<<<

This allows a single directory managed by a single repository to be used as the configuration source even across different hosts.

Dependencies

~2–12MB
~97K SLoC