blender/tests/blender_as_python_module/import_bpy.py

# SPDX-FileCopyrightText: 2002-2022 Blender Authors
#
# SPDX-License-Identifier: GPL-2.0-or-later

# Add directory with module to the path.
import sys
sys.path.append(sys.argv[1])

# Just import `bpy` and see if there are any dynamic loader errors.
import bpy

# Try bundled libraries.
bpy.utils.expose_bundled_modules()

from pxr import Usd
import MaterialX
import OpenImageIO
import PyOpenColorIO

# Test both old and new names, remove when all 4.4 libs have landed.
try:
    import pyopenvdb
except ModuleNotFoundError:
    import openvdb
    import oslquery
License Headers: Set copyright to "Blender Authors", add AUTHORS Listing the "Blender Foundation" as copyright holder implied the Blender Foundation holds copyright to files which may include work from many developers. While keeping copyright on headers makes sense for isolated libraries, Blender's own code may be refactored or moved between files in a way that makes the per file copyright holders less meaningful. Copyright references to the "Blender Foundation" have been replaced with "Blender Authors", with the exception of `./extern/` since these this contains libraries which are more isolated, any changed to license headers there can be handled on a case-by-case basis. Some directories in `./intern/` have also been excluded: - `./intern/cycles/` it's own `AUTHORS` file is planned. - `./intern/opensubdiv/`. An "AUTHORS" file has been added, using the chromium projects authors file as a template. Design task: #110784 Ref !110783. 2023-08-16 00:20:26 +10:00			`# SPDX-FileCopyrightText: 2002-2022 Blender Authors`
License headers: use SPDX-FileCopyrightText in all sources 2023-06-15 13:09:04 +10:00			`#`
File headers: SPDX License migration Use a shorter/simpler license convention, stops the header taking so much space. Follow the SPDX license specification: https://spdx.org/licenses - C/C++/objc/objc++ - Python - Shell Scripts - CMake, GNUmakefile While most of the source tree has been included - `./extern/` was left out. - `./intern/cycles` & `./intern/atomic` are also excluded because they use different header conventions. doc/license/SPDX-license-identifiers.txt has been added to list SPDX all used identifiers. See P2788 for the script that automated these edits. Reviewed By: brecht, mont29, sergey Ref D14069 2022-02-11 09:07:11 +11:00			`# SPDX-License-Identifier: GPL-2.0-or-later`
Tests/bpy: Add installation verification test Makes it slightly easier to test whether the installed module works or not. Depends on D10656 Ref T86579 Reviewed By: mont29, campbellbarton Differential Revision: https://developer.blender.org/D10665 2021-03-29 22:26:54 +05:30
Python: fix failing tests when building bpy module * Use Python executable from lib folder since it's not installed. * Make bpy module test work for portable install. * Disable gtests which don't work with different Python link flags and shared library locations. Ref D15957 2022-09-15 18:10:44 +02:00			`# Add directory with module to the path.`
			`import sys`
			`sys.path.append(sys.argv[1])`

Cleanup: correct RST syntax, spelling & adjust quotes 2025-01-21 16:51:40 +11:00			# Just import `bpy` and see if there are any dynamic loader errors.
Tests/bpy: Add installation verification test Makes it slightly easier to test whether the installed module works or not. Depends on D10656 Ref T86579 Reviewed By: mont29, campbellbarton Differential Revision: https://developer.blender.org/D10665 2021-03-29 22:26:54 +05:30			`import bpy`
Python Module: Bundle VFX library python bindings When calling bpy.utils.expose_bundled_modules(), these modules are added to sys.path. This provides a solution/workaround to two problems: * Using bpy together with packages like usd-core is problematic. Besides crashing due to C++ symbol conflicts, it's just impossible to import different versions of the same module, or to have distinct environment variables for both. (#127132) * Blender add-ons using these VFX modules do not currently work with the bpy module. This adds about 15MB to the bpy package. Pull Request: https://projects.blender.org/blender/blender/pulls/133082 2025-01-17 10:13:31 +01:00
Cleanup: correct RST syntax, spelling & adjust quotes 2025-01-21 16:51:40 +11:00			`# Try bundled libraries.`
Python Module: Bundle VFX library python bindings When calling bpy.utils.expose_bundled_modules(), these modules are added to sys.path. This provides a solution/workaround to two problems: * Using bpy together with packages like usd-core is problematic. Besides crashing due to C++ symbol conflicts, it's just impossible to import different versions of the same module, or to have distinct environment variables for both. (#127132) * Blender add-ons using these VFX modules do not currently work with the bpy module. This adds about 15MB to the bpy package. Pull Request: https://projects.blender.org/blender/blender/pulls/133082 2025-01-17 10:13:31 +01:00			`bpy.utils.expose_bundled_modules()`

			`from pxr import Usd`
			`import MaterialX`
			`import OpenImageIO`
			`import PyOpenColorIO`
For VFX platform 2025 and more. Boost (removed!) Cython 3.0.11 Expat 2.6.4 GMP 6.3.0 MaterialX 1.39.2 Nanobind 2.1.0 (new, for OpenVDB) NumPy 1.26.4 OpenColorIO 2.4.1 OpenEXR 3.3.2 OpenImageIO 3.0.3.1 OpenVDB 12.0.0 OSL 1.14.3-beta Python 3.11.11 Robinmap 1.3.0 TBB 2021.13.0 TIFF 4.7.0 USD 25.02 libxml2 2.13.5 zlib 1.3.1 Co-authored-by: Brecht Van Lommel <brecht@blender.org> Co-authored-by: Jonas Holzman <jonas@holzman.fr> Co-authored-by: Sebastian Parborg <sebastian@blender.org> Ref #128577 Pull Request: https://projects.blender.org/blender/blender/pulls/134178 2025-02-06 14:53:16 +01:00
			`# Test both old and new names, remove when all 4.4 libs have landed.`
			`try:`
			`import pyopenvdb`
			`except ModuleNotFoundError:`
			`import openvdb`
			`import oslquery`