zerodev-kora

Official Python SDK for Kora.

pip install zerodev-kora

Validation

from kora import Client

kora = Client("https://kora.example.com", product="MyApp", public_key=open("kora.pem").read())

result = kora.validate("XXXXX-XXXXX-XXXXX-XXXXX")
if not result.valid:
    raise SystemExit(result.message)

result holds valid, code, message, license and timestamp. With public_key set, an answer without a valid x-kora-signature raises KoraError.

Extra fields are keyword arguments, for example the device id a whitelist group reads: kora.validate(key, hwid=machine_id).

Devices

activated = kora.activate(key, hwid=machine_id)
if activated.code == "seats_full":
    print(activated.message)

kora.deactivate(key, hwid=machine_id)

activate takes a free seat in each whitelist group of the product for the values in the request, then validates. deactivate frees them and returns success, code (deactivated, not_activated, not_found) and removed.

Offline licenses

file = admin.file(license["id"])
offline = kora.offline(file)

file downloads a signed license file with an API token. offline checks the file against public_key without a network call and raises KoraError when the signature is wrong, the license expired or refresh_after has passed. Validate online first and fall back to the file when Kora cannot be reached.

Licenses, products and customers

kora = Client("https://kora.example.com", api_key="kora_...")

product = kora.products.create(name="MyApp", version="1.0.0")
customer = kora.customers.create(name="Jane", email="jane@example.com")
license = kora.licenses.create(product_id=product["id"], customer_id=customer["id"])

page = kora.licenses.list(status="active", limit=25)
kora.licenses.update(license["id"], status="suspended")
kora.licenses.delete(license["id"])

Every resource has list, get, create, update and delete. Block a customer with customers.update(id, blocked=True) and fold a duplicate into a customer with kora.merge(id, duplicate_id). delete(id, force=True) forces removal of products and customers that still have licenses. Failed requests raise KoraError with status.

Options