Library(ID)

base classes — bpy_struct, ID

class bpy.types.Library(ID)

External .blend file from which data is linked

archive_libraries

Archive libraries of packed IDs, generated (and owned) by this source library (default None, readonly)

Type:

bpy_prop_collection[Library]

archive_parent_library

Source library from which this archive of packed IDs was generated (readonly)

Type:

Library

filepath

Path to the library .blend file (default “”, never None, blend relative // prefix supported)

Type:

str

is_archive

This library is an ‘archive’ storage for packed linked IDs originally linked from its ‘archive parent’ library. (default False, readonly)

Type:

bool

is_editable

Data-blocks in this library are editable despite being linked. Used by brush assets and their dependencies. (default False, readonly)

Type:

bool

needs_liboverride_resync

True if this library contains library overrides that are linked in current blendfile, and that had to be recursively resynced on load (it is recommended to open and re-save that library blendfile then) (default False)

Type:

bool

packed_file

(readonly)

Type:

PackedFile

parent

(readonly)

Type:

Library

version

Version of Blender the library .blend was saved with (array of 3 items, in [0, inf], default (0, 0, 0), readonly)

Type:

bpy_prop_array[int]

users_id

ID data-blocks that use this library

Type:

tuple[bpy.types.ID, …]

Note

Takes O(n) time, where n is the total number of all linkable ID types in bpy.data.

(readonly)

reload()

Reload this library and all its linked data-blocks

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