System Configuration: Macintosh

These configuration steps need only be done once per development system. Once done, follow the Build and Package steps.

Macintosh Configuration

• Open Terminal (Mac command-line)
  • Install Git if necessary
  • Install Homebrew
    • $ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  • Install Python (v2.7.13 at the time of this writing; v2.7.12 and v2.7.13 are known to work for BlocklyPropClient)
    • $ brew install python
  • Install VirtualEnv package
    • $ pip install virtualenv
  • Create PythonProjects folder
    • $ cd ~/
    • $ mkdir PythonProjects
    • $ cd PythonProjects
  • Check out the needed branch from the BlocklyPropClient repository
    • $ git clone https://github.com/parallaxinc/BlocklyPropClient.git
    • $ cd BlocklyPropClient
    • $ git checkout {branch}
  • Create a Virtual Python environment inside the repository's work folder
    • $ virtualenv VPython --distribute
  • Activate the Virtual Python environment for BlocklyPropClient
    • $ source VPython/bin/activate
  • Install all required packages for BlocklyPropClient
    • Install ws4py v0.3.5+
      • (VPython)$ pip install ws4py==0.3.5
    • Install CherryPy v8.1.0
      • (VPython)$ pip install CherryPy==8.1.0
    • Install pyserial v3.1.1
      • (VPython)$ pip install pyserial==3.1.1
    • Install PyInstaller v3.1.1 (Do not use v3.2 as it creates an msc..100 dependency)
      • (VPython)$ pip install PyInstaller==3.1.1
  • Deactivate the Virtual Environment...
    • (VPython)$ deactivate
      • The "(VPython)" prefix will now disappear from your command-line

Build and Package

After configuration (above), follow the Build and Package steps.