EpiDoc Parser
Python parser for EpiDoc (epigraphic documents in TEI XML).
For example idp.data-sheet uses the parser to generate a single CSV sheet of the Papyri.info Integrating Digital Papyrology data.
Usage
Installation
Install the package
pip install git+https://github.com/Xennis/epidoc-parser
Load a document
Load a document from a file
import epidoc
with open("my-epidoc.xml") as f:
doc = epidoc.load(f)
Load a document from a string
import epidoc
my_epidoc = """<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="http://www.stoa.org/epidoc/schema/8.13/tei-epidoc.rng" type="application/xml" schematypens="http://relaxng.org/ns/structure/1.0"?>
<TEI xmlns="http://www.tei-c.org/ns/1.0" xml:id="hgv74005">
[...]
</TEI>
"""
doc = epidoc.loads(my_epidoc)
Get data from a document
Call the attributes, for example
>>> doc.title
"Ordre de paiement"
>>> doc.material
"ostrakon"
>>> doc.languages
{"en": "Englisch", "la": "Latein", "el": "Griechisch"}
>>> [t.get("text") for t in doc.terms]
["Anweisung", "Zahlung", "Getreide"]
>>> doc.origin_place.get("text")
"Kysis (Oasis Magna)"
>>> doc.origin_dates[0]
{"notbefore": "0301", "notafter": "0425", "precision": "low", "text": "IV - Anfang V"}
Documentation
| Field | EpiDoc source element (XPath) |
|---|---|
| commentary | //body/div[@type='commentary' and @subtype='general'] |
| edition_foreign_languages | //body/div[@type='edition']//foreign/@xml:lang |
| edition_language | //body/div[@type='edition']/@xml:lang |
| idno | //teiHeader/fileDesc/publicationStmt/idno |
| authority | //teiHeader/fileDesc/publicationStmt/authority |
| availability | //teiHeader/fileDesc/publicationStmt/availability |
| languages | //teiHeader/profileDesc/langUsage/language |
| material | //teiHeader/fileDesc/sourceDesc/msDesc/physDesc/objectDesc//support/material |
| origin_dates | //teiHeader/fileDesc/sourceDesc/msDesc/history/origin/origDate |
| origin_place | //teiHeader/fileDesc/sourceDesc/msDesc/history/origin/origPlace |
| provenances | //teiHeader/fileDesc/sourceDesc/msDesc/history/provenance |
| reprint_from | //body/ref[@type='reprint-from'] |
| reprint_in | //body/ref[@type='reprint-in'] |
| terms | //teiHeader/profileDesc/textClass//term |
| title | //teiHeader/fileDesc/titleStmt/title |
Development
Create a virtual environment, enable it and install the dependencies
python3 -m venv venv
. venv/bin/activate
pip install --requirement requirements.txt
Run the test
make unittest
LICENSE
Code
see LICENSE
Test data
The test data in this project is from the project idp.data by Papyri.info. This data is made available under a Creative Commons Attribution 3.0 License, with copyright and attribution to the respective projects.