synology_apm_repo.sdk.units.dispatch module

Provider dispatch. Lives in units, not catalog, so catalog never has to import units and form a cycle. target_type in {VM,PC,PS} -> DeviceProvider; FS -> FsProvider; SaaS (GWS/M365) routes through saas_provider_for, which picks an application-layer provider by the owning Workload’s catalog-derived sub_type and degrades to RawObjectProvider on recognition failure.

synology_apm_repo.sdk.units.dispatch.SUPPORTED_SAAS_SUB_TYPES = frozenset({SaasSubType.CALENDAR, SaasSubType.CONTACT, SaasSubType.DRIVE, SaasSubType.GROUP_EXCHANGE, SaasSubType.MAIL, SaasSubType.SITE, SaasSubType.TEAMS, SaasSubType.TEAM_DRIVE, SaasSubType.USER_CHAT, SaasSubType.USER_DRIVE, SaasSubType.USER_EXCHANGE})

Workload.sub_type values saas_provider_for can attempt a provider for.

synology_apm_repo.sdk.units.dispatch.is_supported(workload)

Whether workload has a chance at an application-layer provider (a DEVICE_TARGET_TYPES type via provider_for, or a SUPPORTED_SAAS_SUB_TYPES sub_type via saas_provider_for) — a plain, no-I/O check. True doesn’t guarantee every version resolves (a PC/PS version can have every disk fragment unresolvable).

async synology_apm_repo.sdk.units.dispatch.provider_for(repo, version)

Return the right ClosableUnitProvider for version, based on its target_type alone (VM/PC/PS/FS only). Does no I/O.

Raises:

UnsupportedDataFormatError – version.target_type is a SaaS type (GWS/M365) — those need the owning Workload too (for sub_type); call saas_provider_for instead.

async synology_apm_repo.sdk.units.dispatch.saas_provider_for(repo, workload, version, saas_streams)

Route one SaaS Version to its application-layer provider(s), by the owning Workload.sub_type. Tries every candidate, since M365’s USER_EXCHANGE/GROUP_EXCHANGE can hold Mail, Contact and Calendar in one version. Zero matches degrades to RawObjectProvider; exactly one is returned directly; more than one is wrapped in CompositeSaasProvider.

saas_streams is borrowed by every candidate and the fallback, so a stream opened here is reused by later calls.