"""Common code for permissions."""
from typing import (  # noqa: F401
    Mapping, Union, Any)

# MyPy doesn't support recursion yet. So writing it out as far as we need.

ValueType = Union[
    # Example: entities.all = { read: true, control: true }
    Mapping[str, bool],
    bool,
    None
]

SubCategoryType = Union[
    # Example: entities.domains = { light: … }
    Mapping[str, ValueType],
    bool,
    None
]

CategoryType = Union[
    # Example: entities.domains
    Mapping[str, SubCategoryType],
    # Example: entities.all
    Mapping[str, ValueType],
    bool,
    None
]

# Example: { entities: … }
PolicyType = Mapping[str, CategoryType]

SUBCAT_ALL = 'all'