[iLLiCiTiT]

Changelog Description

Attributes of entities in EntityHub can return values inherited from parent entities. Folders inherit from parent folders and the project, tasks inherit from their folder.

task.attribs.get("frameStart")            # own value, None if not set
task.attribs.get_inherited("frameStart")  # own value or value of closest parent that has it set
task.attribs.to_dict(inherited=True)      # all attributes with inheritance applied
task.attribs.inherited_items()

Additional info

EntityHub queries entities with own_attributes=True, so there was no way to get the effective value of an attribute.

• Inheritance follows the server: only folders and tasks inherit, only attributes with inherit enabled in their schema, and only when the own value is None.
• Values are resolved on each call by walking current parents in the hub, so uncommitted changes on parents (or a changed parent) are reflected immediately. Parents that are not loaded yet are fetched.
• Fixed get_or_fetch_entity_by_id raising ValueError for the project id with "project" entity type when the project was not loaded yet. It now returns project_entity.

Testing notes:

1. Create EntityHub for a project with nested folders, e.g. /ep01/sq01/sh0100, where only ep01 has frameStart set.
2. Get sh0100 (or its task) and check attribs.get("frameStart") is None and attribs.get_inherited("frameStart") returns the value from ep01.
3. Compare attribs.to_dict(inherited=True, ignore_none=False) with attrib of the same entity queried from server; they should match.
4. Change frameStart on ep01 in the hub (without commit) and check get_inherited on sh0100 returns the new value. Set a value on sq01 and check it takes precedence.

[Copilot]

🟡 Changes recommended

Integration tests are missing for the new inherited-entity API, leaving closest-parent precedence, project fallback, opt-out behavior, and uncommitted parent changes unverified.

1 open issue

• Add tests for inherited attribute resolution · New

What changed in this PR

Adds inherited attribute support to EntityHub, allowing folders and tasks to resolve effective values from their parent hierarchy while preserving access to their own values.

Changes:

• Adds get_inherited, inherited_items, and inherited-aware to_dict.
• Resolves parent attributes dynamically, including unloaded parents and uncommitted changes.
• Fixes lazy project entity lookup by project ID.

File	Summary
ayon_api/​entity_hub.py	Implements inherited attribute resolution and project lookup fixes. Review findings: treat a missing inherit schema flag as false (moderate, 1 vote); materialize one-shot entity_types iterables before membership checks (moderate, 1 vote); continue parent traversal when an intermediate schema lacks the attribute (moderate, 1 vote); add integration coverage for inheritance behavior (nit, 4 votes).

_{Review effort: Lite}