atoti.tables.Tables.readers#

property Tables.readers: MutableSet[str]#

The roles allowing to read data from tables.

Example

>>> session_config = tt.SessionConfig(security=tt.SecurityConfig())
>>> session = tt.Session.start(session_config)
>>> table = session.create_table(
...     "Table", data_types={"ID": "String", "Value": "int"}, keys={"ID"}
... )
>>> table += ("foo", 42)
>>> session.tables.readers
{'ROLE_USER'}
>>> authentication = tt.BasicAuthentication("username", "passwd")
>>> session.security.individual_roles[authentication.username] = {
...     "ROLE_USER"
... }
>>> session.security.basic_authentication.credentials[
...     authentication.username
... ] = authentication.password

The user has one of the readers roles and can thus read data from the table:

>>> with tt.Session.connect(
...     session.url, authentication=authentication
... ) as connected_session:
...     connected_session.tables[table.name].query()
    ID  Value
0  foo     42

Changing the readers roles to revoke access:

>>> session.tables.readers.clear()
>>> with tt.Session.connect(
...     session.url, authentication=authentication
... ) as connected_session:
...     try:
...         connected_session.tables[table.name].query()
...     except Exception as error:
...         error.response.status_code
400