From 3f42a1bcfd3602290593d1b00d10ca5a244e0468 Mon Sep 17 00:00:00 2001 From: Aaron Johnson Date: Tue, 23 Oct 2018 15:44:40 -0700 Subject: [PATCH 1/4] Added installation steps for Python 2.7 and go 1.10+ --- README.md | 65 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) diff --git a/README.md b/README.md index 98ae1877..b756eb27 100644 --- a/README.md +++ b/README.md @@ -58,6 +58,71 @@ There are three basic categories of incomplete functionality: ## Running Grumpy Programs ### Pre-requisites +Python 2.7 + *pip + *setuptools +Go 1.10+ + +### Windows Python 2.7 installation instructions + +Windows users can download Python2.7 from https://www.python.org/downloads/release/python-2715/ +once downloaded run the installer and follow along with the prompts. After installing Python 2.7 +open the command line and type "python -m pip install --upgrade setuptools pip". + +### Mac Python 2.7 installation instructions +OSX users can go to https://www.python.org/downloads/release/python-2713/ +locate the appropriate installer for your system, run the installer and +follow along with the prompt. Once installed open a terminal and run the command +"python -m pip --version" if this command returns "pip [somenumber] then pip installed +and you can run the command "python -m pip install --upgrade pip setuptools". If the +command does not return that or states that pip isn't installed on your system run +the command "sudo easy_install pip" then run the command "python -m pip install --upgrade pip setuptools". + +### Linux Python 2.7 installation instructions +Almost all linux operating systems come bundled with Python 2.7 with the exception of +a few such as Arch linux (in some cases). To check your version of python run the command(s) +"python --version" if this command returns python 3+ then run the command "python2 --version" +if this command returns python 2.7+ then you already have python installed on your system. +If python 2.7 is already installed on your system run the command "python -m pip --version" +or "python2 -m pip --version", which you determined above. If it reutnrs a version number for pip +you can skip the following step, otherwise run the command "sudo apt install python-pip". Replace apt +with your respective package tool. + +Once that's done run the command "python (or python2) -m pip install --upgrade pip setuptools". + +If you do not have Python 2.7+ on your system, it's sugessted that you follow this guide to setup +python 2 in a virtual environment https://virtualenv.pypa.io/en/stable/installation/ . If you'd +prefer to just install it normally run the command "sudo apt install python2.7 python-pip" +Note: replace apt with your respective package tool Ie, sudo pacman -Syu python2.7, +sudo yum install python2.7 etc.. + +Then run the command "python -m pip install --upgrade pip setuptools". + +### Windows GO lang installation instructions + +Windows users can go to https://golang.org/dl/ locate the appropriate installer for your +system, select a Go version >= 1.10, download the installer then simply follow the prompts. + + +### OSX GO Lang installation instructions + +OSX users can go to https://golang.org/dl/ locate the appropriate instaler for your system +download the installer and follow the prompts. + +Once installed set your environment variable for go export GOPATH=$HOME/go + +You can also download the archive and extract it to /sr/local by running the command +"tar -C /usr/local -xzf go.archive.file.tar.gz" You still have to set the environment variable +by running the command "export GOPATH=$HOME/go/bin" + +### Linux Go Lang installation instructions +Linux users can go to https://golang.org/dl/ to get the appropriate archive. +Locate the appropriate archive file, download it, then run the command +"tar -C /usr/local -xzf go.archive.file.tar.gz" + +Then run the command "export PATH=$PATH:/usr/local/go/bin" to set your envrionment variable. + +### End Pre-requisites The commands ahead assumes that you have Golang installed and a recent version of Python 2, `setuptools` and `pip`. From 1b48eaabd2a87bc7493b51ba04a8b6fcc35cd991 Mon Sep 17 00:00:00 2001 From: Aaron Johnson Date: Wed, 24 Oct 2018 16:13:59 -0700 Subject: [PATCH 2/4] Updated README.md --- README.md | 73 ++++++++++++++++++------------------------------------- 1 file changed, 24 insertions(+), 49 deletions(-) diff --git a/README.md b/README.md index b756eb27..28328926 100644 --- a/README.md +++ b/README.md @@ -59,68 +59,43 @@ There are three basic categories of incomplete functionality: ### Pre-requisites Python 2.7 - *pip - *setuptools -Go 1.10+ - -### Windows Python 2.7 installation instructions - -Windows users can download Python2.7 from https://www.python.org/downloads/release/python-2715/ -once downloaded run the installer and follow along with the prompts. After installing Python 2.7 -open the command line and type "python -m pip install --upgrade setuptools pip". -### Mac Python 2.7 installation instructions -OSX users can go to https://www.python.org/downloads/release/python-2713/ -locate the appropriate installer for your system, run the installer and -follow along with the prompt. Once installed open a terminal and run the command -"python -m pip --version" if this command returns "pip [somenumber] then pip installed -and you can run the command "python -m pip install --upgrade pip setuptools". If the -command does not return that or states that pip isn't installed on your system run -the command "sudo easy_install pip" then run the command "python -m pip install --upgrade pip setuptools". +pip -### Linux Python 2.7 installation instructions -Almost all linux operating systems come bundled with Python 2.7 with the exception of -a few such as Arch linux (in some cases). To check your version of python run the command(s) -"python --version" if this command returns python 3+ then run the command "python2 --version" -if this command returns python 2.7+ then you already have python installed on your system. -If python 2.7 is already installed on your system run the command "python -m pip --version" -or "python2 -m pip --version", which you determined above. If it reutnrs a version number for pip -you can skip the following step, otherwise run the command "sudo apt install python-pip". Replace apt -with your respective package tool. +setuptools -Once that's done run the command "python (or python2) -m pip install --upgrade pip setuptools". - -If you do not have Python 2.7+ on your system, it's sugessted that you follow this guide to setup -python 2 in a virtual environment https://virtualenv.pypa.io/en/stable/installation/ . If you'd -prefer to just install it normally run the command "sudo apt install python2.7 python-pip" -Note: replace apt with your respective package tool Ie, sudo pacman -Syu python2.7, -sudo yum install python2.7 etc.. +Go 1.10+ -Then run the command "python -m pip install --upgrade pip setuptools". -### Windows GO lang installation instructions +### Mac Python 2.7 installation instructions +OSX users can go to https://www.python.org/downloads/release/python-2713/ -Windows users can go to https://golang.org/dl/ locate the appropriate installer for your -system, select a Go version >= 1.10, download the installer then simply follow the prompts. +Once you've succesfull installed Python2.7 please ensure that pip is also +instaleld on your system by running the "python -m pip --version" command. +If pip is not installed please follow the instructions found here +https://pip.pypa.io/en/stable/installing/# +Once pip has succesfully been installed please run the following command +"python -m pip install --upgrade pip setuptools". -### OSX GO Lang installation instructions +### Linux Python 2.7 installation instructions +Run the command "python --version" if this command returns Python2.7 +then it's already installed. If it returns python3+ then run the command +"sudo apt install python2.7" Note: Replace "apt" with your package tool. -OSX users can go to https://golang.org/dl/ locate the appropriate instaler for your system -download the installer and follow the prompts. +Next ensure that pip is installed by running "python -m pip --version" +or, "python2 -m pip version". If it returns pip [version number] then +pip is already installed. If it doesn't run the command "sudo apt install python-pip" -Once installed set your environment variable for go export GOPATH=$HOME/go +Once pip has been succesfully installed run the command "python -m pip install --upgrade pip setuptools" +### GO Lang installation instructions -You can also download the archive and extract it to /sr/local by running the command -"tar -C /usr/local -xzf go.archive.file.tar.gz" You still have to set the environment variable -by running the command "export GOPATH=$HOME/go/bin" +Note: Please download Go 1.10+ +Go lang can be downloaded here: https://golang.org/dl/ -### Linux Go Lang installation instructions -Linux users can go to https://golang.org/dl/ to get the appropriate archive. -Locate the appropriate archive file, download it, then run the command -"tar -C /usr/local -xzf go.archive.file.tar.gz" +please see the official go installation documentation to install Go: https://golang.org/doc/install -Then run the command "export PATH=$PATH:/usr/local/go/bin" to set your envrionment variable. +If you wish to build Go from source see the documentation here: https://golang.org/doc/install/source ### End Pre-requisites From 149cce74d11f773574ad8e67d7d74628a0b152b6 Mon Sep 17 00:00:00 2001 From: Aaron Johnson Date: Wed, 24 Oct 2018 16:14:49 -0700 Subject: [PATCH 3/4] Updated README.md --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index 28328926..04c4767a 100644 --- a/README.md +++ b/README.md @@ -97,7 +97,6 @@ please see the official go installation documentation to install Go: https://gol If you wish to build Go from source see the documentation here: https://golang.org/doc/install/source -### End Pre-requisites The commands ahead assumes that you have Golang installed and a recent version of Python 2, `setuptools` and `pip`. From 159c4f1cd4aafbc968768249f6a709699f90dc1b Mon Sep 17 00:00:00 2001 From: Aaron Johnson Date: Wed, 24 Oct 2018 16:19:25 -0700 Subject: [PATCH 4/4] Updated README.md --- README.md | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 04c4767a..efbe35c3 100644 --- a/README.md +++ b/README.md @@ -59,19 +59,15 @@ There are three basic categories of incomplete functionality: ### Pre-requisites Python 2.7 - pip - setuptools - Go 1.10+ - ### Mac Python 2.7 installation instructions OSX users can go to https://www.python.org/downloads/release/python-2713/ Once you've succesfull installed Python2.7 please ensure that pip is also -instaleld on your system by running the "python -m pip --version" command. +installed on your system by running the command "python -m pip --version". If pip is not installed please follow the instructions found here https://pip.pypa.io/en/stable/installing/# @@ -85,15 +81,15 @@ then it's already installed. If it returns python3+ then run the command Next ensure that pip is installed by running "python -m pip --version" or, "python2 -m pip version". If it returns pip [version number] then -pip is already installed. If it doesn't run the command "sudo apt install python-pip" +pip is already installed. If it doesn't run the command "sudo apt install python-pip". +Note: Again, replace apt with the appropriate package tool. Once pip has been succesfully installed run the command "python -m pip install --upgrade pip setuptools" ### GO Lang installation instructions - Note: Please download Go 1.10+ Go lang can be downloaded here: https://golang.org/dl/ -please see the official go installation documentation to install Go: https://golang.org/doc/install +Please see the official go installation documentation to install Go: https://golang.org/doc/install If you wish to build Go from source see the documentation here: https://golang.org/doc/install/source