Correct minimum versions in dependency version ranges (#1272)

dlqqq · web-flow · commit 110311b8a362 · 2025-03-11T15:22:20.000-07:00
* bump jupyter_server version floor to match JupyterLab

* bump the jupyter_server optional dependency floor

* bump traitlets version floor

* bump pydantic version floor

* remove typing_extensions dependency

* remove unused aiosqlite dependency

* bump pydantic floor to v2.9.0

* drop importlib_metadata, bump to python 3.9 minimum

* pre-commit

* bump click version floor to 8.1.0

* bump jupyter_server floor to 2.11.1

* bump pydantic floor to 2.10.0

* bring back importlib_metadata

* pre-commit

* use same range for pydantic in both packages

* declare importlib_metadata dep in jupyter_ai as well
diff --git a/README.md b/README.md
@@ -22,7 +22,7 @@ Documentation is available on [ReadTheDocs](https://jupyter-ai.readthedocs.io/en
 
 You will need to have installed the following software to use Jupyter AI:
 
-- Python 3.8 - 3.12
+- Python 3.9 - 3.12
 - JupyterLab 4 or Notebook 7
 
 In addition, you will need access to at least one model provider.
diff --git a/docs/source/users/index.md b/docs/source/users/index.md
@@ -11,7 +11,8 @@ please see the {doc}`developer's guide </developers/index>`.
 ## Prerequisites
 
 You can run Jupyter AI on any system that can run a supported Python version
-from 3.8 to 3.12, including recent Windows, macOS, and Linux versions.
+from 3.9 to 3.12, including recent Windows, macOS, and Linux versions. Python
+3.8 support is also available in Jupyter AI v2.29.1 and below.
 
 If you use `conda`, you can install Python 3.12 in your environment by running:
 
diff --git a/packages/jupyter-ai-magics/pyproject.toml b/packages/jupyter-ai-magics/pyproject.toml
@@ -6,13 +6,12 @@ build-backend = "hatchling.build"
 name = "jupyter_ai_magics"
 readme = "README.md"
 license = { file = "LICENSE" }
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 classifiers = [
     "Framework :: Jupyter",
     "License :: OSI Approved :: BSD License",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
@@ -26,9 +25,11 @@ dependencies = [
     "importlib_metadata>=5.2.0",
     "langchain>=0.3.0,<0.4.0",
     "langchain_community>=0.3.0,<0.4.0",
-    "pydantic~=2.0",
-    "typing_extensions>=4.5.0",
-    "click~=8.0",
+    # pydantic <2.10.0 raises a "protected namespaces" error in JAI
+    # - See: https://docs.pydantic.dev/latest/api/config/#pydantic.config.ConfigDict.protected_namespaces
+    "pydantic>=2.10.0,<3",
+    # click>=8.1 is required by dask>=2023.11.0
+    "click>=8.1.0,<9",
     "jsonpath-ng>=1.5.3,<2",
 ]
 
diff --git a/packages/jupyter-ai-module-cookiecutter/{{cookiecutter.root_dir_name}}/README.md b/packages/jupyter-ai-module-cookiecutter/{{cookiecutter.root_dir_name}}/README.md
@@ -6,7 +6,7 @@ extension.
 
 ## Requirements
 
-- Python 3.8 - 3.12
+- Python 3.9 - 3.12
 - JupyterLab 4
 
 ## Install
diff --git a/packages/jupyter-ai-module-cookiecutter/{{cookiecutter.root_dir_name}}/pyproject.toml b/packages/jupyter-ai-module-cookiecutter/{{cookiecutter.root_dir_name}}/pyproject.toml
@@ -6,15 +6,14 @@ build-backend = "hatchling.build"
 name = "{{ cookiecutter.python_name }}"
 readme = "README.md"
 license = { file = "LICENSE" }
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 classifiers = [
     "Framework :: Jupyter",
     "Framework :: Jupyter :: JupyterLab",
     "Framework :: Jupyter :: JupyterLab :: 4",
     "License :: OSI Approved :: BSD License",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
diff --git a/packages/jupyter-ai-test/README.md b/packages/jupyter-ai-test/README.md
@@ -6,7 +6,7 @@ environment. This package should never published on NPM or PyPI.
 
 ## Requirements
 
-- Python 3.8 - 3.12
+- Python 3.9 - 3.12
 - JupyterLab 4
 
 ## Install
diff --git a/packages/jupyter-ai-test/pyproject.toml b/packages/jupyter-ai-test/pyproject.toml
@@ -6,15 +6,14 @@ build-backend = "hatchling.build"
 name = "jupyter_ai_test"
 readme = "README.md"
 license = { file = "LICENSE" }
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 classifiers = [
     "Framework :: Jupyter",
     "Framework :: Jupyter :: JupyterLab",
     "Framework :: Jupyter :: JupyterLab :: 4",
     "License :: OSI Approved :: BSD License",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
diff --git a/packages/jupyter-ai/pyproject.toml b/packages/jupyter-ai/pyproject.toml
@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 name = "jupyter_ai"
 readme = "README.md"
 license = { file = "LICENSE" }
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 classifiers = [
     "Framework :: Jupyter",
     "Framework :: Jupyter :: JupyterLab",
@@ -16,24 +16,26 @@ classifiers = [
     "License :: OSI Approved :: BSD License",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
 ]
 dependencies = [
-    "jupyter_server>=1.6,<3",
-    "aiosqlite>=0.18",
+    # jupyter_server>=2.4 is required in JL4
+    # jupyter_server>=2.11.1 is required by jupyter_server_ydoc>=3
+    "jupyter_server>=2.11.1,<3",
     "importlib_metadata>=5.2.0",
-    "pydantic~=2.0",
+    # pydantic <2.10.0 raises a "protected namespaces" error in JAI
+    # - See: https://docs.pydantic.dev/latest/api/config/#pydantic.config.ConfigDict.protected_namespaces
+    "pydantic>=2.10.0,<3",
     "jupyter_ai_magics>=2.13.0",
     "dask[distributed]",
     # faiss-cpu is not distributed by the official repo.
     # v1.8.0.post0 should be excluded as it lacks macOS x86 wheels.
     "faiss-cpu>=1.8.0,<2.0.0,!=1.8.0.post0",
-    "typing_extensions>=4.5.0",
-    "traitlets>=5.0",
+    # traitlets>=5.6 is required in JL4
+    "traitlets>=5.6",
     "deepmerge>=2.0,<3",
     "jupyterlab-chat>=0.7.1,<1.0.0",
 ]
@@ -52,7 +54,9 @@ help = "jupyter_ai.chat_handlers.help:HelpChatHandler"
 
 [project.optional-dependencies]
 test = [
-    "jupyter-server[test]>=1.6,<3",
+    # jupyter_server>=2.4 is required in JL4
+    # jupyter_server>=2.11.1 is required by jupyter_server_ydoc>=3
+    "jupyter_server[test]>=2.11.1,<3",
     "coverage",
     "pytest",
     "pytest-asyncio",
