https://github.com/delb-xml/delb-existdb

A Python database interface for eXist-db
https://github.com/delb-xml/delb-existdb

database-adapter database-interface exist-db python xml

Last synced: 11 days ago
JSON representation

A Python database interface for eXist-db

• Host: GitHub
• URL: https://github.com/delb-xml/delb-existdb
• Owner: delb-xml
• License: mit
• Created: 2019-08-08T15:57:31.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2026-03-01T10:43:26.000Z (about 1 month ago)
• Last Synced: 2026-03-01T14:45:16.348Z (about 1 month ago)
• Topics: database-adapter, database-interface, exist-db, python, xml
• Language: Python
• Homepage: https://snakesist.readthedocs.io
• Size: 525 KB
• Stars: 15
• Watchers: 5
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
delb-existdb

============

.. image:: https://img.shields.io/pypi/l/delb-existdb.svg

    :target: https://github.com/delb-xml/delb-existdb/blob/main/LICENSE.txt

    :alt: License

.. image:: https://img.shields.io/pypi/pyversions/delb-existdb.svg

    :alt: Python versions

.. image:: https://readthedocs.org/projects/delb-existdb/badge/?version=latest

    :target: https://delb-existdb.readthedocs.io/en/latest/

    :alt: Documentation Status

``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:

.. code-block:: python

    >>> 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:

.. code-block:: python

    >>> 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:

.. code-block:: python

    >>> [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.

Your eXist-db instance

----------------------

*delb-existdb* leverages eXist's `RESTful API`_ for database operations. This

means that allowing database queries using POST requests on the RESTful API is

a requirement in the used eXist-db instance. eXist allows this by default, so

if you haven't configured your instance otherwise, don't worry about it.

We aim to directly support all most recent releases from each major branch.

Yet, there's no guarantee that releases older than two years will be kept as a

target for tests. Pleaser refer to the values

``tool.hatch.envs.tests.matrix.existdb_version`` in the `pyproject.toml`_ for

what's currently considered.

.. _delb: https://delb.readthedocs.io/

.. _documents collection: https://exist-db.org/exist/apps/doc/using-collections

.. _eXist-db: https://exist-db.org/

.. _pyproject.toml: https://github.com/delb-xml/delb-existdb/blob/main/pyproject.toml

.. _RESTful API: https://www.exist-db.org/exist/apps/doc/devguide_rest.xml

.. _delb-existdb: https://pypi.org/p/delb-existdb