bin/dot

   1 #!/bin/bash
   2 # dot - a (mostly) one script dotfiles manager
   3 #
   4 # Copyright 2026 Edward Delaporte V
   5 # Licensed under AGPLv3 and later.
   6 #
   7 # Features
   8 #   symlinks - any file in $HOME/dotfiles/files may be symlinked
   9 #
  10 # dot setup
  11 #               install the necessary tools to $HOME/envs/dot
  12 #
  13 # dot link FILE
  14 #   updates ~/dot.HOSTNAME.yaml
  15 #   to include a symlink from ~/dotfiles/files/FILE to ~/.FILE
  16 #
  17 # dot check
  18 #               check setup against ~/dot.HOSTNAME.yaml
  19 #
  20 # dot apply
  21 #               apply config in ~/dot.HOSTNAME.yaml
  22
  23 # set -v
  24
  25 ENVS="$HOME/envs"
  26 ANSIBLE="$ENVS/ansible/bin/ansible-playbook"
  27 TASKFILE="$HOME/dot.$HOSTNAME.yaml"
  28 LINKFILES="$HOME/dotfiles/files"
  29 INSTALLS="$HOME/dotfiles/install"
  30
  31 read -d '' EMPTY_TASKFILE << EOF
  32 ---
  33 - name: Set up dotfiles on $HOSTNAME
  34   gather_facts: no
  35   hosts: localhost
  36   connection: local
  37
  38   tasks:
  39     - name: Check on $TASKFILE
  40       ansible.builtin.stat:
  41         path: $TASKFILE
  42 EOF
  43
  44
  45 if [ "$1" == "setup" ]; then
  46   if [[ ! -f "$ANSIBLE" ]]; then
  47                 mkdir -p "$ENVS"
  48                 echo "Setting up Ansible in ~/envs/ansible"
  49                 cd $HOME/envs; python3 -m venv ansible
  50                 $HOME/envs/ansible/bin/pip install ansible jinja2
  51         fi
  52   if [[ -f "$ANSIBLE" ]]; then
  53                 echo "[ ok ]: Ansible setup at $ANSIBLE"
  54         fi
  55   if [[ ! -f "$TASKFILE" ]]; then
  56                 echo "Creating $TASKFILE"
  57                 echo "$EMPTY_TASKFILE" >> $TASKFILE
  58         fi
  59   if [[ -f "$TASKFILE" ]]; then
  60                 echo "[ ok ]: dot config at $TASKFILE"
  61         fi
  62 fi
  63
  64 if [ "$1" == "reset" ]; then
  65         read -n1 -p "Reset $TASKFILE? [y,N]" input
  66         if [[ ! $input == "Y" && ! $input == "y" ]]; then
  67                 echo "Aborted by user"
  68                 exit 1
  69         fi
  70         echo "$EMPTY_TASKFILE" > $TASKFILE
  71         echo ""
  72 fi
  73
  74
  75 if [ "$1" == "check" ]; then
  76         $ANSIBLE $TASKFILE --check --diff
  77 fi
  78
  79 if [ "$1" == "link" ]; then
  80         if [ ! -n "$2" ]; then
  81                 echo "May symlink:"
  82                 cd $LINKFILES
  83                 ls -p | grep -v /
  84                 exit 1
  85         fi
  86
  87 read -d '' LINK_THIS_FILE << EOF
  88
  89     - name: symlink $2
  90       ansible.builtin.file:
  91         src: "$LINKFILES/$2"
  92         dest: "$HOME/.$2"
  93         state: "link"
  94 EOF
  95
  96         echo "    $LINK_THIS_FILE" >> $TASKFILE
  97         echo "$2 added to symlinks in $TASKFILE"
  98         echo "Run 'dot apply' to create all configured symlinks"
  99 fi
 100
 101
 102 if [ "$1" == "apply" ]; then
 103   if [[ ! -f "$TASKFILE" ]]; then
 104                 echo "$TASKFILE is missing. Run 'dot setup'"
 105                 exit 1
 106         fi
 107         $ANSIBLE $TASKFILE
 108 fi
 109
 110 if [ "$1" == "install" ]; then
 111         if [ ! -n "$2" ]; then
 112                 echo "Can install:"
 113                 cd $INSTALLS
 114                 ls -p | grep -v /
 115                 exit 1
 116         fi
 117         $INSTALLS/$2
 118 fi
 119
 120