fix: use separate tooling env for settings-doc

Author: ryuwd

.pre-commit-config.yaml

@@ -89,7 +89,7 @@ repos:
     hooks:
       - id: settings-doc-check
         name: Generate settings documentation
-        entry: pixi run -e default python scripts/generate_settings_docs.py
+        entry: pixi run -e settings-doc python scripts/generate_settings_docs.py
         language: system
         pass_filenames: false
         files: ^(diracx-.*/src/diracx/.*/settings\.py|docs/.*\.j2|docs/templates/.*\.jinja|scripts/generate_settings_docs\.py)$

pixi.toml

@@ -30,10 +30,6 @@ diracx-logic = { path = "diracx-logic", editable = true, extras = ["testing"] }
 [feature.diracx-routers.pypi-dependencies]
 diracx-routers = { path = "diracx-routers", editable = true, extras = ["testing"] }
 
-# Settings documentation feature
-[feature.settings-doc.pypi-dependencies]
-settings-doc = "*"
-
 # DiracX features for providing tasks. This is needed to make it so that running
 # "pixi run pytest-diracx-core -vvv --pdb" passes the arguments as expected.
 # See: https://github.com/prefix-dev/pixi/issues/1519#issuecomment-2651078457
@@ -61,12 +57,7 @@ description = "Run the tests for diracx-logic"
 cmd = "cd diracx-routers/ && pytest"
 description = "Run the tests for diracx-routers"
 
-# Settings documentation task
-[feature.settings-doc.tasks.generate-settings-doc]
-cmd = "python scripts/generate_settings_docs.py"
-description = "Auto-discover and generate settings documentation with validation"
-
-# Gubbins features for providing dependencies
+# Features for generating the documentation
 [feature.gubbins.pypi-dependencies]
 gubbins = { path = "extensions/gubbins", editable = true, extras = ["testing"] }
 [feature.gubbins-core.pypi-dependencies]
@@ -133,6 +124,13 @@ pre-commit = "*"
 pre-commit = "pre-commit"
 description = "Run pre-commit hooks"
 
+# Features for settings documentation generation
+[feature.settings-doc.pypi-dependencies]
+settings-doc = "*"
+[feature.settings-doc.tasks]
+generate-settings-doc = "python scripts/generate_settings_docs.py"
+description = "Auto-discover and generate settings documentation with validation"
+
 # Features for generating the clients
 [feature.client-gen.dependencies]
 nodejs = ">=10.9.2"
@@ -151,7 +149,7 @@ description = "Run shellcheck on all shell scripts"
 
 [environments]
 # DiracX environments
-default = {features = ["task-diracx", "diracx", "diracx-core", "diracx-api", "diracx-cli", "diracx-client", "diracx-db", "diracx-logic", "diracx-routers", "settings-doc"], solve-group = "diracx"}
+default = {features = ["task-diracx", "diracx", "diracx-core", "diracx-api", "diracx-cli", "diracx-client", "diracx-db", "diracx-logic", "diracx-routers"], solve-group = "diracx"}
 diracx-core = {features = ["task-diracx-core", "diracx-core"], solve-group = "diracx"}
 diracx-api = {features = ["task-diracx-api", "diracx-api", "diracx-client", "diracx-core"], solve-group = "diracx"}
 diracx-cli = {features = ["task-diracx-cli", "diracx-cli", "diracx-api", "diracx-client", "diracx-core"], solve-group = "diracx"}
@@ -177,6 +175,7 @@ gubbins-generate-client = {features = ["client-gen", "diracx-client", "gubbins-c
 mkdocs = {features = ["mkdocs"], no-default-feature = true}
 shellcheck = {features = ["shellcheck"], no-default-feature = true}
 pre-commit = {features = ["pre-commit"], no-default-feature = true}
+settings-doc = {features = ["settings-doc"], no-default-feature = true}
 
 # Meta-tasks for running many tests at once
 [tasks.pytest-diracx-all-one-by-one]