Add docstring inventories for optional dependencies (#674)

Author: maxrjones

mkdocs.yml

@@ -111,7 +111,14 @@ plugins:
             - https://numcodecs.readthedocs.io/en/stable/objects.inv
             - https://zarr.readthedocs.io/en/stable/objects.inv
             - https://developmentseed.org/obstore/latest/objects.inv
-
+            - https://filesystem-spec.readthedocs.io/en/latest/objects.inv
+            - https://requests.readthedocs.io/en/latest/objects.inv
+            - https://docs.aiohttp.org/en/stable/objects.inv
+            - https://s3fs.readthedocs.io/en/latest/objects.inv
+            - https://docs.h5py.org/en/stable/objects.inv
+            - https://icechunk.io/en/stable/objects.inv
+            - https://lithops-cloud.github.io/docs/objects.inv
+            - https://docs.dask.org/en/stable/objects.inv
 # https://github.com/developmentseed/titiler/blob/50934c929cca2fa8d3c408d239015f8da429c6a8/docs/mkdocs.yml#L115-L140
 markdown_extensions:
   - admonition

virtualizarr/manifests/store.py

@@ -192,7 +192,7 @@ class ManifestStore(Store):
         Root group of the store.
         Contains group metadata, [ManifestArrays][virtualizarr.manifests.ManifestArray], and any subgroups.
     store_registry : ObjectStoreRegistry
-        [ObjectStoreRegistry][virtualizarr.manifests.ObjectStoreRegistry] that maps the URL scheme and netloc to  [ObjectStore][obstore.store.ObjectStore]instances,
+        [ObjectStoreRegistry][virtualizarr.manifests.ObjectStoreRegistry] that maps the URL scheme and netloc to  [ObjectStore][obstore.store.ObjectStore] instances,
         allowing ManifestStores to read from different ObjectStore instances.
 
     Warnings

virtualizarr/parallel.py

@@ -126,7 +126,7 @@ def shutdown(self, wait: bool = True, *, cancel_futures: bool = False) -> None:
 
 class DaskDelayedExecutor(Executor):
     """
-    An Executor that uses dask.delayed for parallel computation.
+    An Executor that uses [dask.delayed][dask.delayed.delayed] for parallel computation.
 
     This executor mimics the concurrent.futures.Executor interface but uses Dask's delayed computation model.
     """
@@ -139,7 +139,7 @@ def __init__(self) -> None:
 
     def submit(self, fn: Callable[..., T], /, *args: Any, **kwargs: Any) -> Future[T]:
         """
-        Submit a task to be computed with dask.delayed.
+        Submit a task to be computed with [dask.delayed][dask.delayed.delayed].
 
         Parameters
         ----------
@@ -185,7 +185,7 @@ def map(
         chunksize: int = 1,
     ) -> Iterator[T]:
         """
-        Apply a function to an iterable using dask.delayed.
+        Apply a function to an iterable using [dask.delayed][dask.delayed.delayed].
 
         Parameters
         ----------
@@ -226,9 +226,9 @@ def shutdown(self, wait: bool = True, *, cancel_futures: bool = False) -> None:
 
 class LithopsEagerFunctionExecutor(Executor):
     """
-    Lithops-based function executor which follows the concurrent.futures.Executor API.
+    Lithops-based function executor which follows the [concurrent.futures.Executor][] API.
 
-    Only required because lithops doesn't follow the concurrent.futures.Executor API, see https://github.com/lithops-cloud/lithops/issues/1427.
+    Only required because lithops doesn't follow the [concurrent.futures.Executor][] API, see https://github.com/lithops-cloud/lithops/issues/1427.
     """
 
     def __init__(self, **kwargs) -> None:
@@ -294,7 +294,7 @@ def map(
         """
         Apply a function to an iterable using lithops.
 
-        Only needed because lithops.FunctionExecutor.map returns futures, unlike ``concurrent.futures.Executor.map``.
+        Only needed because [lithops.executors.FunctionExecutor.map][lithops.executors.FunctionExecutor.map] returns futures, unlike [concurrent.futures.Executor.map][].
 
         Parameters
         ----------