diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml new file mode 100644 index 0000000..9fdfc1d --- /dev/null +++ b/.github/workflows/ci.yaml @@ -0,0 +1,14 @@ +name: CI + +on: + pull_request: + push: + branches: [main] + +jobs: + validate: + name: Validate bootstrap + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - run: . ./bootstrap.sh diff --git a/README.md b/README.md index 22b9d64..3d1b64a 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ Environment tweaks for everyday happiness. ## Setup ```bash -git clone git@github.com:mcataford/env.git | . ./install.sh +git clone git@github.com:mcataford/env.git | . ./bootstrap.sh ``` The setup script will look for pre-existing managed blocks and will not update the file if one is found. @@ -22,13 +22,20 @@ The package is structured as such: ``` env/ - install.sh # Adds bootstrap block to your shell's config file. - shell_extras # Functions, aliases and exports for the shell. - extras.vim # Common config for NVIM. + bootstrap.sh # Adds bootstrap block to your shell's config file. + steps.sh # Definitions for bootstrapping steps + shell_extras # Functions, aliases and exports for the shell. + extras.vim # Common config for NVIM. ``` Adding code to `shell_extras` will add code that gets executed on shell-start. +### Adding steps + +Each step is defined as a function in `steps.sh` and should start with a call to `pre_step` to ensure that a header gets +echo'ed out. Additionally, the function should be called from `bootstrap` in `bootstrap.sh` and the `TOTAL_STEPS` should +be updated to reflect the number of steps. + ## Contributing I'm not currently looking for contributions since this is mainly about standardizing my own setup across machines. diff --git a/apt.txt b/apt.txt new file mode 100644 index 0000000..bf7b028 --- /dev/null +++ b/apt.txt @@ -0,0 +1,4 @@ +zsh +tmux +postgresql +postgresql-contrib diff --git a/bootstrap.sh b/bootstrap.sh new file mode 100644 index 0000000..0e93f51 --- /dev/null +++ b/bootstrap.sh @@ -0,0 +1,18 @@ +#!/bin/bash + +# Ensuring steps are defined. +. ./steps.sh + +TOTAL_STEPS=5 + +# Refer to steps.sh for step definition. +bootstrap() { + ensure_apt_up_to_date + ensure_apt_dependencies + ensure_nvm + inject_shell_configuration + inject_vim_configuration +} + +bootstrap +return diff --git a/install.sh b/install.sh deleted file mode 100644 index 402b85c..0000000 --- a/install.sh +++ /dev/null @@ -1,62 +0,0 @@ -#!/bin/bash - -# 1. PRECONDITIONS -# -# zsh is expected to be set up. - -if [ -z "$(zshc --version 2> /dev/null)" ]; then - echo "💥 Install zsh (https://www.zsh.org/) before installing environment." - return -fi - -# 2. CONFIGURATION INJECTION - -# 2.1 Inject shell configuration. -# -# Adds a managed block to the shell configuration to -# source extra files on shell-start. -# - -BLOCK_DELIMITER_PATTERN="mcataford/env" -WORKING_PATH=$(git rev-parse --show-toplevel) -SHELL_CONFIG_PATH="$HOME/.zshrc" - -echo "Setting up shell configuration extras..." -if [[ -z $(cat $SHELL_CONFIG_PATH | grep $BLOCK_DELIMITER_PATTERN) ]]; then - echo "# $BLOCK_DELIMITER_PATTERN\:start -source $WORKING_PATH/shell_extras -# $BLOCK_DELIMITER_PATTERN\:end" >> $SHELL_CONFIG_PATH - echo "✅ Added managed block to $SHELL_CONFIG_PATH" -else - echo "No changes to apply!" -fi - -EDITOR_CONFIG=$HOME/.config/nvim -EDITOR_CONFIG_FILE=$EDITOR_CONFIG/init.vim - -# 2.2 Inject nvim configuration. -# -# Similarly, sourcing for `extras.vim` is added to the vim configuration -# so plugins, bindings and whatnot are loaded on start. -# - -if [[ -f $EDITOR_CONFIG_FILE ]]; then - echo "Setting up NVIM configuration extras..." - if [[ -z $(cat $EDITOR_CONFIG_FILE | grep $BLOCK_DELIMITER_PATTERN) ]]; then - echo "\" $BLOCK_DELIMITER_PATTERN\:start -source $WORKING_PATH/extras.vim -\" $BLOCK_DELIMITER_PATTERN\:end\n\n" >> $EDITOR_CONFIG_FILE.new - cat $EDITOR_CONFIG_FILE >> $EDITOR_CONFIG_FILE.new - - mv $EDITOR_CONFIG_FILE $EDITOR_CONFIG_FILE.old - mv $EDITOR_CONFIG_FILE.new $EDITOR_CONFIG_FILE - echo "✅ Added managed block to $EDITOR_CONFIG_FILE" - else - echo "No changes to apply!" - fi -fi - -echo "Setting up git configuration..." -source $WORKING_PATH/git_config -echo "✅ Set up git configuration, see $WORKING_PATH/git_config for details!" - diff --git a/steps.sh b/steps.sh new file mode 100644 index 0000000..d7c5fec --- /dev/null +++ b/steps.sh @@ -0,0 +1,96 @@ +#!/bin/bash + +STEP_COUNT=0 + +# Helpers to pretty-print step titles and count. +pre_step() { + STEP_COUNT=$(($STEP_COUNT + 1)) + echo -e "\e[1m[$STEP_COUNT/$TOTAL_STEPS] <====== $1 =======>\e[0m" +} + +# Ensures that all existing Apt packages are up-to-date. +ensure_apt_up_to_date() { + pre_step "Ensuring apt packages are up-to-date" + + if [ -z "$(apt --version 2> /dev/null)" ]; then + echo -e "\e[33mApt not installed, skipping updates.\e[0m" + else + echo -e "\e[1mEnsuring system packages are up-to-date...\e[0m" + + sudo apt update && sudo apt upgrade -y --autoremove + + echo -e "\e[1;32mSystem packages up-to-date.\e[0m" + fi +} + +# Installs packages as specified in apt.txt +ensure_apt_dependencies() { + pre_step "Installing extra packages" + + if [ -z "$(apt --version 2> /dev/null)" ]; then + echo -e "\e[33mApt not installed, skipping packages.\e[0m" + else + echo -e "\e[1mInstalling packages...\e[0m" + + sudo apt install $(cat ./apt.txt) -y --autoremove + + echo -e "\e[1;32mSystem packages installed.\e[0m" + fi +} + +ensure_nvm() { + pre_step "Installing nvm to manage node version" + curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash + + # Ensuring that nvm is usable right away without restarting the shell + export NVM_DIR="$HOME/.nvm" + [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" + [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" +} + +# Injects a managed block in the shell configuration. +inject_shell_configuration() { + pre_step "Injecting managed block in shell configuration" + + BLOCK_DELIMITER_PATTERN="mcataford/env" + WORKING_PATH=$(git rev-parse --show-toplevel) + SHELL_CONFIG_PATH="$HOME/.zshrc" + + echo "Setting up shell configuration extras..." + if [[ -z $(cat $SHELL_CONFIG_PATH | grep $BLOCK_DELIMITER_PATTERN) ]]; then + echo "# $BLOCK_DELIMITER_PATTERN\:start + source $WORKING_PATH/shell_extras + # $BLOCK_DELIMITER_PATTERN\:end" >> $SHELL_CONFIG_PATH + echo "✅ Added managed block to $SHELL_CONFIG_PATH" + else + echo "No changes to apply!" + fi + + EDITOR_CONFIG=$HOME/.config/nvim + EDITOR_CONFIG_FILE=$EDITOR_CONFIG/init.vim +} + +# Injects a managed block in the vim configuration +inject_vim_configuration() { + pre_step "Inject managed block in vim configuration" + + if [[ -f $EDITOR_CONFIG_FILE ]]; then + echo "Setting up NVIM configuration extras..." + if [[ -z $(cat $EDITOR_CONFIG_FILE | grep $BLOCK_DELIMITER_PATTERN) ]]; then + echo "\" $BLOCK_DELIMITER_PATTERN\:start + source $WORKING_PATH/extras.vim + \" $BLOCK_DELIMITER_PATTERN\:end\n\n" >> $EDITOR_CONFIG_FILE.new + cat $EDITOR_CONFIG_FILE >> $EDITOR_CONFIG_FILE.new + + mv $EDITOR_CONFIG_FILE $EDITOR_CONFIG_FILE.old + mv $EDITOR_CONFIG_FILE.new $EDITOR_CONFIG_FILE + echo "✅ Added managed block to $EDITOR_CONFIG_FILE" + else + echo "No changes to apply!" + fi + fi + + echo "Setting up git configuration..." + source $WORKING_PATH/git_config + echo "✅ Set up git configuration, see $WORKING_PATH/git_config for details!" +}