tomli is an optional dependency

Author: mwouts

docs/changelog.md

@@ -1,6 +1,12 @@
 ITables ChangeLog
 =================
 
+2.5.1 (2025-08-31)
+------------------
+
+**Changed**
+- `tomli` is an optional dependency of ITables
+
 2.5.0 (2025-08-31)
 ------------------
 

pyproject.toml

@@ -27,10 +27,11 @@ classifiers = [
   "Typing :: Typed",
 ]
 requires-python = ">= 3.9"
-dependencies = ["IPython", "pandas", "numpy", "tomli;python_version<\"3.11\""]
+dependencies = ["IPython", "pandas", "numpy"]
 dynamic = ["version"]
 
 [project.optional-dependencies]
+config = ["tomli;python_version<\"3.11\""]
 polars = ["polars", "pyarrow"]
 check_type = ["typeguard>=4.4.1"]
 style = ["matplotlib"]
@@ -39,7 +40,7 @@ widget = ["anywidget", "traitlets"]
 streamlit = ["streamlit"]
 dash = ["dash"]
 shiny = ["shiny", "shinywidgets"]
-all = ["itables[polars,style,samples,widget,dash,shiny,streamlit,check_type]"]
+all = ["itables[config,polars,style,samples,widget,dash,shiny,streamlit,check_type]"]
 test = [
   "itables[all]",
   # Pytest

src/itables/config.py

@@ -16,7 +16,10 @@
 try:
     import tomllib
 except ImportError:
-    import tomli as tomllib  # pyright: ignore[reportMissingImports]
+    try:
+        import tomli as tomllib  # pyright: ignore[reportMissingImports]
+    except ImportError:
+        tomllib = None  # type: ignore[assignment]
 
 from platformdirs import user_config_path
 
@@ -50,6 +53,8 @@ def get_config_file(path: Path = Path.cwd()) -> Optional[Path]:
         config_file = parent / "pyproject.toml"
         if config_file.exists():
             with open(config_file, "rb") as fp:
+                if tomllib is None:
+                    continue
                 config = tomllib.load(fp)
                 if "tool" not in config or "itables" not in config["tool"]:
                     continue
@@ -65,6 +70,9 @@ def get_config_file(path: Path = Path.cwd()) -> Optional[Path]:
 
 
 def load_config_file(config_file: Path) -> ITableOptions:
+    if tomllib is None:
+        raise ImportError(f"Either tomllib or tomli is required to load {config_file}")
+
     with open(config_file, "rb") as fp:
         try:
             config = tomllib.load(fp)

src/itables/version.py

@@ -1,3 +1,3 @@
 """ITables' version number"""
 
-__version__ = "2.5.0"
+__version__ = "2.5.1"