Updated Installation, added workflow

.github/workflows/installation.yml

@@ -0,0 +1,56 @@
+name: Installation
+on: [push]
+
+jobs:
+  linux:
+    name: ${{ matrix.python-version }} - ${{ matrix.method }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version:
+          - '2.7'
+          - '3.6'
+          - '3.7'
+        method:
+          - 'python ./install.py'
+          - 'pip install --target /opt/rez .'
+        include:
+          - method: 'python ./install.py'
+            exports: 'PATH=${PATH}:/opt/rez/bin/rez'
+          - method: 'pip install --target /opt/rez .'
+            exports: 'PATH=${PATH}:/opt/rez/bin PYTHONPATH=${PYTHONPATH}:/opt/rez'
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@master
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v1
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install
+      run: |
+        ${{ matrix.method }}
+        find /opt/rez/ -maxdepth 2
+    
+    - name: rez status
+      run: |
+        export ${{ matrix.exports }}
+        rez status
+
+    - name: rez-pip --install .
+      run: |
+        export ${{ matrix.exports }}
+        rez-pip --install .
+        rez view rez
+    
+    - name: Import rez package in Python
+      run: |
+        export ${{ matrix.exports }}
+
+        # Still needed as there's no fallback to use system's python
+        rez bind python  
+        
+        echo "Checking rez as python package: ==========================================="
+        rez env rez -- python -c 'import rez;print(rez.__file__)'

wiki/pages/Installation.md

@@ -26,15 +26,25 @@ source /opt/rez/completion/complete.sh
 
 ## Installation Via Pip
 
-It is possible to install rez with pip, like so:
+It is possible to install rez with pip, like so (from source root directory):
 
 ```
-]$ pip install rez
+]$ pip install --target /opt/rez .
 ```
 
-However, this comes with a caveat - rez command line tools _are not guaranteed
-to work correctly_ once inside a rez environment (ie after using the `rez-env`
-command). The reasons are given in the next section.
+The environment variables to activate `rez` will be slightly different:
+
+- Add `/opt/rez/bin` to `PATH`
+- Add `/opt/rez` to `PYTHONPATH`
+
+Alternatively, if you already have `rez` setup and have `pip>=19` available, 
+you can then install `rez` as a `rez` package by using:
+
+    ]$ rez-pip --install .
+
+However, these methods comes with a caveat - rez command line tools _are not 
+guaranteed to work correctly_ once inside a rez environment (ie after using the 
+`rez-env` command). The reasons are given in the next section.
 
 Pip installation is adequate however, if all you require is the rez API, or you
 don't require its command line tools to be available within a resolved environment.