pipeline

def get_instances():
    """Return all instances stored in the project instances as a list"""
    current_package = get_package_from_current_graph()
    if not current_package:
        return []

    get_instances_by_id = parsing_sd_data(
        current_package, AYON_METADATA_INSTANCES_KEY) or {}
    return list(get_instances_by_id.values())

def imprint(current_package, name, namespace, context,
            loader, identifier, options=None):
    """Imprint a loaded container with metadata.

    Containerisation enables a tracking of version, author and origin
    for loaded assets.

    Arguments:
        name (str): Name of resulting assembly
        namespace (str): Namespace under which to host container
        context (dict): Asset information
        loader (load.LoaderPlugin): loader instance used to produce container.
        identifier (str): SDResource identifier
        options (dict): options

    Returns:
        None

    """
    data = {
        "schema": "ayon:container-2.0",
        "id": AVALON_CONTAINER_ID,
        "name": str(name),
        "namespace": str(namespace) if namespace else None,
        "loader": str(loader.__class__.__name__),
        "representation": context["representation"]["id"],
        "project_name": context["project"]["name"],
        "objectName": identifier
    }
    if options:
        for key, value in options.items():
            data[key] = value
    container_data = parsing_sd_data(
        current_package, AYON_METADATA_CONTAINERS_KEY, is_dictionary=False)
    container_data.append(data)
    set_sd_metadata(AYON_METADATA_CONTAINERS_KEY, container_data)

def remove_container_metadata(container):
    """Helper method to remove the data for a specific container"""
    current_package = get_package_from_current_graph()
    all_container_metadata = parsing_sd_data(
        current_package, AYON_METADATA_CONTAINERS_KEY, is_dictionary=False)
    metadata_remainder = [
        container_data for container_data in all_container_metadata
        if container_data["objectName"] != container["objectName"]
    ]
    set_sd_metadata(AYON_METADATA_CONTAINERS_KEY, metadata_remainder)

def remove_instance(instance_id):
    """Helper method to remove the data for a specific container"""
    current_package = get_package_from_current_graph()
    if current_package:
        instances = parsing_sd_data(
            current_package, AYON_METADATA_INSTANCES_KEY) or {}
        instances.pop(instance_id, None)
        set_sd_metadata(AYON_METADATA_INSTANCES_KEY, instances)

def set_instance(instance_id, instance_data, update=False):
    """Helper method to directly set the data for a specific container

    Args:
        instance_id (str): Unique identifier for the instance
        instance_data (dict): The instance data to store in the metaadata.
    """
    set_instances({instance_id: instance_data}, update=update)

def set_instances(instance_data_by_id, update=False):
    """Store data for multiple instances at the same time.

    Args:
        instance_data_by_id (dict): instance data queried by id
        update (bool, optional): whether the data needs update.
            Defaults to False.
    """
    current_package = get_package_from_current_graph()
    if current_package:
        instances = parsing_sd_data(
            current_package, AYON_METADATA_INSTANCES_KEY) or {}
        for instance_id, instance_data in instance_data_by_id.items():
            if update:
                existing_data = instances.get(instance_id, {})
                existing_data.update(instance_data)
            else:
                instances[instance_id] = instance_data

        set_sd_metadata(AYON_METADATA_INSTANCES_KEY, instances)