mex.backend.merged package¶
Submodules¶
mex.backend.merged.helpers module¶
- mex.backend.merged.helpers.get_merged_item_from_graph(identifier: Identifier) MergedAccessPlatform | MergedActivity | MergedBibliographicResource | MergedConsent | MergedContactPoint | MergedDistribution | MergedOrganization | MergedOrganizationalUnit | MergedPerson | MergedPrimarySource | MergedResource | MergedVariable | MergedVariableGroup ¶
Fetch and return the merged item for the given identifier.
- mex.backend.merged.helpers.merge_search_result_item(item: dict[str, Any], validation: Literal[Validation.LENIENT]) PreviewAccessPlatform | PreviewActivity | PreviewBibliographicResource | PreviewConsent | PreviewContactPoint | PreviewDistribution | PreviewOrganization | PreviewOrganizationalUnit | PreviewPerson | PreviewPrimarySource | PreviewResource | PreviewVariable | PreviewVariableGroup ¶
- mex.backend.merged.helpers.merge_search_result_item(item: dict[str, Any], validation: Literal[Validation.STRICT]) MergedAccessPlatform | MergedActivity | MergedBibliographicResource | MergedConsent | MergedContactPoint | MergedDistribution | MergedOrganization | MergedOrganizationalUnit | MergedPerson | MergedPrimarySource | MergedResource | MergedVariable | MergedVariableGroup
- mex.backend.merged.helpers.merge_search_result_item(item: dict[str, Any], validation: Literal[Validation.IGNORE]) MergedAccessPlatform | MergedActivity | MergedBibliographicResource | MergedConsent | MergedContactPoint | MergedDistribution | MergedOrganization | MergedOrganizationalUnit | MergedPerson | MergedPrimarySource | MergedResource | MergedVariable | MergedVariableGroup | None
Merge a single search result into a merged item.
- Parameters:
item – Raw merged search result item from the graph response
validation – Merged items validate the existence of required fields and the lengths of lists by default, set this to LENIENT to avoid this and return a “preview” of a merged item instead of a valid merged item, or set this to IGNORE to return None in case of validation errors.
- Raises:
MergingError – When the given items cannot be merged
- Returns:
Instance of a merged or preview item
- mex.backend.merged.helpers.search_merged_items_in_graph(*, query_string: str | None = None, identifier: str | None = None, entity_type: list[str] | None = None, referenced_identifiers: list[str] | None = None, reference_field: str | None = None, skip: int = 0, limit: int = 100, validation: Literal[Validation.LENIENT] = Validation.LENIENT) PaginatedItemsContainer[PreviewAccessPlatform | PreviewActivity | PreviewBibliographicResource | PreviewConsent | PreviewContactPoint | PreviewDistribution | PreviewOrganization | PreviewOrganizationalUnit | PreviewPerson | PreviewPrimarySource | PreviewResource | PreviewVariable | PreviewVariableGroup] ¶
- mex.backend.merged.helpers.search_merged_items_in_graph(*, query_string: str | None = None, identifier: str | None = None, entity_type: list[str] | None = None, referenced_identifiers: list[str] | None = None, reference_field: str | None = None, skip: int = 0, limit: int = 100, validation: Literal[Validation.STRICT] = Validation.STRICT) PaginatedItemsContainer[MergedAccessPlatform | MergedActivity | MergedBibliographicResource | MergedConsent | MergedContactPoint | MergedDistribution | MergedOrganization | MergedOrganizationalUnit | MergedPerson | MergedPrimarySource | MergedResource | MergedVariable | MergedVariableGroup]
- mex.backend.merged.helpers.search_merged_items_in_graph(*, query_string: str | None = None, identifier: str | None = None, entity_type: list[str] | None = None, referenced_identifiers: list[str] | None = None, reference_field: str | None = None, skip: int = 0, limit: int = 100, validation: Literal[Validation.IGNORE] = Validation.IGNORE) PaginatedItemsContainer[MergedAccessPlatform | MergedActivity | MergedBibliographicResource | MergedConsent | MergedContactPoint | MergedDistribution | MergedOrganization | MergedOrganizationalUnit | MergedPerson | MergedPrimarySource | MergedResource | MergedVariable | MergedVariableGroup]
Search for merged items.
- Parameters:
query_string – Full text search query term
identifier – Optional merged item identifier filter
entity_type – Optional entity type filter
referenced_identifiers – Optional merged item identifiers filter
reference_field – Optional field name to filter for
skip – How many items to skip for pagination
limit – How many items to return at most
validation – Merged items validate the existence of required fields and the lengths of lists by default, set this to LENIENT to avoid this and return a “preview” of a merged item instead of a valid merged item, or set this to IGNORE to return None in case of validation errors.
- Raises:
MergingError – When the given items cannot be merged
- Returns:
Search response for preview or merged items
mex.backend.merged.main module¶
- mex.backend.merged.main.get_merged_item(identifier: Identifier) MergedAccessPlatform | MergedActivity | MergedBibliographicResource | MergedConsent | MergedContactPoint | MergedDistribution | MergedOrganization | MergedOrganizationalUnit | MergedPerson | MergedPrimarySource | MergedResource | MergedVariable | MergedVariableGroup ¶
Return one merged item for the given identifier.
- mex.backend.merged.main.search_merged_items(q: Annotated[str, Query(PydanticUndefined)] = '', identifier: Annotated[Identifier | None, Query(PydanticUndefined)] = None, entityType: Annotated[Sequence[MergedType], Query(PydanticUndefined)] = [], hadPrimarySource: Annotated[Sequence[Identifier] | None, Query(PydanticUndefined)] = None, referencedIdentifier: Annotated[Sequence[Identifier] | None, Query(PydanticUndefined)] = None, referenceField: Annotated[ReferenceFieldName | None, Query(PydanticUndefined)] = None, skip: Annotated[int, Query(PydanticUndefined)] = 0, limit: Annotated[int, Query(PydanticUndefined)] = 10) PaginatedItemsContainer[MergedAccessPlatform | MergedActivity | MergedBibliographicResource | MergedConsent | MergedContactPoint | MergedDistribution | MergedOrganization | MergedOrganizationalUnit | MergedPerson | MergedPrimarySource | MergedResource | MergedVariable | MergedVariableGroup] ¶
Search for merged items by query text or by type and identifier.