cognite-neat 0.88.2__py3-none-any.whl → 0.88.3__py3-none-any.whl

cognite/neat/rules/issues/fileread.py

@@ -1,197 +0,0 @@
-from abc import ABC
-from dataclasses import dataclass
-from pathlib import Path
-
-from .base import NeatValidationError, ValidationWarning
-
-__all__ = [
-    "FileReadWarning",
-    "InvalidFileFormatWarning",
-    "UnsupportedSpecWarning",
-    "UnknownItemWarning",
-    "FailedLoadWarning",
-    "BugInImporterWarning",
-    "FileReadError",
-    "FileNotFoundError",
-    "FileNotAFileError",
-    "InvalidFileFormatError",
-    "FailedStringLoadError",
-]
-
-
-@dataclass(frozen=True)
-class FileReadError(NeatValidationError, ABC):
-    description = "An error was raised during reading."
-    fix = "No fix is available."
-
-    filepath: Path
-
-    def dump(self) -> dict[str, str | None]:
-        output = super().dump()
-        output["filepath"] = str(self.filepath)
-        return output
-
-
-@dataclass(frozen=True)
-class FileReadWarning(ValidationWarning, ABC):
-    description = "A warning was raised during reading."
-    fix = "No fix is available."
-
-    filepath: Path
-
-    def dump(self) -> dict[str, str | None]:
-        output = super().dump()
-        output["filepath"] = str(self.filepath)
-        return output
-
-
-@dataclass(frozen=True)
-class InvalidFileFormatWarning(FileReadWarning):
-    description = "The file format is invalid"
-    fix = "Check if the file format is supported."
-
-    reason: str
-
-    def message(self) -> str:
-        return f"Skipping invalid file {self.filepath.name}: {self.reason}"
-
-    def dump(self) -> dict[str, str | None]:
-        output = super().dump()
-        output["reason"] = self.reason
-        return output
-
-
-@dataclass(frozen=True)
-class UnsupportedSpecWarning(FileReadWarning):
-    description = "The spec in the file is not supported"
-    fix = "Change to an supported spec"
-
-    spec_name: str
-    version: str | None = None
-
-    def message(self) -> str:
-        if self.version:
-            suffix = f"{self.spec_name} v{self.version} is not supported."
-        else:
-            suffix = f"{self.spec_name} is not supported."
-        return f"Skipping file {self.filepath.name}: {suffix}. {self.fix}"
-
-    def dump(self) -> dict[str, str | None]:
-        output = super().dump()
-        output["spec_name"] = self.spec_name
-        output["version"] = self.version
-        return output
-
-
-@dataclass(frozen=True)
-class UnknownItemWarning(FileReadWarning):
-    description = "The file is missing an implementation"
-    fix = "Check if the file is supported. If not, contact the neat team on Github."
-
-    reason: str
-
-    def message(self) -> str:
-        return f"Skipping file {self.filepath.name}: {self.reason}. {self.fix}"
-
-    def dump(self) -> dict[str, str | None]:
-        output = super().dump()
-        output["reason"] = self.reason
-        return output
-
-
-@dataclass(frozen=True)
-class FailedLoadWarning(FileReadWarning):
-    description = "The file content is invalid"
-    fix = "Check if the file content is valid"
-
-    expected_format: str
-    error_message: str
-
-    def message(self) -> str:
-        return (
-            f"Failed to load {self.filepath.name}. Expected format: {self.expected_format}. Error: {self.error_message}"
-        )
-
-    def dump(self) -> dict[str, str | None]:
-        output = super().dump()
-        output["expected_format"] = self.expected_format
-        output["error_message"] = self.error_message
-        return output
-
-
-@dataclass(frozen=True)
-class BugInImporterWarning(FileReadWarning):
-    description = "A bug was raised during reading."
-    fix = "No fix is available. Contact the neat team on Github"
-
-    importer_name: str
-    error: str
-
-    def message(self) -> str:
-        return f"Bug in importer {self.importer_name} when reading {self.filepath.name}: {self.error}"
-
-    def dump(self) -> dict[str, str | None]:
-        output = super().dump()
-        output["importer_name"] = self.importer_name
-        output["error"] = self.error
-        return output
-
-
-@dataclass(frozen=True)
-class FileNotFoundError(FileReadError):
-    description = "The file was not found"
-    fix = "Check if the file exists."
-
-    def message(self) -> str:
-        return f"File {self.filepath} was not found. {self.fix}"
-
-
-@dataclass(frozen=True)
-class FileNotAFileError(FileReadError):
-    description = "The file is not a file"
-    fix = "Check if the file exists."
-
-    def message(self) -> str:
-        return f"{self.filepath} is not a file. {self.fix}"
-
-
-@dataclass(frozen=True)
-class InvalidFileFormatError(FileReadError):
-    description = "The file is not in the expected format"
-    fix = "Check if the file is in the expected format"
-
-    expected_format: list[str]
-
-    def message(self) -> str:
-        return f"{self.filepath} is not in the expected format. Expected format: {self.expected_format}."
-
-
-@dataclass(frozen=True)
-class FailedStringLoadError(NeatValidationError):
-    description = "The file content is invalid"
-    fix = "Check if the file content is valid"
-
-    expected_format: str
-    error_message: str
-
-    def message(self) -> str:
-        return f"Failed to load string. Expected format: {self.expected_format}. Error: {self.error_message}"
-
-    def dump(self) -> dict[str, str | None]:
-        output = super().dump()
-        output["expected_format"] = self.expected_format
-        output["error_message"] = self.error_message
-        return output
-
-
-@dataclass(frozen=True)
-class NoFilesFoundError(FileReadError):
-    description = "No files were found in the directory"
-    fix = "Check if the directory contains files"
-
-    expected_formats: list[str] | None = None
-
-    def message(self) -> str:
-        if self.expected_formats:
-            return f"No files were found in {self.filepath.name}. Expected format: {self.expected_formats}. {self.fix}"
-        return f"No files were found in {self.filepath.name}. {self.fix}"

cognite/neat/rules/issues/ontology.py

@@ -1,298 +0,0 @@
-from abc import ABC
-from dataclasses import dataclass
-from typing import ClassVar
-
-from .base import NeatValidationError, ValidationWarning
-
-__all__ = [
-    "OntologyError",
-    "OntologyWarning",
-]
-
-
-@dataclass(frozen=True)
-class OntologyError(NeatValidationError, ABC): ...
-
-
-@dataclass(frozen=True)
-class OntologyWarning(ValidationWarning, ABC): ...
-
-
-@dataclass(frozen=True)
-class OntologyMultiLabeledPropertyWarning(OntologyWarning):
-    """This warning occurs when a property is given multiple labels, typically if the
-    same property is defined for different classes but different name is given
-
-    Args:
-        property_id: property id that raised warning due to multiple labels
-        names: list of names of property
-
-    Notes:
-        This would be automatically fixed by taking the first label (aka name) of the property.
-    """
-
-    description = (
-        "This warning occurs when a property is given multiple labels,"
-        " typically if the same property is defined for different "
-        "classes but different name is given."
-    )
-    fix = "This would be automatically fixed by taking the first label (aka name) of the property."
-
-    property_id: str
-    names: list[str] | None = None
-
-    def message(self) -> str:
-        message = (
-            "Property should have single preferred label (human readable name)."
-            f"Currently property '{self.property_id}' has multiple preferred labels: {', '.join(self.names or [])} !"
-            f"Only the first name, i.e. '{self.names[0] if self.names else ''}' will be considered!"
-        )
-        message += f"\nDescription: {self.description}"
-        message += f"\nFix: {self.fix}"
-        return message
-
-
-@dataclass(frozen=True)
-class OntologyMultiDefinitionPropertyWarning(OntologyWarning):
-    """This warning occurs when a property is given multiple human readable definitions,
-    typically if the same property is defined for different classes where each definition
-    is different.
-
-    Args:
-        property_id: property id that raised warning due to multiple definitions
-
-    Notes:
-        This would be automatically fixed by concatenating all definitions.
-    """
-
-    description = (
-        "This warning occurs when a property is given multiple human readable definitions,"
-        " typically if the same property is defined for different "
-        "classes where each definition is different."
-    )
-    fix = "This would be automatically fixed by concatenating all definitions."
-
-    property_id: str
-
-    def message(self):
-        message = (
-            f"Multiple definitions (aka comments) of property '{self.property_id}' detected."
-            " Definitions will be concatenated."
-        )
-        message += f"\nDescription: {self.description}"
-        message += f"\nFix: {self.fix}"
-        return message
-
-
-@dataclass(frozen=True)
-class OntologyMultiTypePropertyWarning(OntologyWarning):
-    """This warning occurs when a same property is define for two object/classes where
-    its expected value type is different in one definition, e.g. acts as an edge, while in
-    other definition acts as and attribute
-
-    Args:
-        property_id: property id that raised warning due to multi type definition
-        types: list of types of property
-
-    Notes:
-        If a property takes different value types for different objects, simply define
-        new property. It is bad practice to have multi type property!
-    """
-
-    description = (
-        "This warning occurs when a same property is define for two object/classes where"
-        " its expected value type is different in one definition, e.g. acts as an edge, while in "
-        "other definition acts as and attribute"
-    )
-    fix = "If a property takes different value types for different objects, simply define new property"
-
-    property_id: str
-    types: list[str] | None = None
-
-    def message(self) -> str:
-        message = (
-            "It is bad practice to have multi type property! "
-            f"Currently property '{self.property_id}' is defined as multi type property: {', '.join(self.types or [])}"
-        )
-        message += f"\nDescription: {self.description}"
-        message += f"\nFix: {self.fix}"
-        return message
-
-
-@dataclass(frozen=True)
-class OntologyMultiRangePropertyWarning(OntologyWarning):
-    """This warning occurs when a property takes range of values which consists of union
-    of multiple value types
-
-    Args:
-        property_id: property id that raised warning due to multi range definition
-        range_of_values: list of ranges that property takes
-
-    Notes:
-        If a property takes different range of values, simply define new property.
-    """
-
-    description = (
-        "This warning occurs when a property takes range of values which consists of union of multiple value types."
-    )
-    fix = "If a property takes different range of values, simply define new property"
-    property_id: str
-    range_of_values: list[str] | None = None
-
-    def message(self) -> str:
-        message = (
-            "It is bad practice to have property that take various range of values! "
-            f"Currently property '{self.property_id}' has multiple ranges: {', '.join(self.range_of_values or [])}"
-        )
-        message += f"\nDescription: {self.description}"
-        message += f"\nFix: {self.fix}"
-        return message
-
-
-@dataclass(frozen=True)
-class OntologyMultiDomainPropertyWarning(OntologyWarning):
-    """This warning occurs when a property is reused for more than one classes
-
-    Args:
-        property_id: property id that raised warning due to reuse definition
-        classes: list of classes that use the same property
-        verbose: flag that indicates whether to provide enhanced exception message, by default False
-
-    Notes:
-        No need to fix this, but make sure that property type is consistent across different
-        classes and that ideally takes the same range of values
-    """
-
-    description = "This warning occurs when a property is reused for more than one classes."
-    fix = (
-        "No need to fix this, but make sure that property type is consistent"
-        " across different classes and that ideally takes the same range of values"
-    )
-    property_id: str
-    classes: list[str] | None = None
-
-    def message(self) -> str:
-        message = (
-            f"Currently property '{self.property_id}' is defined for multiple classes: {', '.join(self.classes or [])}"
-        )
-        message += f"\nDescription: {self.description}"
-        message += f"\nFix: {self.fix}"
-        return message
-
-
-@dataclass(frozen=True)
-class PropertiesDefinedMultipleTimesError(OntologyError):
-    """This error is raised during export of Transformation Rules to DMS schema when
-    when properties are defined multiple times for the same class.
-
-    Args:
-        report: report on properties which are defined multiple times
-        verbose: flag that indicates whether to provide enhanced exception message, by default False
-
-    Notes:
-       Make sure to check validation report of Transformation Rules and fix DMS related warnings.
-    """
-
-    description = (
-        "This error is raised during export of Transformation Rules to "
-        "DMS schema when properties are defined multiple times for the same class."
-    )
-    fix = "Make sure to check validation report of Transformation Rules and fix DMS related warnings."
-
-    report: str
-
-    def message(self) -> str:
-        message = f"Following properties defined multiple times for the same class(es): {self.report}"
-
-        message += f"\nDescription: {self.description}"
-        message += f"\nFix: {self.fix}"
-        return message
-
-
-@dataclass(frozen=True)
-class PropertyDefinitionsNotForSamePropertyError(OntologyError):
-    """This error is raised if property definitions are not for linked to the same
-    property id when exporting rules to ontological representation.
-
-    Args:
-        verbose: flag that indicates whether to provide enhanced exception message, by default False
-    """
-
-    description = "This error is raised if property definitions are not for linked to the same property id"
-
-    def message(self):
-        message = "All definitions should have the same property_id! Aborting."
-
-        message += f"\nDescription: {self.description}"
-        return message
-
-
-@dataclass(frozen=True)
-class PrefixMissingError(OntologyError):
-    """Prefix, which is in the 'Metadata' sheet, is missing.
-
-    Args:
-        verbose: flag that indicates whether to provide enhanced exception message, by default False
-
-    """
-
-    description = "Prefix is missing from the 'Metadata' sheet."
-    example = "There is no prefix in the 'Metadata' sheet."
-    fix = "Specify the prefix if prefix in the 'Metadata' sheet."
-
-    def message(self) -> str:
-        message = "Missing prefix stored in 'Metadata' sheet."
-        message += f"\nDescription: {self.description}"
-        message += f"\nExample: {self.example}"
-        message += f"\nFix: {self.fix}"
-        return message
-
-
-@dataclass(frozen=True)
-class MissingDataModelPrefixOrNamespaceWarning(ValidationWarning):
-    """Prefix and/or namespace are missing in the 'Metadata' sheet
-
-    Args:
-        verbose: flag that indicates whether to provide enhanced exception message, by default False
-
-    Notes:
-    Add missing prefix and/or namespace in the 'Metadata' sheet
-    """
-
-    description = "Either prefix or namespace or both are missing in the 'Metadata' sheet"
-    fix = "Add missing prefix and/or namespace in the 'Metadata' sheet"
-
-    def message(self) -> str:
-        message = (
-            "Instances sheet is present but prefix and/or namespace are missing in 'Metadata' sheet."
-            "Instances sheet will not be processed!"
-        )
-        message += f"\nDescription: {self.description}"
-        message += f"\nFix: {self.fix}"
-        return message
-
-
-@dataclass(frozen=True)
-class MetadataSheetNamespaceNotDefinedError(OntologyError):
-    """namespace, which is in the 'Metadata' sheet, is not defined
-
-    Args:
-        namespace: namespace that raised exception
-        verbose: flag that indicates whether to provide enhanced exception message, by default False
-
-    Notes:
-        Check if `namespace` in the `Metadata` sheet is properly constructed as valid URL
-        containing only allowed characters.
-
-    """
-
-    description = "namespace, which is in the 'Metadata' sheet, is missing"
-    example: ClassVar[str] = "Example of a valid namespace 'http://www.w3.org/ns/sparql#'"
-    fix = "Define the 'namespace' in the 'Metadata' sheet."
-
-    def message(self) -> str:
-        message = "Missing namespace  in 'Metadata' sheet."
-        message += f"\nDescription: {self.description}"
-        message += f"\nExample: {self.example}"
-        message += f"\nFix: {self.fix}"
-        return message