Remove grunt dependency, update docs, add coverage

.dockerignore

+.coverage
 .DS_Store
 node_modules
 *.pyc
-conf
+coverage.xml
\ No newline at end of file

.flake8

+[flake8]
+count = True
+exclude = .git,__pycache,node_modules
+# This project uses PEP8 with the following exceptions:
+# - continuation lines should use 2 levels of indentation (8 spaces)
+#   E122: continuation line missing indentation or outdented
+#   E126: continuation line over-indented for hanging indent
+#   E127: continuation line over-indented for visual indent
+#   E128: continuation line under-indented for visual indent
+#   E131: continuation line unaligned for hanging indent
+# - short variables should be avoided, but not currently enforced
+#   E741: do not use variables named ‘l’, ‘O’, or ‘I’
+ignore = E122, E126, E127, E128, E131, E741

.gitignore

+.coverage
 .DS_Store
 node_modules
 *.pyc
-conf
+coverage.xml

.jshintrc

-{
-  "bitwise": true,
-  "curly": true,
-  "eqeqeq": true,
-  "immed": true,
-  "latedef": true,
-  "newcap": true,
-  "noarg": true,
-  "newcap": false,
-  "quotmark": "single",
-  "undef": true,
-  "unused": true,
-  "strict": true,
-  "trailing": true,
-
-  "smarttabs": true,
-
-  "browser": true,
-  "node": true
-}

.travis.yml

@@ -5,6 +5,7 @@ python:
   - 2.7
   - 3.4
   - 3.5
+  - 3.6
 before_install:
   ## courtesy of http://conda.pydata.org/docs/travis.html
   - if [[ "$TRAVIS_PYTHON_VERSION" == "2.7" ]]; then
@@ -18,15 +19,13 @@ before_install:
   - conda config --set always_yes yes --set changeps1 no
   - conda update --yes conda
   - conda info -a
-  ## back to other dependencies
-  - nvm install v4.2.4
-  - nvm use 4.2.4
-  - npm install -g grunt-cli
-  - npm --version
-  - node --version
 install:
   - conda config --add channels conda-forge
   - conda create -q -n test-environment python=$TRAVIS_PYTHON_VERSION obspy pycurl nose flake8
   - source activate test-environment
-  - npm install
-script: grunt lint test
+script:
+  - flake8 -v bin/ geomagio/ test/
+  - nosetests -v .
+after_success:
+  - nosetests --with-coverage --cover-package=geomagio --cover-xml
+  - bash <(curl -s https://codecov.io/bash)

Gruntfile.js

-'use strict';
-
-module.exports = function (grunt) {
-  var config = require('./gruntconfig');
-
-  config.tasks.forEach(grunt.loadNpmTasks);
-  grunt.initConfig(config);
-
-  grunt.registerTask('lint', [
-    'flake8',
-    'jshint'
-  ]);
-
-  grunt.registerTask('test', [
-    'nose:main'
-  ]);
-
-  grunt.registerTask('default', [
-    'clean',
-    'lint',
-    'test',
-    'watch'
-  ]);
-};

README.md

@@ -104,7 +104,6 @@ Docker is the simplest install option.
         http://localhost:8000/?token=TOKEN
     ```
 
-
 3. Use the running container
 
   - Run the `geomag.py` command line interface:

docs/develop.md

@@ -2,50 +2,64 @@ Development Dependencies
 ========================
 
 These instructions only need to be completed if you plan on developing new
-code for this project.
+code for this project, and may also be used to run a local copy of the code.
 
-If developing on windows, see the [Windows](#windows) section below.
 
 Begin Developing
 ----------------
 
-1. Use npm to install `grunt-cli`
+1. Install `obspy`, `pycurl`, `flake8`, and `nose`.
+> Using Anaconda is recommended ( https://conda.io/miniconda.html ).
 
-        npm install -g grunt-cli
+        conda config --add channels conda-forge
+        conda create --name geomagenv obspy pycurl flake8 nose
+        source activate geomagenv
 
-2. Install `numpy`, `scipy`, `obspy`, and `flake8` if they aren't already
-   installed.
+2. Fork this project on Github ( https://guides.github.com/activities/forking/ ).
 
-3. Clone this project (or fork and clone your fork)
+        https://github.com/{YOUR_GITHUB_ACCOUNT}/geomag-algorithms.git
 
-        git clone https://github.com/usgs/geomag-algorithms.git
+3. Clone your fork
 
-4. From root directory of project, install npm dependencies
+        git clone https://github.com/{YOUR_GITHUB_ACCOUNT}/geomag-algorithms.git
+        cd geomag-algorithms
+        git remote add upstream https://github.com/usgs/geomag-algorithms.git
+
+4. Use branches to develop new features and submit pull requests.
 
-        npm install
 
-5. Run grunt to run unit tests, and watch for changes to python files
+Developer Tools
+---------------
 
-        grunt
+- **Linting errors**
+Check for linting errors using Flake8
 
+        cd geomag-algorithms
+        flake8
 
-### Windows
+- **Unit tests**
+Run unit tests using Nose
 
-1. Install the newest release of Node
-   [(http://nodejs.org/download/)](http://nodejs.org/download/) for  Windows,
-   using the Windows Installer (.msi).
+        cd geomag-algorithms
+        nosetests
 
-1. Close and re-open your terminal so that your new PATH is loaded.
+- **Automatically run linting and tests while developing**
+(Requires NodeJS)
 
+        cd geomag-algorithms
+        npm install
+        npm run watch
 
-### Coding Standards
+
+Coding Standards
+----------------
 
 This project adheres to PEP8 standards in most cases:
     https://www.python.org/dev/peps/pep-0008
 
-#### PEP8 Exceptions
+**PEP8 Exceptions**
 
-- Hanging/Visual indents (E126, E127, E128, E131)
+- Hanging/Visual indents (E122, E126, E127, E128, E131)
 
     - line continuations should use two indentations (8 spaces).
     - do not use visual indents.

docs/install.md

 Installation
 ============
 
-We recommend using virtual environments:
-[(http://docs.python-guide.org/en/latest/dev/virtualenvs/)](http://docs.python-guide.org/en/latest/dev/virtualenvs/)
+Using Anaconda is recommended ( https://conda.io/miniconda.html ).
 
-[Mac](#mac) and [Windows](#windows) specific details are below.
 
-1. Install __geomagio__
+1) Install Anaconda/Miniconda
 
-       pip install git+https://github.com/usgs/geomag-algorithms.git
+2) Create a virtual environment
 
-1. Use __geomagio__
+        conda config --add channels conda-forge
+        conda create --name geomagenv obspy pycurl flake8 nose
+        source activate geomagenv
 
-  - Use the main script, `geomag.py -h`
-  - In python scripts, `import geomagio`
-
-The [Command Line Usage](./usage.md) and [Python API](./api.md)
-pages have more instructions and examples.
-
-
----
-### Mac ###
-
-1. Install `python` (2.7.X)
-
-   On OS X, we recommend using Homebrew [http://brew.sh/](http://brew.sh/)
-
-1. Install numpy, obspy requires this be installed separately.
-
-        pip install numpy
-
-1. Install `node`, `git` and `python` (2.7.X).
+3) Install **geomagio**
 
-   On OS X, we recommend using Homebrew
-```
-brew install node
-brew install git
-```
+        pip install git+https://github.com/usgs/geomag-algorithms.git
 
-1. Use pip to install `numpy`, `scipy`, `obspy`, and `flake8`
+4) Use **geomagio**
 
-        pip install numpy scipy obspy flake8
-
-1. Update paths as needed in your `~/.bash_profile`:
-
-        export PATH=$PATH:/usr/local/bin
-        # npm installed binaries
-        export PATH=$PATH:/usr/local/share/npm/bin
-        # gem installed binaries
-        export PATH=$PATH:/usr/local/opt/ruby/bin
-
-1. Close and re-open your terminal so that your new PATH is loaded.
-   Make sure to navigate back to your `geomag-algorithms` project directory.
-
-
----
-### Windows ###
-
-1. You will need a terminal tool for Windows. We recommend Git Bash
-   [(http://git-scm.com/download/win)](http://git-scm.com/download/win), but
-   another unix-like editor should work too.
-
-1. Install Anaconda
-   [(http://continuum.io/downloads)](http://continuum.io/downloads), which
-   includes `numpy`, `scipy` and `flake8`.
-
-1. Run `python` to verify that Anaconda's version of Python is being used.
-   If it isn't, update your PATH so that Conda's HOME is before any other
-   versions of Python.
+  - Use the main script, `geomag.py -h`
+  - In python scripts, `import geomagio`
+  - Install the Jupyter notebook server ( http://jupyter.org/install.html )

etc/DOIRootCA2.crt

------BEGIN CERTIFICATE-----
-MIIJ+jCCB+KgAwIBAgIQSeV7u0WVHrFBqkjcKiEnEzANBgkqhkiG9w0BAQsFADAV
-MRMwEQYDVQQDEwpET0lSb290Q0EyMB4XDTE2MDQyNjE4MjE1MFoXDTM2MDQyNjE4
-MjE1MFowFTETMBEGA1UEAxMKRE9JUm9vdENBMjCCAiIwDQYJKoZIhvcNAQEBBQAD
-ggIPADCCAgoCggIBANTHy0AvCFT0CZOsktj3kpFfFJgrhiS5haBK7DvYYpbZoaWa
-jOpldnvoqnd1bOJUJ9jUwxZERo27FJHZ8HSdU8ac63hdK1N6t1OrlQOjgs/Kn0LY
-b7xOf6iDBfhdhXcjpq2KZBzVi0tWuyBPhDmZyTLqZ5UREy1mV3/p1pJ3Hx5lPziH
-Fid+wILxe2fk+N1ExY/GA+cgdsSCP4kp4aBxXLNTq+oMu/NahyF+NmcbqUk3xh+v
-U1UA7h35b8kjd/3Kx2Bv1EDveWbzaS7sn8T3OVnU6n9UObUcqaoJOXF3PDdQqPIh
-YVLT8/s15YaUznTe7jc46YjnqZPaJJGbDir/m03QR8qWi0qMhLjTTfPYe4DFYa27
-4e8sTeK0DTSpUMBhQqagRQEFcYRd6QaZ4wfj+8zwX7EUha9jOKrMALvxRurkEqsa
-m9NZntaHlSkRjQAZ562TUYowBpb841O0v0c9+i8SM6D9kRVV+NIj3StPNkQG7qlc
-+PhF5YA4jYAifZ7AtWraLeopTPonfX0avWbIt5ryy4Y+sISwsg4HZ+rdNrJq9MUu
-YWDbdO/lRclnFJ64VmD0rH7Fuef7CDiQvwn0NPJHQoU6h/zHnfOEIlh44h+0uy+R
-lEp41vrb9mA/a7ZZEohcJroQ6JL1Z8b+KLY47ryuqneLklCVTGbMNGZxusOtAgMB
-AAGjggVEMIIFQDALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4E
-FgQUv4YryvNsbT5fHDtOTtiN52rHak8wEAYJKwYBBAGCNxUBBAMCAQAwggTtBgNV
-HSAEggTkMIIE4DCCAg8GCWCGSAFlAwIBEzCCAgAwMAYIKwYBBQUHAgEWJGh0dHA6
-Ly9wa2kyLmRvaS5uZXQvbGVnYWxwb2xpY3kuYXNwADCCAcoGCCsGAQUFBwICMIIB
-vB6CAbgAQwBlAHIAdABpAGYAaQBjAGEAdABlACAAaQBzAHMAdQBlAGQAIABiAHkA
-IAB0AGgAZQAgAEQAZQBwAGEAcgB0AG0AZQBuAHQAIABvAGYAIAB0AGgAZQAgAEkA
-bgB0AGUAcgBpAG8AcgAgAGEAcgBlACAAbwBuAGwAeQAgAGYAbwByACAAaQBuAHQA
-ZQByAG4AYQBsACAAdQBuAGMAbABhAHMAcwBpAGYAaQBlAGQAIABVAFMAIABHAG8A
-dgBlAHIAbgBtAGUAbgB0ACAAdQBzAGUAIABhAGwAbAAgAG8AdABoAGUAcgAgAHUA
-cwBlACAAaQBzACAAcAByAG8AaABpAGIAaQB0AGUAZAAuACAAVQBuAGEAdQB0AGgA
-bwByAGkAegBlAGQAIAB1AHMAZQAgAG0AYQB5ACAAcwB1AGIAagBlAGMAdAAgAHYA
-aQBvAGwAYQB0AG8AcgBzACAAdABvACAAYwByAGkAbQBpAG4AYQBsACwAIABjAGkA
-dgBpAGwAIABhAG4AZAAvAG8AcgAgAGQAaQBzAGMAaQBwAGwAaQBuAGEAcgB5ACAA
-YQBjAHQAaQBvAG4ALjCCAskGCmCGSAFlAwIBEwEwggK5MDUGCCsGAQUFBwIBFilo
-dHRwOi8vcGtpMi5kb2kubmV0L2xpbWl0ZWR1c2Vwb2xpY3kuYXNwADCCAn4GCCsG
-AQUFBwICMIICcB6CAmwAVQBzAGUAIABvAGYAIAB0AGgAaQBzACAAQwBlAHIAdABp
-AGYAaQBjAGEAdABlACAAaQBzACAAbABpAG0AaQB0AGUAZAAgAHQAbwAgAEkAbgB0
-AGUAcgBuAGEAbAAgAEcAbwB2AGUAcgBuAG0AZQBuAHQAIAB1AHMAZQAgAGIAeQAg
-AC8AIABmAG8AcgAgAHQAaABlACAARABlAHAAYQByAHQAbQBlAG4AdAAgAG8AZgAg
-AHQAaABlACAASQBuAHQAZQByAGkAbwByACAAbwBuAGwAeQAuACAARQB4AHQAZQBy
-AG4AYQBsACAAdQBzAGUAIABvAHIAIAByAGUAYwBlAGkAcAB0ACAAbwBmACAAdABo
-AGkAcwAgAEMAZQByAHQAaQBmAGkAYwBhAHQAZQAgAHMAaABvAHUAbABkACAAbgBv
-AHQAIABiAGUAIAB0AHIAdQBzAHQAZQBkAC4AIABBAGwAbAAgAHMAdQBzAHAAZQBj
-AHQAZQBkACAAbQBpAHMAdQBzAGUAIABvAHIAIABjAG8AbQBwAHIAbwBtAGkAcwBl
-ACAAbwBmACAAdABoAGkAcwAgAGMAZQByAHQAaQBmAGkAYwBhAHQAZQAgAHMAaABv
-AHUAbABkACAAYgBlACAAcgBlAHAAbwByAHQAZQBkACAAaQBtAG0AZQBkAGkAYQB0
-AGUAbAB5ACAAdABvACAAYQAgAEQAZQBwAGEAcgB0AG0AZQBuAHQAIABvAGYAIAB0
-AGgAZQAgAEkAbgB0AGUAcgBpAG8AcgAgAFMAZQBjAHUAcgBpAHQAeQAgAE8AZgBm
-AGkAYwBlAHIALjANBgkqhkiG9w0BAQsFAAOCAgEAF/q4Z2mRTIYJMu5mzlWsbV4o
-gGQJ9YcSdUZRq2vzINJCpGDXstAIE81Pfz/Fna98KOkjEB8XGXVUGQf07c9ylGJS
-XFoBwcN8GgOuys5iiP9/yd2yLHB8rBb8pu9RForl9RoTsYY8nFuOOtl9o2EfB/1O
-PbRYkfHhhqrfvvHdvDKWPmT+ZhaliWJrg2my432yqBqPePjqMZSl4sxiPYi9WicU
-UWYdJpxQlys3igICD4GXOcSh316jfaqfN8+9jps+lgO7rqOA41B8fU9Gwi4B8jjx
-Tw0pgvbuebwwL5IQwrsGcA8rFfRPR6CaSY5v3XXqTMbCXyYjNK1/44I9MoFFaFPc
-e3cqZ5cQ+lCoW3UE0SLNZb3YKh28ES/Gi5CO0Bq5P8QVLRJQL5xOaSzV9blszHv5
-okR+lkSsVo2QzR/mzFD7lXtwznkd/uak0hripTB7MtZenBzoQ8zAgjgw5TXjRSAZ
-goWiJTAg+YTKclhJ7Cfg/m4XeCxzNgz/pU1XEdBF2Ngvp3C9M5CSBcqzb234uiFF
-SyvJl/6erDTkQ5dLrnSnsJIw1ZS/XG/Fi41u8il0piLc5depTLn9qiWf29BRBEtG
-xwFKSmqlRWsClj/zADirBTjcctw7ajPMkRpebgn+Bzv1eWDx4+OolQuR/a45644Q
-GHVtIa/kVEl2DE0WcUw=
------END CERTIFICATE-----

gruntconfig/clean.js

-'use strict';
-
-module.exports = {
-  pyc: [
-    '**/*.pyc'
-  ]
-};

gruntconfig/config.js

-'use strict';
-
-module.exports = {
-  bin: 'bin',
-  test: 'test'
-};

gruntconfig/flake8.js

-'use strict';
-
-module.exports = {
-  src: {
-    options: {
-      ignore: ['E122', 'E126', 'E127', 'E128', 'E131', 'E741']
-    },
-    src: [
-      'bin/*.py',
-      'geomagio/**/*.py'
-    ]
-  },
-
-  test: {
-    options: {
-      ignore: ['E122', 'E126', 'E127', 'E128', 'E131', 'E741']
-    },
-    src: [
-      'test/**/*.py'
-    ]
-  }
-};

gruntconfig/index.js

-'use strict';
-
-module.exports = {
-  clean: require('./clean'),
-  flake8: require('./flake8'),
-  jshint: require('./jshint'),
-  nose: require('./nose'),
-  watch: require('./watch'),
-  // task node module names
-  tasks: [
-    'grunt-contrib-clean',
-    'grunt-contrib-jshint',
-    'grunt-contrib-watch',
-    'grunt-flake8',
-    'grunt-nose'
-  ]
-};

gruntconfig/jshint.js

-'use strict';
-
-module.exports = {
-  options: {
-    jshintrc: '.jshintrc'
-  },
-  gruntfile: [
-    'Gruntfile.js',
-    'gruntconfig/**/*.js'
-  ]
-};

gruntconfig/nose.js

-'use strict';
-
-module.exports = {
-  main: {
-    options: {
-      match: '[Tt]est',
-      verbose: true,
-      include: 'test/*/*.py'
-    }
-  }
-};

gruntconfig/watch.js

-'use strict';
-
-module.exports = {
-  gruntfile: {
-    files: [
-      'Gruntfile.js',
-      'gruntconfig/**/*.js'
-    ],
-    tasks: [
-      'jshint:gruntfile'
-    ]
-  },
-  scripts: {
-    files: [
-      'bin/**/*.py',
-      'geomagio/**/*.py'
-    ],
-    tasks: [
-      'flake8:src',
-      'test'
-    ]
-  },
-  tests: {
-    files: [
-      'test/**/*.py'
-    ],
-    tasks: [
-      'flake8:test',
-      'test'
-    ]
-  }
-};

package.json

@@ -19,18 +19,38 @@
     "geomag",
     "hazdev"
   ],
-  "scripts": {},
+  "scripts": {
+    "clean": "rimraf '**/*.pyc'",
+    "coverage": "nosetests --with-coverage --cover-package=geomagio --cover-xml",
+    "lint": "flake8 && echo \"No linting errors found\"",
+    "test": "nosetests -q test",
+    "watch": "npm-watch"
+  },
+  "watch": {
+    "lint": {
+      "extensions": "py",
+      "patterns": [
+        "bin",
+        "geomagio",
+        "test"
+      ]
+    },
+    "test": {
+      "extensions": "py",
+      "patterns": [
+        "bin",
+        "geomagio",
+        "test"
+      ]
+    }
+  },
   "license": "Public Domain",
   "dependencies": {},
   "devDependencies": {
-    "grunt": "^0.4.5",
-    "grunt-contrib-clean": "^0.7.0",
-    "grunt-contrib-jshint": "^0.10.0",
-    "grunt-contrib-watch": "^0.6.1",
-    "grunt-flake8": "^0.1.3",
-    "grunt-nose": "^0.4.0"
+    "npm-watch": "^0.3.0",
+    "rimraf": "^2.6.2"
   },
   "engines": {
-    "node": ">=0.1.0"
+    "node": ">=4"
   }
 }