BlendImportContextItem(bpy_struct)

base class — bpy_struct

class bpy.types.BlendImportContextItem(bpy_struct)

An item (representing a data-block) in a BlendImportContext data. Currently only exposed as read-only data for the pre/post linking handlers

append_action

How this item has been handled by the append operation. Only set if the data has been appended (default 'UNSET', readonly)

  • UNSET Not yet defined.

  • KEEP_LINKED ID has been kept linked.

  • REUSE_LOCAL An existing matching local ID has been re-used.

  • MAKE_LOCAL The newly linked ID has been made local.

  • COPY_LOCAL The linked ID had other unrelated usages, so it has been duplicated into a local copy.

Type:

Literal[‘UNSET’, ‘KEEP_LINKED’, ‘REUSE_LOCAL’, ‘MAKE_LOCAL’, ‘COPY_LOCAL’]

id

The imported ID. None until it has been linked or appended. May be the same as reusable_local_id when appended (readonly)

Type:

ID

id_type

ID type of the item (default 'ACTION', readonly)

Type:

Literal[Id Type Items]

import_info

Various status info about an item after it has been imported (default set(), readonly)

  • INDIRECT_USAGE That item was added for an indirectly imported ID, as a dependency of another data-block.

  • LIBOVERRIDE_DEPENDENCY That item represents an ID also used as liboverride dependency (either directly, as a liboverride reference, or indirectly, as data used by a liboverride reference). It should never be directly made local. Mutually exclusive with `LIBOVERRIDE_DEPENDENCY_ONLY`.

  • LIBOVERRIDE_DEPENDENCY_ONLY That item represents an ID only used as liboverride dependency (either directly or indirectly, see `LIBOVERRIDE_DEPENDENCY` for precisions). It should not be considered during the ‘make local’ (append) process, and remain purely linked data. Mutually exclusive with `LIBOVERRIDE_DEPENDENCY`.

Type:

set[Literal[‘INDIRECT_USAGE’, ‘LIBOVERRIDE_DEPENDENCY’, ‘LIBOVERRIDE_DEPENDENCY_ONLY’]]

library_override_id

The library override of the linked ID. None until it has been created (readonly)

Type:

ID

name

ID name of the item (default “”, readonly, never None)

Type:

str

reusable_local_id

The already existing local ID that may be reused in append & reuse case. None until it has been found (readonly)

Type:

ID

source_libraries

List of libraries to search and import that ID from. The ID will be imported from the first file in that list that contains it (default None, readonly)

Type:

BlendImportContextLibraries[BlendImportContextLibrary]

source_library

Library ID representing the blendfile from which the ID was imported. None until the ID has been linked or appended (readonly)

Type:

Library

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (bpy.types.Struct | None) – The value to return when not found.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct

classmethod bl_rna_get_subclass_py(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (type | None) – The value to return when not found.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions

References