fix: Merge latest (#2)

* Support sequence of `Item`s (gjoseph92#164)

* Switch to PDM for dependency management (gjoseph92#169)

* Add param links to docs (gjoseph92#170)

* Automatically hide `pdm.lock` in GitHub diffs (gjoseph92#171)

* Fix docs build for visualization functions (gjoseph92#172)

* Fix docs build for PDM again (gjoseph92#175)

* Remove deprecated `skip_equivalent` pyproj arg (gjoseph92#174)

* Release v0.4.3 (gjoseph92#176)

* Fixed link to USGS PDF on qa-pixel (gjoseph92#180)

Co-authored-by: Gabe Joseph <gjoseph92@gmail.com>
Co-authored-by: Tom Augspurger <taugspurger@microsoft.com>

.gitattributes

@@ -0,0 +1,2 @@
+# Make GitHub treat PDM's lockfile as generated and automatically hide its diff
+pdm.lock linguist-generated

.gitignore

@@ -5,6 +5,7 @@ __pycache__
 dask-worker-space
 .ipynb_checkpoints
 .vscode
+.pdm.toml
 /dist
 
 *.DS_Store

.pre-commit-config.yaml

@@ -0,0 +1,11 @@
+repos:
+  - repo: local
+    hooks:
+      - id: pdm-check
+        name: pdm check
+        description: Check that PDM lockfile is up to date
+        entry: pdm install --check --dry-run
+        files: "^pyproject.toml$"
+        language: python
+        language_version: python3
+        pass_filenames: false

.readthedocs.yml

@@ -3,13 +3,15 @@ version: 2
 sphinx:
   configuration: docs/conf.py
 
-# https://github.com/readthedocs/readthedocs.org/issues/4912#issuecomment-1143587902
 build:
   os: ubuntu-20.04
   tools:
-    python: '3.8'
+    python: "3.8"
   jobs:
     post_install:
-      - pip install poetry==1.1.13
-      - poetry config virtualenvs.create false
-      - poetry install --no-dev -E docs -E viz
+      # Install PDM in its own isolated environment, so docs deps don't trample its deps
+      - curl -sSL https://raw.githubusercontent.com/pdm-project/pdm/main/install-pdm.py | python3 -
+      # TODO how to get `pdm` on the $PATH?
+      # https://github.com/pdm-project/pdm/discussions/1365#discussioncomment-3581356
+      # NOTE: pandoc fails in isolation mode
+      - VIRTUAL_ENV=$(dirname $(dirname $(which python))) $HOME/.local/bin/pdm sync --no-isolation -G viz -dG docs

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.4.3 (2022-09-14)
+- Support sequences of `Item`s [@gjoseph92](https://github.com/gjoseph92)
+- Fix compatibility with `pyproj>=3.4.0` [@gjoseph92](https://github.com/gjoseph92)
+- stackstac has switched from Poetry to PDM as its package manager. This does not affect users, only developers.
+
 ## 0.4.2 (2022-07-06)
 - Support (and require) rasterio 1.3.0 [@carderne](https://github.com/carderne) [@gjoseph92](https://github.com/gjoseph92)
 - Fix `ValueError` when passing `dim=` to `mosaic` [@aazuspan](https://github.com/aazuspan)

binder/postBuild

@@ -1,5 +1,3 @@
-
 set -ex
 
-poetry config virtualenvs.create false
-poetry install -E binder -E viz
+VIRTUAL_ENV=$(dirname $(dirname $(which python))) pdm install -G viz -dG binder

binder/requirements.txt

@@ -1 +1 @@
-poetry
+pdm

docs/conf.py

@@ -22,7 +22,7 @@
 
 DISTRIBUTION_METADATA = importlib.metadata.metadata("stackstac")
 
-author = DISTRIBUTION_METADATA["Author"]
+author = DISTRIBUTION_METADATA["Author-email"].split(" <")[0]
 project = DISTRIBUTION_METADATA["Name"]
 version = DISTRIBUTION_METADATA["Version"]
 copyright = f"{datetime.datetime.now().year}, {author}"
@@ -38,6 +38,7 @@
     "sphinx.ext.autosummary",
     "sphinx.ext.napoleon",
     "sphinx_autodoc_typehints",
+    "sphinx_paramlinks",
     "nbsphinx",
     "jupyter_sphinx",
 ]
@@ -50,6 +51,7 @@
 # This pattern also affects html_static_path and html_extra_path.
 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
 
+paramlinks_hyperlink_param = 'name'
 autosummary_generate = True
 napoleon_use_param = True
 # set_type_checking_flag = True
@@ -115,7 +117,7 @@
     "rasterio": ("https://rasterio.readthedocs.io/en/latest/", None),
     "numpy": ("https://numpy.org/doc/stable/", None),
     "pystac": ("https://pystac.readthedocs.io/en/latest/", None),
-    "xarray": ("https://xarray.pydata.org/en/stable/", None),
+    "xarray": ("https://docs.xarray.dev/en/stable/", None),
     "dask": ("https://docs.dask.org/en/latest/", None),
     "distributed": ("https://distributed.dask.org/en/latest/", None),
     "matplotlib": ("https://matplotlib.org/stable", None),

examples/gif.ipynb

@@ -259835,7 +259835,7 @@
     "\n",
     "Use the bit values of the Landsat-8 QA band to mask out bad pixels. We'll mask pixels labeled as dilated cloud, cirrus, cloud, or cloud shadow. (By \"mask\", we mean just replacing those pixels with NaNs).\n",
     "\n",
-    "See page 14 on [this PDF](https://prd-wret.s3.us-west-2.amazonaws.com/assets/palladium/production/atoms/files/LSDS-1328_Landsat8-9-OLI-TIRS-C2-L2-DFCB-v6.pdf) for the data table describing which bit means what."
+    "See page 14 on [this PDF](https://d9-wret.s3.us-west-2.amazonaws.com/assets/palladium/production/s3fs-public/media/files/LSDS-1619_Landsat-8-9-C2-L2-ScienceProductGuide-v4.pdf) for the data table describing which bit means what."
    ]
   },
   {