synology_apm_repo.sdk.units.saas.tree_strategy.named_group_flat module

NamedGroupFlatTree: Calendar’s shape — the flat-list variant of this package’s two tree shapes: an outer table whose rows are the named groups, with a separately-queried flat leaf table grouped by a foreign key, rather than parent-pointer recursion (Drive, Site’s document libraries, Contact folders).

class synology_apm_repo.sdk.units.saas.tree_strategy.named_group_flat.NamedGroupFlatTree(provider, *, group_table, group_columns, group_id_column, group_name_column, leaf_table, leaf_columns, leaf_id_column, leaf_group_column, display_name, order_by, group_name_override=None)

Bases: object

Calendar’s shape: an outer table whose rows are the groups (with their own display-name column); an inner table holds flat leaves grouped by a foreign key. The outer listing is a one-shot full scan + paginate slice (small, bounded — every real “level” is the event count within one calendar, not the calendar count itself); the leaf level gets a real WHERE/ORDER BY/ LIMIT/OFFSET query. group_name_override lets a caller replace a specific group’s own name; unused (None) means every group shows its group_name_column value verbatim.

async children_of(key, *, offset=0, limit=None)

row_for(key)