/dotfiles

pragmaticivan's personal configurations

Primary LanguageShellMIT LicenseMIT

dotfiles

๐Ÿš€ Overview

Your dotfiles are how you personalize your system. These are mine.

Maintaining dotfiles for your computer is crucial for several reasons. Firstly, it ensures consistency across different machines, allowing you to replicate your preferred settings, shortcuts, and configurations effortlessly. This consistency saves time and frustration when transitioning between workstations or setting up a new system. Secondly, dotfiles serve as a personal backup of your customized environment. By version-controlling them with tools like Git, you not only safeguard against accidental changes but also enable easy restoration in case of system crashes or upgrades.

๐ŸŒด Setup

To set up the dotfiles run the appropriate snippet in the terminal.

๐Ÿ’ป MacOS MacOS

  • Configuration snippet of the Apple Silicon MacOS environment for client macnine:
bash -c "$(curl -fsLS https://raw.githubusercontent.com/pragmaticivan/dotfiles/main/setup.sh)"

๐Ÿ–ฅ๏ธ Ubuntu Ubuntu

  • Configuration snippet of the Ubuntu environment for both client and server machine:
bash -c "$(wget -qO - https://raw.githubusercontent.com/pragmaticivan/dotfiles/main/setup.sh)"

Minimal setup

The following is a minimal setup command to install chezmoi and my dotfiles from the github repository on a new empty machine:

sh -c "$(curl -fsLS get.chezmoi.io)" -- init pragmaticivan --apply

๐Ÿ› ๏ธ Update & Test ๐Ÿงช

Updating and testing the dotfiles follows chezmoi's daily operations. To verify that the updated scripts work correctly, run the scripts on the actual local machine and on the docker container.

๐Ÿณ Test on Docker Container

Test the executation of the setup scripts on Ubuntu in its initial state. The following command will launch the test environment using Docker ๐Ÿณ.

make docker-dev

# docker run -it -v "$(pwd):/home/$(whoami)/.local/share/chezmoi" dotfiles /bin/bash --login
# pragmaticivan@6f97d279cb51:~$

Run the chezmoi init --apply command to verify that the system is set up correctly.

pragmaticivan@5f93d270cb51:~$ chezmoi init --apply

๐Ÿฆ‡ Unit Test with Bats

Test the shellscript for setup with Bash Automated Testing System (bats). The scripts for the unit test can be found under ./tests directory.

๐Ÿ‘ Acknowledgements

Inspiration and code was taken from many sources, including:

๐Ÿ“ License

The code is available under the MIT license.