Merge pull request #2900 from catalyst-cooperative/sphinx-autoapi-3.0

I removed the `conda-lock` specific changes from this PR so that we can get the environment fixed and have the builds working, and have a more leisurely conversation about using lockfiles in a PR that I'll make as soon as this is merged in.

pyproject.toml

@@ -13,34 +13,45 @@ license = { file = "LICENSE.txt" }
 dependencies = [
     "addfips>=0.4,<0.5",
     "alembic>=1.10.3,<1.13",
-    "astroid>=2,<3",
-    "catalystcoop.dbfread>=3.0,<3.1",
+    "anyascii>=0.3.2,<0.4",  # recordlinkage dependency
+    "boto3>=1.28.55",
+    "bottleneck>=1.3.4",  # pandas[performance]
+    "catalystcoop.dbfread>=3,<3.1",
     "catalystcoop.ferc-xbrl-extractor==0.8.3",
     "coloredlogs>=14.0,<15.1",  # Dagster requires 14.0
-    "dagster-webserver>=1.4,<1.5",  # 1.2.2 is first version to support Python 3.11
-    "dagster>=1.4,<1.5",  # 1.2.2 is first version to support Python 3.11
-    "dask>=2021.8,<2023.9.3",
+    "dagster-webserver>=1.4,<1.5",
+    "dagster>=1.4,<1.5",
+    "dask>=2022.5,<2023.9.3",
     "datapackage>=1.11,<1.16",  # Transition datastore to use frictionless.
-    "fsspec>=2021.7,<2023.9.3",  # For caching datastore on GCS
+    "email-validator>=1.0.3",  # pydantic[email]
+    "fsspec>=2022.5,<2023.9.3",
     "geopandas>=0.13,<0.15",
-    "gcsfs>=2021.7,<2023.9.2",  # For caching datastore on GCS
-    "grpcio<1.56.0",
-    "jinja2>=2,<3.2",
-    "matplotlib>=3.3,<3.9",  # Should make this optional with a "viz" extras
-    "networkx>=2.2,<3.2",
-    "numpy>=1.18.5,!=1.23.0,<1.27",
-    "pandas[parquet,excel,fss,gcp,compression]>=2.0,<2.1",
-    "pyarrow>=7,<13",
-    "pydantic[email]>=1.7,<2",
-    "python-dotenv>=0.21,<1.1",
-    "pyyaml>=5,<6.1",
+    "gcsfs>=2022.5,<2023.9.2",
+    "grpcio==1.57.0",  # Required by dagster. Version works with MacOS
+    "grpcio-health-checking==1.57.0",  # Required by dagster. Version works with MacOS
+    "grpcio-status==1.57.0",  # Required by dagster. Version works with MacOS
+    "jellyfish>=1.0.1,<1.1",  # recordlinkage dependency
+    "jinja2>=3,<3.2",
+    "matplotlib>=3.6.1,<3.9",
+    "networkx>=3,<3.2",
+    "numba>=0.55.2",  # pandas[performance]
+    "numexpr>=2.8.0",  # pandas[performance]
+    "numpy>=1.24,<2.0a0",
+    "openpyxl>=3.0.10",  # pandas[excel]
+    "pandas>=2,<2.1",
+    "pyarrow>=12,<13",  # pandas[parquet]
+    "pydantic>=1.7,<2",
+    "python-dotenv>=1,<1.1",
+    "pyxlsb>=1.0.9",  # pandas[excel]
+    "pyyaml>=6,<6.1",
     "recordlinkage>=0.16,<0.17",
-    "scikit-learn>=1.0,<1.4",
+    "scikit-learn>=1,<1.4",
     "scipy>=1.6,<1.12",
-    "Shapely>=2.0,<2.1",
+    "Shapely>=2,<3",
     "sqlalchemy>=1.4,<2",
-    "timezonefinder>=5,<6.3",
-    "xlsxwriter>=3,<3.2",
+    "timezonefinder>=6,<6.3",
+    "xlrd>=2.0.1",  # pandas[excel]
+    "xlsxwriter>=3.0.3,<3.2",  # pandas[excel]
 ]
 classifiers = [
     "Development Status :: 3 - Alpha",
@@ -107,37 +118,38 @@ pudl_check_fks = "pudl.etl.check_foreign_keys:main"
 
 [project.optional-dependencies]
 dev = [
-    "black>=22.0,<23.10",
-    "build>=0.10,<1.1",
+    "black>=22,<23.10",
+    "build>=1,<1.1",
     "ipdb>=0.13,<0.14",
     "jedi>=0.18,<0.20",
     "lxml>=4.6,<4.10",
     "ruff>=0.0.287",
     "tox>=4,<4.12",
-    "twine>=3.3,<4.1",
+    "twine>=4,<4.1",
 ]
 doc = [
     "doc8>=1.1,<1.2",
     "furo>=2022.4.7",
-    "sphinx-autoapi>=1.8,<2.2",
-    "sphinx-issues>=1.2,<3.1",
-    "sphinx-reredirects",
-    "sphinx>=4,!=5.1.0,<7.3",
+    "sphinx-autoapi>=3,<4",
+    "sphinx-issues>=1.2,<2",
+    "sphinx-reredirects>=0.1.2,<0.2",
+    "sphinx>=7,<7.3",
     "sphinxcontrib_bibtex>=2.4,<2.7",
 ]
 test = [
-    "coverage>=5.3,<7.4",
+    "astroid>=3,<4",  # sphinx-autoapi dependency
+    "coverage>=7,<7.4",
     "jupyter",
     "nbconvert>=7,<8",
     "nbformat>=5,<6",
-    "pre-commit>=2.9,<3.5",
+    "pre-commit>=3,<3.5",
     "pytest-console-scripts>=1.1,<1.5",
-    "pytest-cov>=2.10,<4.2",
-    "pytest-mock>=3.0,<3.12",
-    "pytest>=6.2,<7.5",
+    "pytest-cov>=4,<4.2",
+    "pytest-mock>=3,<3.12",
+    "pytest>=7,<7.5",
     "responses>=0.14,<0.24",
     "ruff>=0.0.287",
-    "tox>=4.0,<4.12",
+    "tox>=4,<4.12",
 ]
 datasette = ["datasette>=0.60,<0.65"]