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.
110 lines
2.3 KiB
110 lines
2.3 KiB
"""
|
|
Errors, oh no!
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from typing import TYPE_CHECKING, Any
|
|
|
|
import attrs
|
|
|
|
from referencing._attrs import frozen
|
|
from referencing.typing import URI
|
|
|
|
if TYPE_CHECKING:
|
|
from referencing import Resource
|
|
|
|
|
|
@frozen
|
|
class NoSuchResource(KeyError):
|
|
"""
|
|
The given URI is not present in a registry.
|
|
"""
|
|
|
|
ref: URI
|
|
|
|
def __eq__(self, other: Any) -> bool:
|
|
if self.__class__ is not other.__class__:
|
|
return NotImplemented
|
|
return attrs.astuple(self) == attrs.astuple(other)
|
|
|
|
|
|
@frozen
|
|
class NoInternalID(Exception):
|
|
"""
|
|
A resource has no internal ID, but one is needed.
|
|
|
|
E.g. in modern JSON Schema drafts, this is the ``$id`` keyword.
|
|
|
|
One might be needed if a resource was to-be added to a registry but no
|
|
other URI is available, and the resource doesn't declare its canonical URI.
|
|
"""
|
|
|
|
resource: Resource[Any]
|
|
|
|
def __eq__(self, other: Any) -> bool:
|
|
if self.__class__ is not other.__class__:
|
|
return NotImplemented
|
|
return attrs.astuple(self) == attrs.astuple(other)
|
|
|
|
|
|
@frozen
|
|
class Unretrievable(KeyError):
|
|
"""
|
|
The given URI is not present in a registry, and retrieving it failed.
|
|
"""
|
|
|
|
ref: URI
|
|
|
|
|
|
@frozen
|
|
class CannotDetermineSpecification(Exception):
|
|
"""
|
|
Attempting to detect the appropriate `Specification` failed.
|
|
|
|
This happens if no discernible information is found in the contents of the
|
|
new resource which would help identify it.
|
|
"""
|
|
|
|
contents: Any
|
|
|
|
|
|
@attrs.frozen
|
|
class Unresolvable(Exception):
|
|
"""
|
|
A reference was unresolvable.
|
|
"""
|
|
|
|
ref: URI
|
|
|
|
def __eq__(self, other: Any) -> bool:
|
|
if self.__class__ is not other.__class__:
|
|
return NotImplemented
|
|
return attrs.astuple(self) == attrs.astuple(other)
|
|
|
|
|
|
@frozen
|
|
class PointerToNowhere(Unresolvable):
|
|
"""
|
|
A JSON Pointer leads to a part of a document that does not exist.
|
|
"""
|
|
|
|
resource: Resource[Any]
|
|
|
|
def __str__(self):
|
|
return f"{self.ref!r} does not exist within {self.resource.contents!r}"
|
|
|
|
|
|
@frozen
|
|
class NoSuchAnchor(Unresolvable):
|
|
"""
|
|
An anchor does not exist within a particular resource.
|
|
"""
|
|
|
|
resource: Resource[Any]
|
|
anchor: str
|
|
|
|
def __str__(self):
|
|
return (
|
|
f"{self.anchor!r} does not exist within {self.resource.contents!r}"
|
|
)
|