Kurra Python Library
A Python package of RDF data manipulation functions that can be called from the command line or other software.
This library uses the RDFLib under-the-hood to process RDF data. It supplies functions to:
- manipulate local RDF files
- send commands to RDF databases "triplestores"
- SPARQL query files or databases
kurra is for convenience: the functions it provides are simple but kurra saves you having to reinvent wheels.
CLI app
kurra presents a Command Line Interface that can be used on Mac, Linux and Windows (WSL) command prompts.
The hierarchy of functions provided is:
- db - run commands against RDF databases
- list
- create
- upload
- clear
- delete
- sparql
- file - run commands on local RDF files
- format
- upload
- quads
- sparql
- shacl
- validate - SHACL validate a file
- sparql - SPARQL query files or databases
Once you have installed kurra (see below), you can ask it to tell you what each command does and what inputs are needed by using the --help or just -h, command, e.g.:
kurra -h
which will return something like:
╭─ Options ─────────────────────────────────────────────────────────────────────────────────╮
│ --version -v │
│ --install-completion Install completion for the current shell. │
│ --show-completion Show completion for the current shell, to copy it or ... │
│ --help -h Show this message and exit. │
╰───────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ────────────────────────────────────────────────────────────────────────────────╮
│ db RDF database commands │
│ file RDF file commands │
│ sparql SPARQL queries to local RDF files or a database │
╰───────────────────────────────────────────────────────────────────────────────────────────╯
To find out more about the specific options within db, file & sparql, run the help command at the lext level, like this:
kurra db -h
or
kurra file -h
etc. for shacl & sparql
To get further help for the particular commands. For db, you will see something like this:
Usage: kurra db [OPTIONS] COMMAND [ARGS]...
RDF database commands
╭─ Options ─────────────────────────────────────────────────────────────────────────────────────╮
│ --help -h Show this message and exit. │
╰───────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ────────────────────────────────────────────────────────────────────────────────────╮
│ list Get the list of database repositories │
│ create Create a new database repository │
│ upload Upload files to a database repository │
│ clear Clear a database repository │
│ delete Delete a database repository │
│ sparql Query a database repository │
╰───────────────────────────────────────────────────────────────────────────────────────────────╯
Installation
CLI App
The recommended way to manage and run Python CLI apps is to use the Python package uv which you will need to install first, see the uv installation instructions. then:
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 for used of its functions in other applications
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.file import format_file, make_dataset, export_quads
Development
Install the Poetry project and its dependencies:
task install
Format code:
task code
To build a new release:
- update the version in pyproject.toml
- commit & push all changes
- git tag with the same version number
- push the tag -
git push --tags - build the release -
uv build - publish the release on PyPI -
uv publish- username__token__, pwd is an actual token - make the release on GitHub - https://github.com/Kurrawong/kurra/releases
- don't forget to add the dist zips & wheels to it
- update version number in pyproject.toml to next alpha & push
License
BSD-3-Clause license. See LICENSE.
Contact & Support
kurra is maintained by:
KurrawongAI
http://kurrawong.ai
info@kurrawong.ai
Please contact them for all use & support issues.
You can also log issues at the kurra issue tracker:
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file kurra-1.5.1.tar.gz.
File metadata
- Download URL: kurra-1.5.1.tar.gz
- Upload date:
- Size: 98.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.5.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4b9919a907135f35de7e68a60f74112d31094100fcc93d49bc2bed4122ffb1b1
|
|
| MD5 |
164548e446d8415c96bfaae5ce33410c
|
|
| BLAKE2b-256 |
755f8fe4c1f31b59c175c44bf0f12d58e9763114c23ba70b9a47223a980a8e8b
|
File details
Details for the file kurra-1.5.1-py3-none-any.whl.
File metadata
- Download URL: kurra-1.5.1-py3-none-any.whl
- Upload date:
- Size: 18.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.5.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
40865c510ed00ce75364314d83fba82ce37a67d0cfa5e5914f6c5b2c55edd3b8
|
|
| MD5 |
8b07e1f7e66e63285954dd36ba15abc1
|
|
| BLAKE2b-256 |
b99000b836592b038c60a48f087a450e439beee1e0ca0002926cbfbee99cec76
|
