Skip to content

Latest commit

 

History

History
41 lines (32 loc) · 1.92 KB

README.md

File metadata and controls

41 lines (32 loc) · 1.92 KB

dotfiles

Actions are performed according to structure of dotfiles, .gitignore, ignorefiles, win_src_dest, nixos/configuration.nix and hardware-configuration.nix

  • checkHealth.sh shows status of files
  • fileBackup.sh create backup to folder $HOME/back/TIMESTAMP_backconfig with timestamp if not symlink
  • fileRemove.sh remove regular files, if existing on system
  • fileRestore.sh write files, if nonexisting on system, from backup by argument the folder name
  • symlinkInstall.sh create symlinks and also create folders with symlinks
  • symlinkUninstall.sh remove symlinks
  • fileOverwrite.ps1 overwrite configurations based on win_src_dest on Windows
  • TODO: usage on NixOS

Dependencies

  • coreutils: http://git.savannah.gnu.org/gitweb/?p=coreutils.git (untested for other utils)
    • readlink to follow symbolic links
    • realpath to resolve non-canonical paths provided by fd-find
  • fd-find: https://github.com/sharkdp/fd (cargo install fd-find) for convenient ignorelist
    • fd returns relative paths prefixed with ./ to prevent -files from modifying shell behavior
  • POSIX-compatible shell, but should work on most other shells
    • loops need adjustments for POSIX shell

Usage

Make sure to place this repository in ${HOME}/dotfiles. If you also like that this can not be checked in POSIX, let them know.

Make sure not to mess up your .bashrc or equivalent of your login shell. Keep a copy of your distro and files around on your first try to restore things.

Path handling and file names

To set an example for proper handling, we use readlink and realpath from coreutils. This is a fundamental limitation of any program printing folder and file names, since -filenames are not considered as special. However they can break programs. Example: ls "${filename}" with filename being -k leading to ls -k. See also sharkdp/fd#760 and https://dwheeler.com/essays/fixing-unix-linux-filenames.html#dashes