Contributing¶
Quickstart¶
To install dev dependencies, create a venv and run:
pip install -r requirements-dev.txt
pip install -e .
cp example-settings.toml settings.toml
And run kisee in development mode using:
adev runserver kisee/kisee.py
Building the API doc¶
We have a description of the kisee API using OpenAPI v3, that can be checked using:
pip install openapi-spec-validator
openapi-spec-validator kisee.yaml
so we can generate some things from here, like a documentation, for example:
wget https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/5.0.0-beta2/openapi-generator-cli-5.0.0-beta2.jar -O openapi-generator-cli.jar
java -jar openapi-generator-cli.jar generate -g html2 -i kisee.yaml -o apidocs/
Or by using the plain old standalone HTML/CSS/JS swagger-ui.
Internals¶
The Kisee
daemon does not store (username, password)
tuples, but uses
a Python class, a backend
you can choose in settings.toml
to
handle the actual storage..
Kisee
provides some demo backends
and test backends
so you can
play with them. You can provide your own backend to hit your own
database, your LDAP server, or another IdP as needed.