Merge branch 'update_xcookie' into 'main'

Modernize pyproject.toml and wire airflow as an optional extra

See merge request computer-vision/cmd_queue!36

Author: Erotemic

.gitlab-ci.yml

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+# Regenerate uv.lock and the pinned lock files in requirements/locks/.
+#
+# Run this whenever a dependency in pyproject.toml changes so the
+# strict CI variants install the same versions you tested locally.
+#
+# This script is generated by xcookie; see
+# xcookie/main.py:build_refresh_locks_sh.  Manual edits will be
+# overwritten on the next regeneration.
+set -euo pipefail
+
+cd "$(dirname "$0")/.."
+
+uv lock
+
+# Strict CI variant extras: tests
+uv export --frozen --no-emit-project --format requirements.txt --no-hashes \
+    --extra tests \
+    -o requirements/locks/tests.txt
+
+# Strict CI variant extras: tests, optional, airflow
+uv export --frozen --no-emit-project --format requirements.txt --no-hashes \
+    --extra tests \
+    --extra optional \
+    --extra airflow \
+    -o requirements/locks/tests-optional-airflow.txt

dev/refresh_locks.sh

@@ -111,9 +111,9 @@
 # sys.path.insert(0, os.path.abspath('.'))
 
 # -- Project information -----------------------------------------------------
-from os.path import dirname, exists, join
-
-import sphinx_rtd_theme
+from os.path import exists
+from os.path import dirname
+from os.path import join
 
 
 def parse_version(fpath):
@@ -180,6 +180,7 @@ def visit_Assign(self, node):
 ]
 
 todo_include_todos = True
+myst_heading_anchors = 3
 napoleon_google_docstring = True
 napoleon_use_param = False
 napoleon_use_ivar = True
@@ -270,10 +271,12 @@ def visit_Assign(self, node):
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
-# The suffix(es) of source filenames.
-# You can specify multiple suffix as a list of string:
-#
-source_suffix = ['.rst', '.md']
+# The suffix(es) of source filenames. Mapping form avoids Sphinx
+# converting a legacy list at runtime.
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.md': 'markdown',
+}
 
 # The master toctree document.
 master_doc = 'index'
@@ -300,15 +303,13 @@ def visit_Assign(self, node):
 # a list of builtin themes.
 #
 html_theme = 'sphinx_rtd_theme'
-html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
 #
 html_theme_options = {
     'collapse_navigation': False,
-    'display_version': True,
     'navigation_depth': -1,
     # 'logo_only': True,
 }
@@ -318,7 +319,10 @@ def visit_Assign(self, node):
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+# Keep empty by default to avoid warnings when generated projects do not
+# define custom static assets. Projects that create ``docs/source/_static``
+# can opt back in locally.
+html_static_path = []
 
 # Custom sidebar templates, must be a dictionary that maps document names
 # to template names.