kurra 0.6.3

A Python library of common code and CLI apps shared across Kurrawong projects and infrastructure.

Kurra Python Library

A Python library of RDF data manipulation functions.

This library uses the RDFLib under-the-hood to process RDF data and supplies functions to:

• upload it to RDF databases - "triplestores" - and query them
• manipulate it in a few commands - e.g. format conversion

This toolkit provides a command line interface (CLI) for doing all of this as well as presenting its functions in a library that other Python applications can use.

Command Line Interface

kurra uses a Command Line Interface that can be inspected. Once you have installed kurra (see below), you can ask it to tell you want commands it supports with --help, e.g.:

kurra --help

which will return something like:

╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --install-completion          Install completion for the current shell.                                         │
│ --show-completion             Show completion for the current shell, to copy it or customize the installation.  │
│ --help                        Show this message and exit.                                                       │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ──────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ list      Get a list of Fuseki datasets                                                                         │
│ create    Create a new Fuseki dataset                                                                           │
│ query     Query a Fuseki database                                                                               │
│ upload    Upload files to a Fuseki dataset.                                                                     │
│ format    Format RDF files using one of several common RDF formats.                                             │
│ version   Show the version of the kurra app.                                                                    │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

You can then run

kurra format --help

or

kurra create --help

etc. to get further help for the particular commands.

Installation

Install the latest version of kurra from PyPI.

CLI App

The recommended way to manage and run Python CLI apps is to use uv.

uv tool install kurra

Now you can invoke kurra anywhere in your terminal as long as ~/.local/bin is in your PATH.

See the uv documentation on installing tools for more information.

Library

You can also install kurra as a Python library.

pip install kurra

Use the relevant command to add dependencies to your project if you are using a tool like uv, poetry, or conda.

Then import it and use in your code, e.g. for the format functions:

from kurra.format import format_file, make_dataset, export_quads

Development

Install the Poetry project and its dependencies.

task install

Format code.

task code

License

BSD-3-Clause license. See LICENSE.