Fully type library and advertise it (#21)

This PR finishes mypy typing and advertises it by including a `py.typed`
file.

Author: jsignell

.gitignore

@@ -3,3 +3,6 @@ __pycache__
 htmlcov
 dist
 .direnv
+.mypy_cache
+.pytest_cache
+.ruff_cache

.pre-commit-config.yaml

@@ -1,27 +1,29 @@
+# Configuration file for pre-commit (https://pre-commit.com/).
+# Please run `pre-commit run --all-files` when adding or changing entries.
 
 repos:
 -   repo: https://github.com/MarcoGorelli/absolufy-imports
     rev: v0.3.1
     hooks:
       - id: absolufy-imports
         name: absolufy-imports
--   repo: https://github.com/pycqa/isort
-    rev: 5.12.0
-    hooks:
-      - id: isort
-        language_version: python3
 -   repo: https://github.com/asottile/pyupgrade
     rev: v3.2.2
     hooks:
       - id: pyupgrade
         args:
           - --py38-plus
+-   repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: 'v0.0.272'
+    hooks:
+    - id: ruff
+      args: [--fix, --exit-non-zero-on-fix]
 -   repo: https://github.com/psf/black
-    rev: "23.1.0"
+    rev: 23.1.0
     hooks:
-    -   id: black
--   repo: https://github.com/pycqa/flake8
-    rev: 6.0.0
+      - id: black
+-   repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v0.991
     hooks:
-    - id: flake8
-      language_version: python3
+      - id: mypy
+        files: ".*\\.py$"

pyproject.toml

@@ -26,3 +26,7 @@ dev = [
 
 [project.entry-points."xarray.backends"]
 stac = "xpystac.xarray_plugin:STACBackend"
+
+[tool.ruff]
+line-length = 88
+select = ["E", "F", "W", "I"]

tests/cassettes/fixtures/simple_reference_file.yaml

@@ -11,38 +11,42 @@ interactions:
       User-Agent:
       - python-requests/2.28.2
     method: GET
-    uri: https://earth-search.aws.element84.com/v0
+    uri: https://earth-search.aws.element84.com/v1
   response:
     body:
-      string: '{"stac_version":"1.0.0-beta.2","stac_api_version":"0.9.0","id":"earth-search","title":"Earth
-        Search","description":"A STAC API of AWS Public Datasets powered by stac-server","links":[{"rel":"child","href":"https://earth-search.aws.element84.com/v0/collections/sentinel-s2-l2a"},{"rel":"child","href":"https://earth-search.aws.element84.com/v0/collections/sentinel-s2-l1c"},{"rel":"child","href":"https://earth-search.aws.element84.com/v0/collections/sentinel-s2-l2a-cogs"},{"rel":"child","href":"https://earth-search.aws.element84.com/v0/collections/landsat-8-l1-c1"},{"rel":"service-desc","type":"application/vnd.oai.openapi+json;version=3.0","href":"https://earth-search.aws.element84.com/v0/api"},{"rel":"conformance","type":"application/json","href":"https://earth-search.aws.element84.com/v0/conformance"},{"rel":"children","type":"application/json","href":"https://earth-search.aws.element84.com/v0/collections"},{"rel":"self","type":"application/json","href":"https://earth-search.aws.element84.com/v0/"},{"rel":"search","type":"application/json","href":"https://earth-search.aws.element84.com/v0/search"},{"rel":"docs","href":"https://stac-utils.github.io/stac-server/"}]}'
+      string: '{"stac_version":"1.0.0","type":"Catalog","id":"earth-search-aws","title":"Earth-Search
+        AWS","description":"A STAC API of public datasets on AWS","links":[{"rel":"self","type":"application/json","href":"https://earth-search.aws.element84.com/v1"},{"rel":"root","type":"application/json","href":"https://earth-search.aws.element84.com/v1"},{"rel":"conformance","type":"application/json","href":"https://earth-search.aws.element84.com/v1/conformance"},{"rel":"data","type":"application/json","href":"https://earth-search.aws.element84.com/v1/collections"},{"rel":"search","type":"application/geo+json","href":"https://earth-search.aws.element84.com/v1/search","method":"GET"},{"rel":"search","type":"application/geo+json","href":"https://earth-search.aws.element84.com/v1/search","method":"POST"},{"rel":"aggregate","type":"application/json","href":"https://earth-search.aws.element84.com/v1/aggregate","method":"GET"},{"rel":"aggregations","type":"application/json","href":"https://earth-search.aws.element84.com/v1/aggregations"},{"rel":"service-desc","type":"application/vnd.oai.openapi","href":"https://earth-search.aws.element84.com/v1/api"},{"rel":"service-doc","type":"text/html","href":"https://earth-search.aws.element84.com/v1/api.html"},{"rel":"http://www.opengis.net/def/rel/ogc/1.0/queryables","type":"application/schema+json","href":"https://earth-search.aws.element84.com/v1/queryables"},{"rel":"server","type":"text/html","href":"https://stac-utils.github.io/stac-server/"},{"rel":"child","type":"application/geo+json","href":"https://earth-search.aws.element84.com/v1/collections/cop-dem-glo-30"},{"rel":"child","type":"application/geo+json","href":"https://earth-search.aws.element84.com/v1/collections/naip"},{"rel":"child","type":"application/geo+json","href":"https://earth-search.aws.element84.com/v1/collections/sentinel-2-l2a"},{"rel":"child","type":"application/geo+json","href":"https://earth-search.aws.element84.com/v1/collections/sentinel-2-l1c"},{"rel":"child","type":"application/geo+json","href":"https://earth-search.aws.element84.com/v1/collections/landsat-c2-l2"},{"rel":"child","type":"application/geo+json","href":"https://earth-search.aws.element84.com/v1/collections/cop-dem-glo-90"},{"rel":"child","type":"application/geo+json","href":"https://earth-search.aws.element84.com/v1/collections/sentinel-1-grd"}],"conformsTo":["https://api.stacspec.org/v1.0.0/core","https://api.stacspec.org/v1.0.0/collections","https://api.stacspec.org/v1.0.0/ogcapi-features","https://api.stacspec.org/v1.0.0/item-search","https://api.stacspec.org/v1.0.0-rc.3/ogcapi-features#fields","https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features#sort","https://api.stacspec.org/v1.0.0-rc.2/ogcapi-features#query","https://api.stacspec.org/v1.0.0-rc.3/item-search#fields","https://api.stacspec.org/v1.0.0-rc.2/item-search#sort","https://api.stacspec.org/v1.0.0-rc.2/item-search#query","https://api.stacspec.org/v0.3.0/aggregation","http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core","http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30","http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson"]}'
     headers:
-      Access-Control-Allow-Credentials:
-      - 'true'
-      Access-Control-Allow-Origin:
-      - '*'
       Connection:
       - keep-alive
       Content-Length:
-      - '1180'
+      - '3131'
       Content-Type:
-      - application/json
+      - application/json; charset=utf-8
       Date:
-      - Fri, 24 Feb 2023 14:00:56 GMT
+      - Wed, 14 Jun 2023 16:31:57 GMT
       Via:
-      - 1.1 b4fecc0ccf7e0c6aa3eab83d70c5766c.cloudfront.net (CloudFront)
+      - 1.1 0d3bc0372b2119705524079214a98b3e.cloudfront.net (CloudFront)
       X-Amz-Cf-Id:
-      - aRQ9whW8xQDfRCiAkz8yXsApL7yIJauKHxLbONigmD_tgfPI5MurTg==
+      - DQbi7xc6BgAPe9SM3zebAv-aYtRAak_8QRJrWQKGB9G-PqCro0cWWA==
       X-Amz-Cf-Pop:
       - EWR52-C2
       X-Amzn-Trace-Id:
-      - Root=1-63f8c318-3c0a337a4a04985a0b3d99b0;Sampled=0
+      - Root=1-6489eb7d-0ab1c2021e3f6bce4f294a5c;Sampled=0;lineage=9e2884e9:0
       X-Cache:
       - Miss from cloudfront
+      access-control-allow-origin:
+      - '*'
+      etag:
+      - W/"c3b-v7CpzZWq4m5R7IzejcSaa8UIyAI"
       x-amz-apigw-id:
-      - A2Nr5HdjPHcF3ew=
+      - GhG7tH0pPHcF3uA=
+      x-amzn-Remapped-content-length:
+      - '3131'
       x-amzn-RequestId:
-      - f186aeb2-6a03-4649-aca8-e92a03efc730
+      - 6e1291ed-cb44-429d-91d1-cbc60c070ab7
+      x-powered-by:
+      - Express
     status:
       code: 200
       message: OK