pulled master

Author: tanaes

README.md

@@ -1,2 +1,27 @@
 # opentrons_functions
-A collection of functions compatible with the Opentrons API
+A collection of functions compatible with the Opentrons API.
+
+## Installation
+
+To install on your Unix-based machine, you can simply point `pip` to this git repository:
+
+```{bash}
+pip install git+https://github.com/tanaes/opentrons_functions.git
+```
+
+The easiest way to install this library is via the Jupyter Notebook server on your OT-2. Follow the [instructions on the Opentrons site](https://support.opentrons.com/en/articles/1795367-running-the-robot-using-jupyter-notebook) for connecting.
+
+Then, use the Jupyter interface to launch a new terminal. On the right side of the screen, click the 'New' button, and select 'Terminal.' This will give you terminal access to the OT-2 Linux system.
+
+![jupyter new terminal interface screenshot](./doc/assets/jupyter_new_terminal.png)
+
+The OT-2 does not have `git` installed, so you must point `pip` to one of the [release](https://github.com/tanaes/opentrons_functions/releases) tarballs instead. For example:
+
+```{bash}
+pip install https://github.com/tanaes/opentrons_functions/archive/v0.1.0-pre
+release.tar.gz
+```
+
+If this is successful, you should see a long dialogue of dependencies (most or all should already be installed):
+
+![pip installation screenshot](./doc/assets/jupyter_pip_log.png)

doc/assets/jupyter_new_terminal.png

@@ -2,7 +2,7 @@
 
 setup(
     name='opentrons_functions',
-    version='0.1.0',
+    version='0.2.0',
     description='A collection of functions compatible with the Opentrons API',
     url='https://github.com/tanaes/opentrons_functions',
     author='Jon G Sanders',
@@ -20,6 +20,7 @@
         'Operating System :: POSIX :: Linux',
         'Operating System :: MacOS :: MacOS X'
         'Programming Language :: Python :: 3.5',
-        'Programming Language :: Python :: 3.6'
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7'
     ],
 )

doc/assets/jupyter_pip_log.png

@@ -1,4 +1,4 @@
-from opentrons_functions.util import (odd_or_even)
+from opentrons_functions.util import odd_or_even
 
 
 def test_odd_or_even():