Merge 3b419e0 into 453c8ef

.github/pull_request_template.md

@@ -22,13 +22,16 @@ Please describe the tests that you ran to verify your changes. Provide
 instructions so we can reproduce. Please also list any relevant details for
 your test configuration
 
-- [ ] Test A
-- [ ] Test B
+```
+import ocbpy
+# Do a thing
+```
 
-**Test Configuration**:
-- Operating system
-- Version number
-- Any details about your local setup that are relevant
+## Test Configuration
+
+- Operating system: (Hal)
+- Version number: (Python 1.0)
+- Any details about your local setup that are relevant: (e.g., pysat version)
 
 # Checklist:
 
@@ -43,4 +46,4 @@ your test configuration
 - [ ] New and existing unit tests pass locally with my changes
 - [ ] Any dependent changes have been merged and published in downstream modules
 - [ ] Add a note to ``Changelog.rst``, summarising the changes
-- [ ] Add yourself to ``AUTHORS.rst``
+- [ ] Add yourself to ``AUTHORS.rst`` and ``.zenodo.json``

.github/workflows/docs.yml

@@ -0,0 +1,44 @@
+# This workflow will run doc tests for a single Python version. For more
+# information see:
+# https://help.github.com/actions/language-and-framework-guides/
+# using-python-with-github-actions
+
+
+name: Documentation Check
+
+on: [push, pull_request]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.9"]
+
+    name: Documentation tests
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Set CDF Lib environment variable
+      run: echo "CDF_LIB=$HOME/lib" >> $GITHUB_ENV
+
+    - name: Install standard and test dependencies, then ocbpy
+      run: |
+        pip install -r docs/requirements.txt sphinx sphinx_rtd_theme numpydoc
+        bash requirements.extra 2
+        python setup.py install
+
+    - name: Check documentation build
+      run: sphinx-build -E -b html docs dist/docs
+
+    - name: Check documentation links
+      run: sphinx-build -b linkcheck docs dist/docs
+
+    - name: Load .zenodo.json to check for errors
+      run: python -c "import json; json.loads(open('.zenodo.json').read())"

.github/workflows/main.yml

@@ -0,0 +1,45 @@
+# This workflow will install Python dependencies, run tests and lint with a
+# variety of Python versions. For more information see:
+# https://help.github.com/actions/language-and-framework-guides/
+# using-python-with-github-actions
+
+name: unittest with flake8
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.7", "3.8", "3.9", "3.10"]
+
+    name: Python ${{ matrix.python-version }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install standard and test dependencies, then ocbpy
+      run: |
+        pip install -r requirements.txt
+        bash requirements.extra 0
+        python setup.py install
+
+    - name: Test PEP8 compliance
+      run: flake8 . --count --show-source --statistics
+
+    - name: Evaluate complexity
+      run: flake8 . --count --exit-zero --max-complexity=10 --statistics
+
+    - name: Run unit and integration tests
+      run: coverage run --rcfile=setup.cfg -m unittest discover
+
+    - name: Publish results to coveralls upon success
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: coveralls --rcfile=setup.cfg --service=github

.github/workflows/pysat.yml

@@ -0,0 +1,39 @@
+# This workflow will install Python dependencies, run tests for pysat-ocbpy
+# with a variety of Python versions. For more information see:
+# https://help.github.com/actions/language-and-framework-guides/
+# using-python-with-github-actions
+
+name: pysat unittest with flake8
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.7", "3.8", "3.9", "3.10"]
+
+    name: Python ${{ matrix.python-version }} on ${{ matrix.os }} with pysat
+    runs-on: ${{ matrix.os }}
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install standard and test dependencies, then ocbpy
+      run: |
+        pip install -r requirements.txt
+        bash requirements.extra 1
+        python setup.py install
+
+    - name: Run unit and integration tests
+      run: coverage run --rcfile=setup.cfg -m unittest discover
+
+    - name: Publish results to coveralls
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: coveralls --rcfile=setup.cfg --service=github

.github/workflows/ssj.yml

@@ -0,0 +1,44 @@
+# This workflow will install Python dependencies, run tests for DMSP-ocbpy
+# with a variety of Python versions. For more information see:
+# https://help.github.com/actions/language-and-framework-guides/
+# using-python-with-github-actions
+
+name: DMSP-SSJ unittest with flake8
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        python-version: ["3.7", "3.8", "3.9", "3.10"]
+
+    name: Python ${{ matrix.python-version }} on ${{ matrix.os }} with DMSP-SSJ
+    runs-on: ${{ matrix.os }}
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Set CDF Lib environment variable
+      run: echo "CDF_LIB=$HOME/lib" >> $GITHUB_ENV
+
+    - name: Install standard and test dependencies, then ocbpy
+      env:
+        CDF_LIB: $HOME/lib
+      run: |
+        pip install -r requirements.txt
+        bash requirements.extra 2
+        python setup.py install
+
+    - name: Run unit and integration tests
+      run: coverage run --rcfile=setup.cfg -m unittest discover
+
+    - name: Publish results to coveralls
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: coveralls --rcfile=setup.cfg --service=github

.github/workflows/windows.yml

@@ -0,0 +1,39 @@
+# This workflow will install Python dependencies, run tests on Windows with a
+# variety of Python versions. For more information see:
+# https://help.github.com/actions/language-and-framework-guides/
+# using-python-with-github-actions
+
+name: Windows unittest with flake8
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest]
+        python-version: ["3.8", "3.9"]
+
+    name: Python ${{ matrix.python-version }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install standard and test dependencies, then ocbpy
+      run: |
+        pip install -r requirements.txt
+        bash requirements.extra 0
+        python setup.py install
+
+    - name: Run unit and integration tests
+      run: coverage run --rcfile=setup.cfg -m unittest discover
+
+    - name: Publish results to coveralls
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: coveralls --rcfile=setup.cfg --service=github

.zenodo.json

@@ -0,0 +1,36 @@
+{
+    "license": {
+      "id": "bsd-license"
+    },
+    "keywords": [
+	"magnetic coordinates", 
+	"coordinate-transformation", 
+	"coordinate-systems", 
+	"space", 
+	"space-physics", 
+	"ionosphere", 
+	"magnetosphere",
+	"Conversion",
+	"Coordinate Conversion", 
+	"Converting",
+	"Magnetic Field",
+	"Space Physics",
+	"Heliophysics"
+    ],
+    "creators": [
+      {
+        "orcid": "0000-0001-8875-9326", 
+        "affiliation": "Naval Research Laboratory", 
+        "name": "Angeline G. Burrell"
+      },
+      {
+        "orcid": "0000-0003-1151-5934", 
+        "affiliation": "British Antarctic Survey", 
+        "name": "Gareth Chisham"
+      },
+      {
+        "affiliation": "Birkeland Centre for Space Science", 
+        "name": "Jone Reistad"
+      }
+    ]
+}

CODE_OF_CONDUCT.md

@@ -42,5 +42,5 @@ Project maintainers who do not follow or enforce the Code of Conduct in good fai
 
 This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
 
-[homepage]: http://contributor-covenant.org
-[version]: http://contributor-covenant.org/version/1/4/
+[homepage]: https://contributor-covenant.org
+[version]: https://contributor-covenant.org/version/1/4/

CODE_OF_CONDUCT.rst

@@ -78,5 +78,5 @@ Attribution
 This Code of Conduct is adapted from the Contributor Covenant [homepage]_,
 version [1.4]_.
 
-.. [homepage] http://contributor-covenant.org
-.. [1.4] http://contributor-covenant.org/version/1/4/
+.. [homepage] https://contributor-covenant.org
+.. [1.4] https://contributor-covenant.org/version/1/4/