Python fails on get_type_hints(URIRef)

[ticapix]

Hello,

Using rdflib-7.1.4 and python 3.13.6, I'm getting an error with this code:

from typing import get_type_hints

import rdflib
from rdflib import URIRef
from rdflib.paths import Path

print(rdflib.__version__)
print("Path", get_type_hints(Path))  # <- works
print("URIRef", get_type_hints(URIRef))  # <- fails

7.1.4
Path {'__or__': typing.Callable[[rdflib.paths.Path, typing.Union[rdflib.term.URIRef, rdflib.paths.Path]], rdflib.paths.AlternativePath], '__invert__': typing.Callable[[rdflib.paths.Path], rdflib.paths.InvPath], '__neg__': typing.Callable[[rdflib.paths.Path], rdflib.paths.NegatedPath], '__truediv__': typing.Callable[[rdflib.paths.Path, typing.Union[rdflib.term.URIRef, rdflib.paths.Path]], rdflib.paths.SequencePath], '__mul__': typing.Callable[[rdflib.paths.Path, str], rdflib.paths.MulPath]}
Traceback (most recent call last):
  File "test.py", line 38, in <module>
    print("URIRef", get_type_hints(URIRef))
                    ~~~~~~~~~~~~~~^^^^^^^^
  File "/home/linuxbrew/.linuxbrew/opt/python@3.13/lib/python3.13/typing.py", line 2461, in get_type_hints
    value = _eval_type(value, base_globals, base_locals, base.__type_params__)
  File "/home/linuxbrew/.linuxbrew/opt/python@3.13/lib/python3.13/typing.py", line 474, in _eval_type
    return t._evaluate(globalns, localns, type_params, recursive_guard=recursive_guard)
           ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/linuxbrew/.linuxbrew/opt/python@3.13/lib/python3.13/typing.py", line 1081, in _evaluate
    eval(self.__forward_code__, globalns, localns),
    ~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "<string>", line 1, in <module>
NameError: name 'Path' is not defined. Did you mean: 'math'?

Any clue why ?

thank you,
Pierre

[ticapix]

Temporary fix is to add dummy class declarations in rdflib/term.py which is not a viable solution.

if TYPE_CHECKING:
    from .namespace import NamespaceManager
    from .paths import AlternativePath, InvPath, NegatedPath, Path, SequencePath

class AlternativePath:...  # added
class InvPath: ...  # added
class NegatedPath: ...  # added
class Path: ...  # added
class SequencePath: ...  # added

[ticapix]

or a bit better without modifying rdflib code, is to add the missing declarations in the localns parameter.

from typing import Callable, Union, get_type_hints
from rdflib.paths import AlternativePath, InvPath, NegatedPath, Path, SequencePath

print(
    "URIRef",
    get_type_hints(
        URIRef,
        globalns={
            "Path": Path,
            "Callable": Callable,
            "URIRef": URIRef,
            "Union": Union,
            "AlternativePath": AlternativePath,
            "InvPath": InvPath,
            "NegatedPath": NegatedPath,
            "SequencePath": SequencePath,
        },
    ),
)