Add dev environment in a yaml file

.gitignore

@@ -86,3 +86,6 @@ ENV/
 .ropeproject
 
 .DS_Store
+
+# pycharm
+.idea

README.md

@@ -10,40 +10,26 @@ Python remapping tools for climate and earth system models.
 
 ## Installation
 
-To use the latest version for developers, you will need to set up a conda
-environment with the following packages:
-
- * python >= 3.6
- * numpy
- * scipy
- * netcdf4
- * xarray >= 0.10.0
- * dask
- * nco >= 4.8.1
- * pyproj
+To use the latest version for developers, get the code from:
+[https://github.com/MPAS-Dev/pyremap](https://github.com/MPAS-Dev/pyremap)
 
-These can be installed via the conda command:
+Then, you will need to set up a conda environment and install the package
+in a way that points to the repo (so changes you make are available in the
+conda environment):
 ```
 conda config --add channels conda-forge
 conda config --set channel_priority strict
-conda create -n pyremap python=3.7 numpy scipy netcdf4 "xarray>=0.10.0" dask \
-    "nco>=4.8.1" pyproj
+conda create -n pyremap
 conda activate pyremap
+conda env update -n pyremap -f dev_environment.yaml
+python -m pip install -e .
 ```
 
-Then, get the code from:
-[https://github.com/MPAS-Dev/pyremap](https://github.com/MPAS-Dev/pyremap)
-
-
 ## Examples
 
 ```
 cd examples
 ```
-The simplest way to make pyremap available is:
-```
-ln -s ../pyremap
-```
 First, make mapping files for a lat-lon grid, and test it out by remapping
 temperature from the example file:
 ```

azure-pipelines.yml

@@ -18,12 +18,12 @@ jobs:
     vmImage: 'ubuntu-16.04'
   strategy:
     matrix:
-      Python36:
-        python.version: '3.6'
       Python37:
         python.version: '3.7'
       Python38:
         python.version: '3.8'
+      Python39:
+        python.version: '3.9'
 
   steps:
   - bash: echo "##vso[task.prependpath]$CONDA/bin"
@@ -131,12 +131,12 @@ jobs:
     vmImage: 'macOS-10.14'
   strategy:
     matrix:
-      Python36:
-        python.version: '3.6'
       Python37:
         python.version: '3.7'
       Python38:
         python.version: '3.8'
+      Python39:
+        python.version: '3.9'
 
   steps:
   - bash: echo "##vso[task.prependpath]$CONDA/bin"

ci/python3.6.yaml → ci/python3.9.yaml

@@ -5,4 +5,4 @@ pin_run_as_build:
     min_pin: x.x
     max_pin: x.x
 python:
-- '3.6'
+- '3.9'

dev_environment.yaml

@@ -0,0 +1,23 @@
+name: pyremap_dev
+channels:
+  - conda-forge
+  - defaults
+dependencies:
+  # Base
+  - python >=3.6
+  - dask
+  - esmf
+  - nco >=4.8.1
+  - netcdf4
+  - numpy
+  - scipy
+  - pyproj
+  - xarray >=0.10.0
+  # Development
+  - pip
+  # Documentation
+  - mock
+  - pillow
+  - sphinx
+  - sphinx_rtd_theme
+  - m2r

docs/.gitignore

@@ -0,0 +1,3 @@
+/generated
+/_build
+/quick_start.rst