Source code for MyCapytain.resources.prototypes.text

# -*- coding: utf-8 -*-
"""
.. module:: MyCapytain.resources.proto.text
   :synopsis: Prototypes for CtsText

.. moduleauthor:: Thibault Clérice <leponteineptique@gmail.com>


"""
from typing import Union, List, Iterator
from rdflib.namespace import DC, DCTERMS as DCT
from rdflib import BNode, URIRef, Graph, Literal
from rdflib.term import Identifier
from MyCapytain.common.reference import Citation, NodeId, BaseReference, BaseReferenceSet
from MyCapytain.common.metadata import Metadata
from MyCapytain.common.constants import Mimetypes, get_graph, RDF_NAMESPACES
from MyCapytain.common.base import Exportable
from MyCapytain.resources.prototypes.metadata import Collection


__all__ = [
    "TextualElement",
    "TextualGraph",
    "TextualNode",
    "InteractiveTextualNode"
]


[docs]class TextualElement(Exportable): """ Node representing a text passage. :param identifier: Identifier of the text :type identifier: str :param metadata: Collection Information about the Item :type metadata: Collection :cvar default_exclude: Default exclude for exports """ default_exclude = [] def __init__(self, identifier: str=None, metadata: Metadata=None): self._graph = get_graph() self._identifier = identifier self._node = BNode() self._metadata = metadata or Metadata(node=self.asNode()) self._graph.addN([ (self._node, RDF_NAMESPACES.DTS.implements, URIRef(identifier), self._graph)#, #(self.__node__, RDF_NAMESPACES.DTS.metadata, self.metadata.asNode(), self.__graph__) ]) def __repr__(self) -> str: return "%s(%s)" % (self.__class__.__name__, self.id) @property def graph(self) -> Graph: return self._graph @property def text(self) -> str: """ String representation of the text :return: String representation of the text """ return self.export(output=Mimetypes.PLAINTEXT, exclude=self.default_exclude) @property def id(self) -> str: """ Identifier of the text :return: Identifier of the text """ return self._identifier @property def metadata(self) -> Metadata: """ Metadata information about the text :return: Collection object with metadata about the text :rtype: Metadata """ return self._metadata
[docs] def asNode(self) -> Identifier: return self._node
[docs] def get_creator(self, lang: str=None) -> Literal: """ Get the DC Creator literal value :param lang: Language to retrieve :return: Creator string representation :rtype: Literal """ return self.metadata.get_single(key=DC.creator, lang=lang)
[docs] def set_creator(self, value: Union[Literal, Identifier, str], lang: str= None): """ Set the DC Creator literal value :param value: Value of the creator node :param lang: Language in which the value is """ self.metadata.add(key=DC.creator, value=value, lang=lang)
[docs] def get_title(self, lang: str=None) -> Literal: """ Get the title of the object :param lang: Lang to retrieve :return: Title string representation :rtype: Literal """ return self.metadata.get_single(key=DC.title, lang=lang) or \ self.metadata.get_single(key=DCT.title, lang=lang)
[docs] def set_title(self, value: Union[Literal, Identifier, str], lang: str= None): """ Set the DC Title literal value :param value: Value of the title node :param lang: Language in which the value is """ return self.metadata.add(key=DC.title, value=value, lang=lang)
[docs] def get_description(self, lang: str=None) -> Literal: """ Get the description of the object :param lang: Lang to retrieve :return: Description string representation :rtype: Literal """ return self.metadata.get_single(key=DC.description, lang=lang)
[docs] def set_description(self, value: Union[Literal, Identifier, str], lang: str= None): """ Set the DC Description literal value :param value: Value of the title node :param lang: Language in which the value is """ return self.metadata.add(key=DC.description, value=value, lang=lang)
[docs] def get_subject(self, lang=None) -> Literal: """ Get the subject of the object :param lang: Lang to retrieve :return: Subject string representation :rtype: Literal """ return self.metadata.get_single(key=DC.subject, lang=lang)
[docs] def set_subject(self, value: Union[Literal, Identifier, str], lang: str= None): """ Set the DC Subject literal value :param value: Value of the subject node :param lang: Language in which the value is """ return self.metadata.add(key=DC.subject, value=value, lang=lang)
[docs] def export(self, output: str=None, exclude: List[str]=None, **kwargs): """ Export the collection item in the Mimetype required. ..note:: If current implementation does not have special mimetypes, reuses default_export method :param output: Mimetype to export to (Uses MyCapytain.common.constants.Mimetypes) :type output: str :param exclude: Information to exclude. Specific to implementations :type exclude: [str] :return: Object using a different representation """ return Exportable.export(self, output, exclude=exclude, **kwargs)
[docs]class TextualNode(TextualElement, NodeId): """ Node representing a text passage. :param identifier: Identifier of the text :type identifier: str :param metadata: Collection Information about the Item :type metadata: Collection :param citation: XmlCtsCitation system of the text :type citation: Citation :param children: Current node Children's Identifier :type children: [str] :param parent: Parent of the current node :type parent: str :param siblings: Previous and next node of the current node :type siblings: str :param depth: Depth of the node in the global hierarchy of the text tree :type depth: int :cvar default_exclude: Default exclude for exports """ def __init__(self, identifier: str=None, citation: Citation=None, **kwargs): super(TextualNode, self).__init__(identifier=identifier, **kwargs) self._citation = citation or Citation() @property def citation(self) -> Citation: """ Citation system of the object :rtype: Citation """ return self._citation @citation.setter def citation(self, value: Citation): if not isinstance(value, Citation): raise TypeError("Citation property can only host a Citation object") self._citation = value
[docs]class TextualGraph(TextualNode): """ Node representing a text passage. :param identifier: Identifier of the text :type identifier: str :param metadata: Collection Information about the Item :type metadata: Collection :param citation: XmlCtsCitation system of the text :type citation: Citation :param children: Current node Children's Identifier :type children: [str] :param parent: Parent of the current node :type parent: str :param siblings: Previous and next node of the current node :type siblings: str :param depth: Depth of the node in the global hierarchy of the text tree :type depth: int :param resource: Resource used to navigate through the textual graph :cvar default_exclude: Default exclude for exports """ def __init__(self, identifier: str=None, **kwargs): super(TextualGraph, self).__init__(identifier=identifier, **kwargs)
[docs] def getTextualNode(self, subreference: BaseReference) -> "TextualGraph": """ Retrieve a passage and store it in the object :param subreference: CtsReference of the passage to retrieve :returns: Object representing the passage :raises: *TypeError* when reference is not a list or a CtsReference """ raise NotImplementedError()
[docs] def getReffs(self, level: int=1, subreference: BaseReference=None) -> BaseReferenceSet: """ CtsReference available at a given level :param level: Depth required. If not set, should retrieve first encountered level (1 based) :param subreference: Subreference (optional) :returns: List of levels """ raise NotImplementedError()
[docs]class InteractiveTextualNode(TextualGraph): """ Node representing a text passage. :param identifier: Identifier of the text :type identifier: str :param metadata: Collection Information about the Item :type metadata: Collection :param citation: XmlCtsCitation system of the text :type citation: Citation :param children: Current node Children's Identifier :type children: [str] :param parent: Parent of the current node :type parent: str :param siblings: Previous and next node of the current node :type siblings: str :param depth: Depth of the node in the global hierarchy of the text tree :type depth: int :param resource: Resource used to navigate through the textual graph :cvar default_exclude: Default exclude for exports """ def __init__(self, identifier: str=None, **kwargs): super(InteractiveTextualNode, self).__init__(identifier=identifier, **kwargs) self._childIds = None @property def prev(self) -> "InteractiveTextualNode": """ Get Previous TextualNode """ if self.prevId is not None: return self.getTextualNode(self.prevId) @property def next(self) -> "InteractiveTextualNode": """ Get Next TextualNode """ if self.nextId is not None: return self.getTextualNode(self.nextId) @property def children(self) -> Iterator["InteractiveTextualNode"]: """ Children TextualNode """ for ID in self.childIds: yield self.getTextualNode(ID) @property def parent(self) -> "InteractiveTextualNode": """ Parent TextualNode """ return self.getTextualNode(self.parentId) @property def first(self) -> TextualNode: """ First TextualNode """ if self.firstId is not None: return self.getTextualNode(self.firstId) @property def last(self) -> TextualNode: """ Last CapitainsCtsPassage """ if self.lastId is not None: return self.getTextualNode(self.lastId) @property def childIds(self) -> BaseReferenceSet: """ Identifiers of children :return: Identifiers of children """ if self._childIds is None: self._childIds = self.getReffs() return self._childIds @property def firstId(self) -> BaseReference: """ First child's id of current TextualNode """ if self.childIds is not None: if len(self.childIds) > 0: return self.childIds[0] return None else: raise NotImplementedError @property def lastId(self) -> BaseReference: """ Last child's id of current TextualNode """ if self.childIds is not None: if len(self.childIds) > 0: return self.childIds[-1] return None else: raise NotImplementedError