knora-py is a python package containing a command line tool for data model (ontology) creation, a library allowing creation of single resources and mass upload using the bulk import of data into the Knora framework.
The package consists of:
KnoraPython modules for accessing Knora using the API (ontology creation, data import/export etc.)
knora-create-ontologyA command line program to create an ontology out of a simple JSON description
knora-reset-triplestoreA command line program to reset the content of the ontology. Does not require a restart of the Knora-Stack.
Go to Full Documentation
To install the latest published version from PyPI, run:
$ pip3 install knora
To upgrade to the latest published version, run:
$ pip3 install --upgrade knora
Local Development Environment
Please consult the https://docs.dasch.swiss/developers documentation on how to install these prerequisites.
Makefile for repository management tasks
The project contains a Makefile defining management tasks. Please use
make help to see what is available.
To install from source, i.e., this repository, run:
$ make install
$ make test
Publishing to PyPi
Generate distribution package. Make sure you have the latest versions of
$ make upgrade $ make dist
You can install the package locally from the dist:
$ python3 -m pip ./dist/some_name.whl
Upload package with
[distutils] index-servers=pypi [pypi] repository = https://upload.pypi.org/legacy/ username =your_username_on_pypi
$ make upload
For local development:
$ python3 setup.py --editable .
To install the requirements:
$ pip3 install -r requirements.txt
To generate a "requirements" file (usually requirements.txt), that you commit with your project, do:
$ pip3 freeze > requirements.txt
Running tests with Bazel
Run all tests:
$ bazel test //...
Run single test:
$ bazel test //test:test_knora