Add Python 3.12 to automated test matrix

.github/workflows/integration-test.yml

@@ -17,12 +17,16 @@ concurrency:
   group: integration-tests-${{ github.ref }}
   cancel-in-progress: true
 
+defaults:
+  run:
+    shell: bash -l {0}
+
 jobs:
-  test:
+  integration-tests:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: [3.8, 3.9, "3.10", "3.11"]
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
       fail-fast: false
 
     steps:
@@ -35,22 +39,29 @@ jobs:
         id: full-python-version
         run: echo ::set-output name=version::$(python -c "import sys; print('-'.join(str(v) for v in sys.version_info))")
       - name: Install poetry
-        run: |
-          curl -sSL https://install.python-poetry.org | python3 -
-          echo "$HOME/.poetry/bin" >> $GITHUB_PATH
+        uses: abatilo/actions-poetry@v3
       - name: Configure poetry
-        run: poetry config virtualenvs.in-project true
+        run: |
+          poetry config virtualenvs.create true --local
+          poetry config virtualenvs.in-project true --local
+          poetry self add setuptools
       - name: Set up cache
         uses: actions/cache@v4
         id: cache
         with:
           path: .venv
-          key: venv-${{ runner.os }}-${{ steps.full-python-version.outputs.version }}-${{ hashFiles('**/poetry.lock') }}
+          key: venv-${{ runner.os }}-${{ steps.full-python-version.outputs.version }}-${{ hashFiles('poetry.lock') }}
       - name: Ensure cache is healthy
         if: steps.cache.outputs.cache-hit == 'true'
         run: poetry run pip --version >/dev/null 2>&1 || rm -rf .venv
       - name: Install Dependencies
+        if: ${{ !env.ACT }}
         run: poetry install
+      - name: Install Dependencies
+        if: ${{ env.ACT }}
+        # When using `act` to run the workflow locally, the `poetry install` command
+        # may fail due to network issues when running multiple Docker containers.
+        run: poetry install || poetry install || poetry install
       - name: Test
         env:
           EARTHDATA_USERNAME: ${{ secrets.EDL_USERNAME }}
@@ -59,4 +70,6 @@ jobs:
           EARTHACCESS_TEST_PASSWORD: ${{ secrets.EDL_PASSWORD }}
         run: poetry run bash scripts/integration-test.sh
       - name: Upload coverage
+        # Don't upload coverage when using the `act` tool to run the workflow locally
+        if: ${{ !env.ACT }}
         uses: codecov/codecov-action@v4

.github/workflows/test-mindeps.yml

@@ -46,4 +46,6 @@ jobs:
         run: bash scripts/test.sh
 
       - name: Upload coverage
+        # Don't upload coverage when using the `act` tool to run the workflow locally
+        if: ${{ !env.ACT }}
         uses: codecov/codecov-action@v4

.github/workflows/test.yml

@@ -5,12 +5,16 @@ on:
   pull_request:
     types: [opened, synchronize]
 
+defaults:
+  run:
+    shell: bash -l {0}
+
 jobs:
-  test:
+  unit-tests:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: [3.8, 3.9, "3.10", "3.11"]
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
       fail-fast: false
 
     steps:
@@ -23,23 +27,32 @@ jobs:
         id: full-python-version
         run: echo "version=$(python -c "import sys; print('-'.join(str(v) for v in sys.version_info))")" >> $GITHUB_OUTPUT
       - name: Install poetry
-        run: |
-          curl -sSL https://install.python-poetry.org | python3 -
-          echo "$HOME/.poetry/bin" >> $GITHUB_PATH
+        uses: abatilo/actions-poetry@v3
       - name: Configure poetry
-        run: poetry config virtualenvs.in-project true
+        run: |
+          poetry config virtualenvs.create true --local
+          poetry config virtualenvs.in-project true --local
+          poetry self add setuptools
       - name: Set up cache
         uses: actions/cache@v4
         id: cache
         with:
           path: .venv
-          key: venv-${{ runner.os }}-${{ steps.full-python-version.outputs.version }}-${{ hashFiles('**/poetry.lock') }}
+          key: venv-${{ runner.os }}-${{ steps.full-python-version.outputs.version }}-${{ hashFiles('poetry.lock') }}
       - name: Ensure cache is healthy
         if: steps.cache.outputs.cache-hit == 'true'
         run: poetry run pip --version >/dev/null 2>&1 || rm -rf .venv
       - name: Install Dependencies
+        if: ${{ !env.ACT }}
         run: poetry install
+      - name: Install Dependencies
+        if: ${{ env.ACT }}
+        # When using `act` to run the workflow locally, the `poetry install` command
+        # may fail due to network issues when running multiple Docker containers.
+        run: poetry install || poetry install || poetry install
       - name: Test
         run: poetry run bash scripts/test.sh
       - name: Upload coverage
+        # Don't upload coverage when using the `act` tool to run the workflow locally
+        if: ${{ !env.ACT }}
         uses: codecov/codecov-action@v4

CHANGELOG.md

@@ -2,32 +2,43 @@
 
 ## [Unreleased]
 
-* Changes
-
-  * [#421](https://github.com/nsidc/earthaccess/issues/421): Removed the
-    `get_user_profile` method and the `email_address` and `profile` attributes
-    from the `Auth` class.  Calling the EDL API to get user profile information
-    is not intended for library access and is not necessary for this library's
-    intended use cases.
-  * [#555](https://github.com/nsidc/earthaccess/issues/555): YAML formatting is
-    now performed with `yamlfmt` instead of `prettier`.
-  * [#511](https://github.com/nsidc/earthaccess/issues/511): Replaced `print`
-    calls with `logging` calls where appropriate and added T20 Ruff rule.
-
-* Enhancements
-
-  * [#483](https://github.com/nsidc/earthaccess/issues/483): Now using
-    [Search After](https://cmr.earthdata.nasa.gov/search/site/docs/search/api.html#search-after)
-    for collection and granule searches to support deep-paging through large
-    result sets.
-  * [#508](https://github.com/nsidc/earthaccess/issues/508): Corrected and
-    enhanced static type hints for functions and methods that make CMR queries
-    or handle CMR query results.
-  * [#421](https://github.com/nsidc/earthaccess/issues/421): Enabled queries to
-    Earthdata User Acceptance Testing (UAT) system for authenticated accounts.
-  * [#562](https://github.com/nsidc/earthaccess/issues/562): The destination
-     path is now created prior to direct S3 downloads, if it doesn't already
-     exist.
+### Changed
+
+* Use `yamlfmt` instead of `prettier` for YAML formatting
+  ([#555](https://github.com/nsidc/earthaccess/issues/555))
+* Replace `print` calls with `logging` calls where appropriate, and add T20 Ruff
+  rule to produce lint errors for usages of `print`
+  ([#511](https://github.com/nsidc/earthaccess/issues/511))
+
+### Added
+
+* Enable queries to Earthdata User Acceptance Testing (UAT) system for
+  authenticated accounts
+  ([#421](https://github.com/nsidc/earthaccess/issues/421))
+* Add support for Python 3.12
+  ([#457](https://github.com/nsidc/earthaccess/issues/457))
+
+### Removed
+
+* **Breaking:** Remove support for Python 3.8
+  ([#457](https://github.com/nsidc/earthaccess/issues/457))
+* **Breaking:** Remove the `get_user_profile` method and the `email_address` and
+  `profile` attributes from the `Auth` class.  Calling the EDL API to get user
+  profile information is not intended for library access and is not necessary
+  for this library's intended use cases.
+  ([#421](https://github.com/nsidc/earthaccess/issues/421))
+
+### Fixed
+
+* Use
+  [Search After](https://cmr.earthdata.nasa.gov/search/site/docs/search/api.html#search-after)
+  for collection and granule searches to support deep-paging through large
+  result sets ([#483](https://github.com/nsidc/earthaccess/issues/483))
+* Correct and enhance static type hints for functions and methods that make CMR
+  queries or handle CMR query results
+  ([#508](https://github.com/nsidc/earthaccess/issues/508))
+* Create destination directory prior to direct S3 downloads, if it doesn't
+  already exist ([#562](https://github.com/nsidc/earthaccess/issues/562))
 
 ## [v0.9.0] 2024-02-28
 

ci/environment-mindeps.yaml

@@ -7,7 +7,7 @@ channels:
   - conda-forge
 dependencies:
   # required dependencies
-  - python=3.8
+  - python=3.9
   - python-cmr=0.10.0
   - pqdm=0.1
   - requests=2.26