MyCapytain.resources.texts package¶

class MyCapytain.resources.texts.tei.Citation(name=None, xpath=None, scope=None, refsDecl=None, child=None)[source]¶

Implementation of Citation for TEI markup

static ingest(resource, xpath='.//tei:cRefPattern')[source]¶

Ingest a resource and store data in its instance

Parameters:	resource (lxml.etree._Element) – XML node cRefPattern or list of them in ASC hierarchy order (deepest to highest, eg. lines to poem to book) xpath (str) – XPath to use to retrieve citation
Returns:	A citation object
Return type:	Citation

class MyCapytain.resources.texts.local.Text(urn=None, citation=None, resource=None)[source]¶

Implementation of CTS tools for local files

Parameters:	urn (MyCapytain.common.reference.URN) – A URN identifier resource (lxml.etree._Element) – A resource citation (MyCapytain.common.reference.Citation) – Highest Citation level
Variables:	resource – lxml

citation¶

Get the lowest cRefPattern in the hierarchy

Return type:	MyCapytain.resources.texts.tei.Citation

getPassage(reference)[source]¶

Finds a passage in the current text

Parameters:	reference (List, MyCapytain.common.reference.Reference) – Identifier of the subreference / passages
Return type:	Passage
Returns:	Asked passage

getPassagePlus(reference)[source]¶

Finds a passage in the current text with its previous and following node

Parameters:	reference (List, MyCapytain.common.reference.Reference) – Identifier of the subreference / passages
Return type:	text.PassagePlus
Returns:	Asked passage with metainformations

getValidReff(level=1, reference=None)[source]¶

Retrieve valid passages directly

Parameters:	level (Int) – Depth required. If not set, should retrieve first encountered level (1 based) reference (Reference) – Subreference (optional)
Return type:	List.basestring
Returns:	List of levels

Note

GetValidReff works for now as a loop using Passage, subinstances of Text, to retrieve the valid informations. Maybe something is more powerfull ?