Merge branch 'development' into nested-var-dims

icesat2py · Oct 25, 2024 · 7571adb · 7571adb
2 parents 4a21836 + 23e3f7e
commit 7571adb
Show file tree

Hide file tree

Showing 39 changed files with 1,524 additions and 806 deletions.
diff --git a/.github/workflows/integration_test.yml b/.github/workflows/integration_test.yml
@@ -39,9 +39,7 @@ jobs:
           EARTHDATA_PASSWORD: "${{ secrets.EARTHDATA_PASSWORD }}"
           NSIDC_LOGIN: "${{ secrets.EARTHDATA_PASSWORD }}"
         run: |
-          pytest icepyx/ --verbose --cov app \
-            icepyx/tests/test_behind_NSIDC_API_login.py \
-            icepyx/tests/test_auth.py
+          pytest icepyx/tests/integration --verbose --cov app
 
       - name: "Upload coverage report"
         uses: "codecov/[email protected]"

diff --git a/.github/workflows/typecheck.yml b/.github/workflows/typecheck.yml
@@ -0,0 +1,29 @@
+name: Typecheck
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+      - development
+
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install package and test dependencies
+        run: |
+          python -m pip install .[complete]
+          python -m pip install -r requirements-dev.txt
+
+      - uses: jakebailey/pyright-action@v2
diff --git a/.github/workflows/unit_test.yml b/.github/workflows/unit_test.yml
@@ -8,6 +8,10 @@ on:
     branches:
       - "main"
       - "development"
+  workflow_run:
+    workflows: [Update UML diagrams]
+    types:
+      - completed
 
 
 jobs:
@@ -31,8 +35,7 @@ jobs:
       - name: "Run tests"
         run: |
           pytest icepyx/ --verbose --cov app \
-            --ignore=icepyx/tests/test_behind_NSIDC_API_login.py \
-            --ignore=icepyx/tests/test_auth.py
+            --ignore=icepyx/tests/integration
 
       - name: "Upload coverage report"
         uses: "codecov/[email protected]"

diff --git a/doc/source/conf.py b/doc/source/conf.py
@@ -32,13 +32,17 @@
 # ones.
 extensions = [
     "sphinx.ext.autodoc",
+    # IMPORTANT: napoleon must be loaded before sphinx_autodoc_typehints
+    # https://github.com/tox-dev/sphinx-autodoc-typehints/issues/15
+    "sphinx.ext.napoleon",
+    "sphinx_autodoc_typehints",
     "sphinx.ext.autosectionlabel",
     "numpydoc",
     # "sphinx.ext.autosummary",
     "myst_nb",
     "contributors",  # custom extension, from pandas
     "sphinxcontrib.bibtex",
-    "sphinx_panels",
+    "sphinx_design",
     # "sphinx.ext.imgconverter", # this extension should help the latex svg warning, but results in an error instead
 ]
 myst_enable_extensions = [
@@ -79,6 +83,31 @@
 nb_execution_mode = "off"
 suppress_warnings = ["myst.header"]  # suppress non-consecutive header warning
 
+
+# -- Options for Napoleon docstring parsing ----------------------------------
+napoleon_google_docstring = False
+napoleon_numpy_docstring = True
+napoleon_use_admonition_for_examples = True
+napoleon_use_admonition_for_notes = True
+
+
+# -- Options for autodoc -----------------------------------------------------
+
+# Show the typehints in the description of each object instead of the signature.
+autodoc_typehints = "description"
+
+
+# -- Options for autodoc typehints--------------------------------------------
+
+# Replace Union annotations with union operator "|"
+always_use_bars_union = True
+# always_document_param_types = True
+
+# Show the default value for a parameter after its type
+typehints_defaults = "comma"
+typehints_use_return = True
+
+
 # -- Options for HTML output -------------------------------------------------
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for

diff --git a/doc/source/index.rst b/doc/source/index.rst
@@ -31,86 +31,109 @@ ICESat-2 datasets to enable scientific discovery.
 To further enhance data discovery, we have developed the QUEST module to facilitate querying of ICESat-2 data and complimentary Argo oceanographic data, with additional dataset support expected in the future.
 
 
-.. panels::
-    :card: + intro-card text-center
-    :column: col-lg-4 col-md-4 col-sm-6 col-xs-12 p-2
-    :img-top-cls: pl-2 pr-2 pt-2 pb-2
+.. grid:: 1 2 2 3
+    :gutter: 3
+    :class-container: sd-text-center
 
-    ---
-    :img-top: https://cdn-icons-png.flaticon.com/128/2498/2498074.png
+    .. grid-item-card::
+        :img-top: https://cdn-icons-png.flaticon.com/128/2498/2498074.png
+        :class-img-top: sd-p-2
+        :class-card: sd-shadow-md
 
-    **Getting Started**
-    ^^^^^^^^^^^^^^^^^^^
+        **Getting Started**
+        ^^^^^^^^^^^^^^^^^^^
 
-    New to ICESat-2 or icepyx?
-    Learn how to install icepyx and use it to jumpstart your project today.
-    Check out our gallery of examples, too!
+        New to ICESat-2 or icepyx?
+        Learn how to install icepyx and use it to jumpstart your project today.
+        Check out our gallery of examples, too!
 
-    .. link-button:: install_ref
-        :type: ref
-        :text: Installation Instructions
-        :classes: stretched-link btn-outline-primary btn-block
+        .. button-ref:: install_ref
+            :ref-type: ref
+            :color: primary
+            :outline:
+            :expand:
 
-    ---
-    :img-top: https://cdn-icons-png.flaticon.com/128/3730/3730041.png
+            Installation Instructions
 
-    **User Guide**
-    ^^^^^^^^^^^^^^
+    .. grid-item-card::
+        :img-top: https://cdn-icons-png.flaticon.com/128/3730/3730041.png
+        :class-img-top: sd-p-2
+        :class-card: sd-shadow-md
 
-    The user guide provides in-depth information on the tools and functionality
-    available for obtaining and interacting with ICESat-2 data products.
+        **User Guide**
+        ^^^^^^^^^^^^^^
 
-    .. link-button:: api_doc_ref
-        :type: ref
-        :text: Software Docs
-        :classes: stretched-link btn-outline-primary btn-block
+        The user guide provides in-depth information on the tools and functionality
+        available for obtaining and interacting with ICESat-2 data products.
 
-    ---
-    :img-top: https://cdn-icons-png.flaticon.com/512/4230/4230997.png
+        .. button-ref:: api_doc_ref
+            :ref-type: ref
+            :color: primary
+            :outline:
+            :expand:
 
-    **Development Guide**
-    ^^^^^^^^^^^^^^^^^^^^^
+            Software Docs
 
-    Have an idea or an ancillary dataset to contribute to icepyx? Go here for information on best practices
-    for developing and contributing to icepyx.
+    .. grid-item-card::
+        :img-top: https://cdn-icons-png.flaticon.com/512/4230/4230997.png
+        :class-img-top: sd-p-2
+        :class-card: sd-shadow-md
 
-    .. link-button:: dev_guide_label
-        :type: ref
-        :text: Development Guide
-        :classes: stretched-link btn-outline-primary btn-block
+        **Development Guide**
+        ^^^^^^^^^^^^^^^^^^^^^
 
-    ---
-    :img-top: https://cdn-icons-png.flaticon.com/128/1283/1283342.png
+        Have an idea or an ancillary dataset to contribute to icepyx? Go here for information on best practices
+        for developing and contributing to icepyx.
 
-    **Get in Touch**
-    ^^^^^^^^^^^^^^^^
+        .. button-ref:: dev_guide_label
+            :ref-type: ref
+            :color: primary
+            :outline:
+            :expand:
 
-    icepyx is more than just software!
-    We're a community of data producers, managers, and users
-    who collaborate openly and share code and skills
-    for every step along the entire data pipeline. Find resources for
-    your questions here!
+            Development Guide
 
-    .. link-button:: contact_ref_label
-        :type: ref
-        :text: Get Involved!
-        :classes: stretched-link btn-outline-primary btn-block
+    .. grid-item-card::
+        :img-top: https://cdn-icons-png.flaticon.com/128/1283/1283342.png
+        :class-img-top: sd-p-2
+        :class-card: sd-shadow-md
 
-    ---
-    :img-top: https://icesat-2.gsfc.nasa.gov/sites/default/files/MissionLogo_0.png
-    :img-top-cls: pl-2 pr-2 pt-4 pb-4
+        **Get in Touch**
+        ^^^^^^^^^^^^^^^^
 
-    **ICESat-2 Resources**
-    ^^^^^^^^^^^^^^^^^^^^^^
+        icepyx is more than just software!
+        We're a community of data producers, managers, and users
+        who collaborate openly and share code and skills
+        for every step along the entire data pipeline. Find resources for
+        your questions here!
 
-    Curious about other tools for working with ICESat-2 data?
-    Want to share your resource?
-    Check out the amazing work already in progress!
+        .. button-ref:: contact_ref_label
+            :ref-type: ref
+            :color: primary
+            :outline:
+            :expand:
 
-    .. link-button:: resource_ref_label
-        :type: ref
-        :text: ICESat-2 Resource Guide
-        :classes: stretched-link btn-outline-primary btn-block
+            Get Involved!
+
+    .. grid-item-card::
+        :img-top: https://icesat-2.gsfc.nasa.gov/sites/default/files/MissionLogo_0.png
+        :class-img-top: sd-p-2
+        :class-card: sd-shadow-md
+
+        **ICESat-2 Resources**
+        ^^^^^^^^^^^^^^^^^^^^^^
+
+        Curious about other tools for working with ICESat-2 data?
+        Want to share your resource?
+        Check out the amazing work already in progress!
+
+        .. button-ref:: resource_ref_label
+            :ref-type: ref
+            :color: primary
+            :outline:
+            :expand:
+
+            ICESat-2 Resource Guide
 
 
 .. toctree::