Move dev and doc dependencies to PEP 735 dependency-groups, and use u…

…v export to use those dependencies for readthedocs builds

.gitignore

@@ -53,6 +53,7 @@ docs/examples
 docs/sample_data
 docs/models/
 docs/modules/
+docs/requirements.txt
 
 # Mac OS X
 .DS_Store

.readthedocs.yml

@@ -9,10 +9,11 @@ build:
   os: 'ubuntu-24.04'
   tools:
     python: '3.12'
-
+  jobs:
+    # Use uv to export optional + documentation dependencies
+    post_create_environment:
+      - pip install uv
+      - uv export -q --no-dev --group docs --no-editable -o docs/requirements.txt
 python:
   install:
-    - method: pip
-      path: .
-      extra_requirements:
-        - docs
+    - requirements: docs/requirements.txt

CONTRIBUTING.md

@@ -7,7 +7,7 @@ To set up for local development (requires [uv](https://docs.astral.sh/uv)):
 ```bash
 $ git clone https://github.com/pyinat/pyinaturalist.git
 $ cd pyinaturalist
-$ uv sync --all-extras
+$ uv sync --all-extras --all-groups
 ```
 
 ## Contribution Guidelines

pyproject.toml

@@ -48,7 +48,22 @@ all = [
     'ujson>5.0',
 ]
 
-# Documentation dependencies needed for Readthedocs builds
+[dependency-groups]
+# Dev dependencies
+dev = [
+    'coverage>=7.2',
+    'nox~=2024.4',
+    'pre-commit~=3.5',
+    'pretty-errors>=1.2',
+    'pytest~=8.2',
+    'pytest-asyncio>=0.21',
+    'pytest-cov>=3.0',
+    'pytest-xdist>=2.2',
+    'requests-mock~=1.8',
+    'sphinx-autobuild>=2021.3',
+]
+
+# Documentation dependencies for Readthedocs builds
 docs = [
     'furo~=2024.8',
     'ipython~=8.12',
@@ -66,20 +81,6 @@ docs = [
     'sphinxext-opengraph>=0.9',
 ]
 
-[tool.uv]
-dev-dependencies = [
-    'coverage>=7.2',
-    'nox~=2024.4',
-    'pre-commit~=3.5',
-    'pretty-errors>=1.2',
-    'pytest~=8.2',
-    'pytest-asyncio>=0.21',
-    'pytest-cov>=3.0',
-    'pytest-xdist>=2.2',
-    'requests-mock~=1.8',
-    'sphinx-autobuild>=2021.3',
-]
-
 [build-system]
 requires = ['hatchling>=1.0.0']
 build-backend = 'hatchling.build'