fix self import for python3.10

Author: mathiasertl

pyproject.toml

@@ -16,8 +16,10 @@ dependencies = [
     "pyyaml>=6.0.2",
     # need to exclude 8.2.0, as it drops support for Python 3.10
     "sphinx>=8.0.0,<8.2.0",
-    "sphinx-inline-tabs>=2023.4.21",
+    "sphinx-inline-tabs>=2025",
     "termcolor>=3.2.0",
+    # Python 3.10 does not have Self
+    "typing_extensions>=4.6.0;python_version<'3.11'",
 ]
 classifiers = [
     "Development Status :: 4 - Beta",

structured_tutorials/models/base.py

@@ -4,7 +4,7 @@
 """Base model classes."""
 
 from pathlib import Path
-from typing import Annotated, Any, Self
+from typing import Annotated, Any
 
 from pydantic import (
     BaseModel,
@@ -17,6 +17,8 @@
 )
 from pydantic.fields import FieldInfo
 
+from structured_tutorials.typing import Self
+
 # Type for commands to execute
 CommandType = str | tuple[str, ...]
 

structured_tutorials/models/parts.py

@@ -5,7 +5,7 @@
 
 import os
 from pathlib import Path
-from typing import Annotated, Any, Literal, Self
+from typing import Annotated, Any, Literal
 
 from pydantic import BaseModel, ConfigDict, Discriminator, Field, NonNegativeInt, Tag, model_validator
 
@@ -18,6 +18,7 @@
     template_field_title_generator,
 )
 from structured_tutorials.models.tests import TestCommandModel, TestOutputModel, TestPortModel
+from structured_tutorials.typing import Self
 
 
 def part_discriminator(value: Any) -> str | None:

structured_tutorials/models/tutorial.py

@@ -4,14 +4,15 @@
 """Module containing main tutorial model and global configuration models."""
 
 from pathlib import Path
-from typing import Annotated, Any, Self
+from typing import Annotated, Any
 
 from pydantic import BaseModel, ConfigDict, Discriminator, Field, Tag, field_validator, model_validator
 from pydantic_core.core_schema import ValidationInfo
 from yaml import safe_load
 
 from structured_tutorials.models.base import default_tutorial_root_factory
 from structured_tutorials.models.parts import AlternativeModel, PartModels, PromptModel, part_discriminator
+from structured_tutorials.typing import Self
 
 
 class DocumentationConfigurationModel(BaseModel):

structured_tutorials/typing.py

@@ -0,0 +1,14 @@
+# Copyright (c) 2025 Mathias Ertl
+# Licensed under the MIT License. See LICENSE file for details.
+
+"""Module that re-exports some type hints."""
+
+try:
+    from typing import Self
+except ImportError:  # pragma: only py3.10
+    from typing_extensions import Self
+
+
+__all__ = [
+    "Self",
+]