delb-existdb 0.4

delb-existdb is a Python database interface for eXist-db, it was initially named snakesist until its 0.3 release. It supports basic CRUD operations and uses delb’s models to represent documents and nodes. It’s available at the Python Package Index as delb-existdb package.

delb-existdb allows you to access individual documents from the database using a delb.Document object, either by simply passing a URL:

>>> from delb import Document

>>> manifest = Document(
...     "existdb://admin:@localhost:8080/exist/db/manifestos/dada_manifest.xml"
... )
>>> [header.full_text for header in manifest.xpath("//head")]
["Hugo Ball", "Das erste dadaistische Manifest"]

or by passing a relative path to the document along with a database client that is bound to an eXist documents collection which you can subsequently reuse:

>>> from delb_existdb import ExistClient

>>> exist_client = ExistClient(
...     host="localhost",
...     port=8080,
...     user="admin",
...     password="",
...     collection="/db/manifestos"
... )
>>> dada_manifest = Document("dada_manifest.xml", existdb_client=exist_client)
>>> [header.full_text for header in dada_manifest.xpath("//head")]
["Hugo Ball", "Das erste dadaistische Manifest"]
>>> communist_manifest = Document(
...     "communist_manifest.xml", existdb_client=exist_client
... )
>>> communist_manifest.xpath("//head").first.full_text
"Manifest der Kommunistischen Partei"

and not only for accessing individual documents, but also for querying nodes across multiple documents:

>>> [header.node.full_text for header in exist_client.xpath("//*:head")]
["Hugo Ball", "Das erste dadaistische Manifest", "Manifest der Kommunistischen Partei", "I. Bourgeois und Proletarier.", "II. Proletarier und Kommunisten", "III. Sozialistische und kommunistische Literatur", "IV. Stellung der Kommunisten zu den verschiedenen oppositionellen Parteien"]

You can of course also modify and store documents back into the database or create new ones and store them.