plystra 1.0.0.dev2

Official Python SDK for Plystra.

plystra

Official Python SDK for Plystra Core v1.0.

PyPI package name: plystra

Install

pip install plystra

Synchronous Usage

from plystra import Plystra

with Plystra("http://localhost:8080") as plystra:
    plystra.auth.login("[e-mail]", "plystra-demo")

    decision = plystra.authz.check(
        actor={
            "user_id": "user_alice",
            "space_id": "space_acme",
            "member_id": "member_finance_reviewer",
            "user_member_id": "um_alice_finance_reviewer",
        },
        resource_type="invoice",
        resource_id="invoice_001",
        action="approve",
    )

    print(decision["decision"])

Asynchronous Usage

import asyncio
from plystra import AsyncPlystra


async def main() -> None:
    async with AsyncPlystra("http://localhost:8080") as plystra:
        await plystra.auth.login("[e-mail]", "plystra-demo")
        decision = await plystra.authz.check(
            actor_user_id="user_alice",
            actor_member_id="member_finance_reviewer",
            actor_user_member_id="um_alice_finance_reviewer",
            space_id="space_acme",
            resource_type="invoice",
            resource_id="invoice_001",
            action="approve",
        )
        print(decision["decision"])


asyncio.run(main())

Modules

The SDK exposes v1.0 Core modules as attributes:

• system
• auth
• actor
• admin
• users
• spaces
• groups
• members
• user_members
• roles
• member_roles
• permissions
• role_permissions
• resource_types
• resources
• authz
• audit
• data
• plugins
• templates

Non-public endpoints require a Bearer session whose user has an active admin grant.