You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
63 lines
1.4 KiB
63 lines
1.4 KiB
"""
|
|
Type-annotation related support for the referencing library.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from typing import TYPE_CHECKING, Protocol, TypeVar
|
|
|
|
try:
|
|
from collections.abc import Mapping as Mapping
|
|
|
|
Mapping[str, str]
|
|
except TypeError: # pragma: no cover
|
|
from typing import Mapping as Mapping
|
|
|
|
|
|
if TYPE_CHECKING:
|
|
from referencing._core import Resolved, Resolver, Resource
|
|
|
|
#: A URI which identifies a `Resource`.
|
|
URI = str
|
|
|
|
#: The type of documents within a registry.
|
|
D = TypeVar("D")
|
|
|
|
|
|
class Retrieve(Protocol[D]):
|
|
"""
|
|
A retrieval callable, usable within a `Registry` for resource retrieval.
|
|
|
|
Does not make assumptions about where the resource might be coming from.
|
|
"""
|
|
|
|
def __call__(self, uri: URI) -> Resource[D]:
|
|
"""
|
|
Retrieve the resource with the given URI.
|
|
|
|
Raise `referencing.exceptions.NoSuchResource` if you wish to indicate
|
|
the retriever cannot lookup the given URI.
|
|
"""
|
|
...
|
|
|
|
|
|
class Anchor(Protocol[D]):
|
|
"""
|
|
An anchor within a `Resource`.
|
|
|
|
Beyond "simple" anchors, some specifications like JSON Schema's 2020
|
|
version have dynamic anchors.
|
|
"""
|
|
|
|
@property
|
|
def name(self) -> str:
|
|
"""
|
|
Return the name of this anchor.
|
|
"""
|
|
...
|
|
|
|
def resolve(self, resolver: Resolver[D]) -> Resolved[D]:
|
|
"""
|
|
Return the resource for this anchor.
|
|
"""
|
|
...
|