feat!: separate configs by operating system

BREAKING CHANGE: changes paths where configs are stored. Update or use `legacy` branch.

Author: adamtabrams

.gitignore

@@ -1,11 +1,13 @@
-**/.DS_Store
+!.figlink
 
-home/.config/jesseduffield/lazygit/
-home/.config/jesseduffield/lazydocker/development.log
-home/.config/karabiner/automatic_backups/
-home/.config/zsh/.zcompdump
-home/.config/zsh/.zcompcache/
-home/.config/nvim/.netrwhist
-home/.config/nvim/spell/
+.DS_Store
+.zcompdump
+.zcompcache
 
-extras/osx-config/
+**/lazydocker/development.log
+**/karabiner/automatic_backups/
+**/nvim/.netrwhist
+**/nvim/spell/
+
+**/lazygit/*/
+**/lazygit/state.yml

.script_utils.sh

@@ -0,0 +1,78 @@
+debug_echo() {
+    echo "> " "$@" >&2
+}
+
+set_debug_mode() {
+    alias mkdir="debug_echo mkdir"
+    alias mv="debug_echo mv"
+    alias rm="debug_echo rm"
+    alias ln="debug_echo ln"
+}
+
+get_fig_home() {
+    fig_root=$(pwd)
+    [ "${fig_root%%/*}" ] &&
+        { echo "error getting path of fig dir" >&2; exit 1; }
+
+    fig_home="$fig_root/home"
+    [ ! -d "$fig_home" ] && mkdir -p "$fig_home"
+
+    echo "$fig_home"
+}
+
+get_fig_swap() {
+    xdg_data_home=${XDG_DATA_HOME:-$HOME/.local/share}
+
+    fig_swap="$xdg_data_home/fig/$(date +%FT%H:%M:%S)"
+    [ ! -d "$fig_swap" ] && mkdir -p "$fig_swap"
+
+    echo "$fig_swap"
+}
+
+get_link_dirs() {
+    fig_home=$1
+    find "$fig_home" -mindepth 1 -type f -name ".figlink" -exec dirname {} \; | grep -v "^$"
+}
+
+get_link_files() {
+    fig_home=$1
+    find "$fig_home" -mindepth 1 -type f
+}
+
+get_existing_path() {
+    fig_home=$1
+    target=$2
+    echo "$target" | sed "s|$fig_home|$HOME|"
+}
+
+get_backup_path() {
+    fig_swap=$1
+    existing=$2
+    echo "$fig_swap/$(echo "$existing" | tr "/" "%")"
+}
+
+needs_backup() {
+    existing=$1
+    [ ! -L "$existing" ] && { [ -d "$existing" ] || [ -f "$existing" ]; } && return 0
+    return 1
+}
+
+create_link() {
+    fig_home=$1
+    fig_swap=$2
+    target=$3
+
+    existing=$(get_existing_path "$fig_home" "$target")
+
+    needs_backup "$existing" &&
+        ! mv "$existing" "$(get_backup_path "$fig_swap" "$existing")" &&
+        { echo "error backing up $existing" >&2; exit 2; }
+
+    echo "moved existing $(basename "$existing") to $fig_swap"
+
+    parent_dir=$(dirname "$existing")
+    [ -L "$parent_dir" ] && rm "$parent_dir"
+    [ ! -d "$parent_dir" ] && mkdir -p "$parent_dir"
+
+    ln -sFh "$target" "$existing" && echo "created link for $existing"
+}

README.md

@@ -0,0 +1,76 @@
+# About
+
+Fig gives you a simple way to track, backup, and share system configurations.
+This repo currently has some of my own configs.
+
+# Usage
+
+If you plan to use this repo, it's probably a good idea to fork it. That way you can
+easily make your own changes on top of what's here.
+
+The config files are split up into 4 directories:
+- shared_configs - for both Linux and macOS
+- linux_configs - specific to Linux
+- macos_configs - specific to macOS
+- other_configs - other helpful files and scripts
+
+Some of the `*_configs` directories have a `home` directory in them.
+It represents the `$HOME` directory of you system.
+Here's an example:
+If I want a file to exist as `~/.config/foo/bar.conf` on my Linux and macOS systems,
+then I should put that file in `shared_configs/home/.config/foo/bar.conf`.
+
+The default behavior of the `link_*_configs.sh` scripts is to create links in `$HOME` that point to the
+corresponding file in `*_configs/home`. You can also create links that point to a
+corresponding directory by adding a file named `.figlink` to that directory.
+
+# Tips
+- I highly recommend simplifying your home directory. I primarily use these:
+    - repos - where I clone git repos
+    - save - for anything worth saving, documents, media, etc
+    - temp - for scratch files, downloads, and anything I won't need in a few months
+
+- If after installing you see and error like: `zsh compinit: insecure directories...`,
+check [this](https://stackoverflow.com/a/43544733). It explains why you're seeing that
+and how to fix it.
+
+
+<!--
+# Highlights
+### nvim
+        plugins
+        functions
+        coding maps
+        space maps
+        term, tabs, bufs, splits
+## zsh ✔
+        autocomplete
+        vi mode
+        aliases
+### lazygit ✔
+        basics
+        delta
+        x key
+### lf ✔
+        marks
+        H key
+        hiddenFiles PR
+### amethyst ✔
+        bindings
+        use workspaces
+### karabiner ✔
+        layers
+### vimiumc ✔
+        ? key
+        disabling keys
+### local/bin ✔
+        swaprm
+        clipedit
+        historybackup
+### other ✔
+        docs good
+### projects
+        keys
+        sink
+        change
+-->