cmorace / mac-programmer-setup-guide

Mac Programmer's Setup Notes

1. Install the Latest Command Line Tools

xcode-select --install
softwareupdate --all --install --force

---

2. Install Homebrew

First,

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

After downloading, add homebrew to your path

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/ccm/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Then open a new terminal, and check the installation with:

brew doctor

---

Install the latest version of Git

brew update
brew install git

Install Github Command Line Tools (if you use Github)

First,

brew update
brew install gh
gh auth login

then follow the instructions to login to Gihub.com and authenticate your computer.

---

Config your git user.name and user.email

git config --global user.name "Mona Lisa"
git config --global user.email [email protected]

---

Install Oh My Zsh

sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Some plugins I like:

1. zsh-autosuggestions

   git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
   

2. zsh-syntax-highlighting

   git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

---

Install Pyenv and Python

First,

brew update
brew install pyenv

Then update your zsh config files

echo "alias brew='env PATH="${PATH//$(pyenv root)\/shims:/}" brew'" >> ~/.zshrc
echo 'eval "$(pyenv init --path)"' >> ~/.zprofile
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

Install libraries required to install python

brew install openssl readline sqlite3 xz zlib

To see the versions of Python that can be installed,

pyenv install -l

Choose the version you want, for example 3.9.9, and install it

pyenv install 3.9.9

Create a new terminal window, and check your installation

python --version

---

Setup a Python Virtual Environment

pip install -U pip
pip install virtualenv
mkdir .virtualenvs
virtualenv env_name

I like to add an alias to .zshrc to activate my virtual environment e.g.,

alias activate='source /home/.virtualenvs/env_name/bin/activate'

---

Install rbenv

brew install rbenv

Check which ruby versions are available to install

rbenv install -l 

Install ruby e.g.,

rbenv install 3.0.3
rbenv global 3.0.3
echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc

start a new shell and check you have the right ruby version in your path

ruby -v

---

Install jekyll

gem install --user-install bundler jekyll

if you get a path error, export the path e.g.,

echo 'export PATH="/Users/ccm/.local/share/gem/ruby/3.0.0/bin:$PATH"' >> ~/.zshrc

create a new jekyll project to test everything is working

gem install bundler jekyll
jekyll new my-awesome-site
cd my-awesome-site
bundle exec jekyll serve
# => Now browse to http://localhost:4000

If there is an error about webrick

bundle add webrick

Install Visual Studio Code

download the release version here

or get the insiders version here