sb2nov / mac-setup

Installing Development environment on macOS

macOS Setup Guide

This guide covers the basics of setting up a development environment on a new Mac. Whether you are an experienced programmer or not, this guide is intended for everyone to use as a reference for setting up your environment or installing languages/libraries.

Some environments we will set up are Node (JavaScript), Python, C++ and Ruby. Even if you don't program in all of them, they are useful to have as many command-line tools rely on them. We'll also show you some useful daily use applications. As you read and follow these steps, feel free to post any feedback or comments you may have.

Contributing to the guide

All contributions to the guide are welcome. Please help add support for other libraries and languages. To make a contribution please use our contribution template.

We're looking for more contributors to maintain and extend the documentation.

---

This guide is MIT licensed and has been generated using GitBook. Feel free to contribute or create new issues on GitHub.

mac-setup's Issues

Cask instructions are no longer needed

Cask is now included in the Homebrew repo (Source), so the Cask instructions should be updated to just point to Homebrew install instructions.

I came across this while setting up Vagrant; I don't have time to open a PR now since I'd want to ensure that I don't break links elsewhere in the site.

Ruby installation problem

When I try to to install ruby through homebrew with the following command

brew install rbenv ruby-build rbenv-gem-rehash rbenv-default-gems

It can't find the formulas for rbenv-gem-rehash and rbenv-default-gems.
Do I need to do something before installing these?

Navigation has a typo for 6.1 - should be *Preferences*

Cool resource - thanks for sharing it. Minor typo in the left nav for section 6.1... it should be Preferences, not Perferences.

Add ZSH with prezto: no such file or directory: /Users/*****/Projects/config/env.sh

-zsh

install prezto: after with this step:

edit the .zshrc by opening the file in a text editor and adding the following below
# Add env.sh
source ~/Projects/config/env.sh

Iterm2 prompt:
Users/gavin/.zshrc:source:14: no such file or directory: /Users/gavin/Projects/config/env.sh

what's wrong with the config? thxs.

License question...

As I recal, MIT (and other software licenses) only partain the software documentation, not written prose.

Because this is a body of work that contains written word and not software, shouldn't it have a different license than the MIT License? There are several options for documentation licenses available.

homebrew installation command change

ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"

Sublime Text Package: How do I find the latest version

from : http://sourabhbajaj.com/mac-setup/SublimeText/Packages.html

Thank you!

Adobe flash player

Ruby : add references to rbenv-gemset

Rbenv is a great tool for handling ruby version and gem versioning. Gems tends to add up quickly when your work on several project. A good way to not poluate your machine with thousand of package rbenv-gemsets came to life.

Here is the link : https://github.com/jf/rbenv-gemset

It would be nice to add a reference to this package.

What do you think ?

Scala guide: Updating sbtopts command has issues with newline characters

It appears that this command causes issues with sbt:
$ echo '-J-XX:+CMSClassUnloadingEnabled\n-J-Xmx2G\n' >> /usr/local/etc/sbtopts

At least, it did when I used it. sbt would complain at run time:

$ sbt
Unrecognized VM option 'CMSClassUnloadingEnabledn-J-Xmx2Gn'
Did you mean '(+/-)CMSClassUnloadingEnabled'?
Error: Could not create the Java Virtual Machine.
Error: A fatal exception has occurred. Program will exit.

This was due to the two options being added on a single line with newline characters instead of being separated by newlines.

With current command:

# java version (default: java from PATH, currently $(java -version |& grep version))
#
#-java-home <path>

-J-XX:+CMSClassUnloadingEnabled\n-J-Xmx2G\n

How I think it should read:

# java version (default: java from PATH, currently $(java -version |& grep version))
#
#-java-home <path>

-J-XX:+CMSClassUnloadingEnabled
-J-Xmx2G

iPython installation error

I've successfully installed the prereqs on the iPython installation page yet when I do:
pip install ipython[zmq,qtconsole,notebook,test]

I get
zsh: no matches found: ipython[zmq,qtconsole,notebook,test]

Merging with gitbook branch

Why are u not merging with gitbook branch to keep it up-to-date?

Add Diff and Merge Tools

It would be good if there were a list with diff and merge tools for macOS.

E.g.

• FileMerge
• Kaleidoscope
• Beyond Compare
• Araxis Merge
• DeltaWalker
• P4 Merge
• DiffMerge

If you completed this guide, say thanks here!

Here is the place to say thank you to folks who are working hard on this project.

« One of the greatest ways to show your appreciation to open source projects you enjoy is to open an issue that let people say thank you »

Disclaimer: I don't have any kind of connexion or personal interest with maintainers(s) of this project. Pure gratitude here.

Cheers!

Question: How easy is it to start over?

I get a ton of issues in Brew Doctor and installing things in Python. How difficult is it to reset my entire dev environment?

brew install hub

Thanks!

This guide works perfectly for me and my new MBP!

I received an error when installing Ruby

Figured it out!

oh-my-zsh

Automate installs?

Great guide!
Newbie question, though: is it possible to automate some of the stuff, e.g. put it in the file and then process installs one by one?

homebrew cask

Update the information in gitbook

The url of Homebrew in gitbook is: https://raw.github.com/Homebrew/homebrew/go/install

while the correct one should be https://raw.githubusercontent.com/Homebrew/install/master/install

(it's updated in the source, but the gitbook is still outdated)

Chrome extentions

Add CONTRIBUTING.md

This is such a great book. Thanks so much for writing it!

It may good to have a reference for contributions.

change it to a book format

Learn Boxen

Learn boxen to create a boxen instead of the long setup.

mysql_install_db no longer necessary

The steps

unset TMPDIR
$ mkdir /usr/local/var
$ mysql_install_db --verbose --user=`whoami` --basedir="$(brew --prefix mysql)" --datadir=/usr/local/var/mysql --tmpdir=/tmp

at the MySQL Section didn't work for me. According to a comment at the accepted answer of http://stackoverflow.com/questions/4359131/brew-install-mysql-on-mac-os Homebrew changed the MySQL installation formula so this is no longer necessary.

Great guide, saved me a lot of time!

What to do with env.sh ?

on page - http://sourabhbajaj.com/mac-setup/iTerm/zsh.html

I don't know where I should put this config

env.sh

#!/bin/zsh

    # PATH
    export PATH="/usr/local/share/python:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
    export EDITOR='subl -w'
    # export PYTHONPATH=$PYTHONPATH
    # export MANPATH="/usr/local/man:$MANPATH"

    # Virtual Environment
    export WORKON_HOME=$HOME/.virtualenvs
    export PROJECT_HOME=$HOME/Projects
    source /usr/local/bin/virtualenvwrapper.sh

    # Owner
    export USER_NAME="YOUR NAME"
    eval "$(rbenv init -)"

    # FileSearch
    function f() { find . -iname "*$1*" ${@:2} }
    function r() { grep "$1" ${@:2} -R . }

    #mkdir and cd
    function mkcd() { mkdir -p "$@" && cd "$_"; }

    # Aliases
    alias cppcompile='c++ -std=c++11 -stdlib=libc++'

    # Use sublimetext for editing config files
    alias zshconfig="subl ~/.zshrc"
    alias envconfig="subl ~/Projects/config/env.sh"

Then the guide refers to it again on the Python section and I'm still clueless.

Thanks!

---

EDIT: I put it there /Users/my-name/Project_Demo/config

Make sense ?

Octave

I suggest install Octave via brew-cask which packs all dependancies:

brew cask install octave

I was using octave by brew, but I noticed that every time gcc upgrade, octave is down and need to reinstall.

.sbtconfig deprecated

Use of ~/.sbtconfig is deprecated, please migrate global settings to /usr/local/etc/sbtopts

Question: Unable to find aliases in env.sh file

Edit: figured it out! thanks again for the guide!

http://code-worrier.com/blog/autocomplete-git/

Add rust instructions

Add PHP language setup with mcrypt or any other module

No such files after install Rails

I received this error when to launch this commandecho 'rails' >> "~/.rbenv/default-gems"
zsh: no such file or directory: ~/.rbenv/default-gems

how to fix?

Changes to be made

1. Nose is needed before numpy installation
2. Distribute is merged with setuptools
3. SuperDuper
4. Google Notifications
5. Menubar changes

Install Docker

Error: No available formula for gfortran

GNU Fortran is now provided as part of GCC, and can be installed with:
  brew install gcc

A simple correction in the numpy section :)

Use gitbook plugins

1. Use plugins to evaluate the commands in console
2. Evaluate the others as well

no references to python3 + probably best to install python packages via pip

Hi, very nice guide. I work full time as a data person with Python3 + data stack (pandas, etc.) on Mac OSX and it's pretty stable, also it's probably recommended to default to Py3k and mention Python 2.7 as an "if all else fails" alternative.

Also, it's probably a better idea to install things via pip rather than brew since that way you skip the extra layer – plus there might be useful libraries that aren't available via Homebrew so you're stuck with pip anyway.

What do you think?

updating env.sh

Sourabh,
I really like your website. Have a question about how to edit the env.sh. Following your directions here: http://sourabhbajaj.com/mac-setup/iTerm/zsh.html but you lose me at the end. How do you access the env.sh to edit and update? thanks!

Sublime text config and update to 3

Solarized dark theme doesn't work in iTerm2 2.1.4

iTerm2 in version 2.1.4 doesn't accept color preset when importing Solarized dark theme, better to use one of these: https://github.com/mbadolato/iTerm2-Color-Schemes/tree/master/schemes

Add Ubuntu guide if possible

Will do it only once I get time to play 👍

Where is "~/.zpreztorc"

In
https://github.com/sb2nov/mac-setup/blob/master/iTerm/zsh.md

I have to:
edit the ~/.zpreztorc file and add

I have no idea where this is. What ~ means ??

In my path:
/Users/p_andy/.zprezto

I list those files:
drwxr-xr-x 14 p_andy staff 476 14 Jul 21:57 .git
-rw-r--r-- 1 p_andy staff 36 14 Jul 21:57 .gitignore
-rw-r--r-- 1 p_andy staff 1034 14 Jul 21:57 .gitmodules
-rw-r--r-- 1 p_andy staff 1619 14 Jul 21:57 CONTRIBUTING.md
-rw-r--r-- 1 p_andy staff 3588 14 Jul 21:57 README.md
-rw-r--r-- 1 p_andy staff 2901 14 Jul 21:57 init.zsh
drwxr-xr-x 42 p_andy staff 1428 14 Jul 21:57 modules
drwxr-xr-x 9 p_andy staff 306 14 Jul 21:57 runcoms

I just need a bit more details here :)
Thanks!

Mou - markdown editor

Guide to setup pip package manager

A guide to show how to setup pip package manager in mac.

Add Go Language setup instructions

Can't install brew install <formula>

on page http://sourabhbajaj.com/mac-setup/Homebrew/Usage.html

To install a package (or Formula in Homebrew vocabulary) simply type:
$ brew install
To update Homebrew's directory of formulae, run:

andy-laps-MacBook-Pro:~ andy_lap$ brew install <formula>
-bash: syntax error near unexpected token `newline'
andy-laps-MacBook-Pro:~ andy_lap$ brew install formula
==> Auto-updated Homebrew!
Updated Homebrew from c8d814f to b39eba6.
Updated 3 taps (caskroom/cask, homebrew/core, homebrew/fuse).
==> Updated Formulae
ammonite-repl              gnupg                      pillar
artifactory                homebrew/fuse/gitfs        rancher-compose
awscli                     jenkins                    siege
brotli                     libgcrypt                  translate-toolkit
calabash                   libgit2-glib               xonsh
citus                      libjson-rpc-cpp            youtube-dl
flake8                     node-build
Error: No available formula with the name "formula"
==> Searching for similarly named formulae...
Error: No similarly named formulae found.
==> Searching taps...
These formulae were found in taps:
homebrew/dupes/file-formula              Caskroom/cask/shimeike-formulatepro
Caskroom/cask/klatexformula
To install one of them, run (for example):
  brew install homebrew/dupes/file-formula
andy-laps-MacBook-Pro:~ andy_lap$ brew install formulae
Error: No available formula with the name "formulae"
==> Searching for similarly named formulae...
Error: No similarly named formulae found.
==> Searching taps...
Error: No formulae found in taps.
andy-laps-MacBook-Pro:~ andy_lap$

what's wrong ?

Sublime scripts