#include <Python.h>
#include <frameobject.h>
#include "../generic/python_compat.hh"
#include "CLG_log.h"
#include "BLI_path_utils.hh"
#include "BLI_string.h"
#include "BLI_threads.h"
#include "BLI_utildefines.h"
#include "BLT_translation.hh"
#include "RNA_types.hh"
#include "bpy.hh"
#include "bpy_capi_utils.hh"
#include "bpy_intern_string.hh"
#include "bpy_path.hh"
#include "bpy_props.hh"
#include "bpy_rna.hh"
#include "bpy_app_translations.hh"
#include "DNA_text_types.h"
#include "BKE_appdir.hh"
#include "BKE_context.hh"
#include "BKE_global.hh"
#include "BKE_main.hh"
#include "BKE_text.h"
#include "BPY_extern.hh"
#include "BPY_extern_python.hh"
#include "BPY_extern_run.hh"
#include "../generic/py_capi_utils.hh"
#include "../bmesh/bmesh_py_api.hh"
#include "../generic/bgl.hh"
#include "../generic/bl_math_py_api.hh"
#include "../generic/blf_py_api.hh"
#include "../generic/idprop_py_api.hh"
#include "../generic/imbuf_py_api.hh"
#include "../gpu/gpu_py_api.hh"
#include "../mathutils/mathutils.hh"

Functions
	CLG_LOGREF_DECLARE_GLOBAL (BPY_LOG_CONTEXT, "bpy.context")
	CLG_LOGREF_DECLARE_GLOBAL (BPY_LOG_INTERFACE, "bpy.interface")
	CLG_LOGREF_DECLARE_GLOBAL (BPY_LOG_RNA, "bpy.rna")
void	BPY_context_update (bContext *C)
void	bpy_context_set (bContext C, PyGILState_STATE gilstate)
void	bpy_context_clear (bContext , const PyGILState_STATE gilstate)
static void	bpy_context_end (bContext *C)
void	BPY_context_dict_clear_members_array (void *dict_p, void dict_orig, const char *context_members[], uint context_members_len)
void	BPY_text_free_code (Text *text)
void	BPY_modules_update ()
bContext *	BPY_context_get ()
void	BPY_context_set (bContext *C)
static void	pystatus_exit_on_error (const PyStatus &status)
void	BPY_python_start (bContext C, int argc, const char *argv)
void	BPY_python_end (const bool do_python_exit)
void	BPY_python_reset (bContext *C)
void	BPY_python_use_system_env ()
bool	BPY_python_use_system_env_get ()
void	BPY_python_backtrace (FILE *fp)
void	BPY_DECREF (void *pyob_ptr)
void	BPY_DECREF_RNA_INVALIDATE (void *pyob_ptr)
void	BPY_modules_load_user (bContext *C)
int	BPY_context_member_get (bContext C, const char member, bContextDataResult *result)
bool	BPY_string_is_keyword (const char *str)
Character Classification
Define text.cc functions here (declared in BKE_text.h), This could be removed if Blender gets its own unicode library.
int	text_check_identifier_unicode (const uint ch)
int	text_check_identifier_nodigit_unicode (const uint ch)

Variables
static int	py_call_level = 0
static bool	py_use_system_env = false
static _inittab	bpy_internal_modules []

Detailed Description

This file deals with embedding the python interpreter within blender, starting and stopping python and exposing blender/python modules so they can be accesses from scripts.

Definition in file bpy_interface.cc.

Function Documentation

◆ bpy_context_clear()

void bpy_context_clear	(	struct bContext *	C,
		const PyGILState_STATE *	gilstate )

Context should be used but not now because it causes some bugs.

Definition at line 136 of file bpy_interface.cc.

References BLI_time_now_seconds(), bpy_context_clear(), BPY_context_set(), and py_call_level.

Referenced by bpy_class_call(), bpy_cli_command_exec(), bpy_context_clear(), BPY_modules_load_user(), bpy_msgbus_notify(), bpy_prop_enum_itemf_fn(), bpy_prop_string_visit_for_search_fn(), bpy_prop_update_fn(), BPy_reports_write_stdout(), BPY_run_string_as_intptr(), BPY_run_string_as_number(), BPY_run_string_as_string_and_len(), BPY_run_string_as_string_and_len_or_none(), bpy_run_string_impl(), cb_region_draw(), cb_wm_cursor_draw(), and python_script_exec().

◆ BPY_context_dict_clear_members_array()

void BPY_context_dict_clear_members_array	(	void **	dict_p,
		void *	dict_orig,
		const char *	context_members[],
		uint	context_members_len )

Use for CTX_*_set(..) functions need to set values which are later read back as expected. In this case we don't want the Python context to override the values as it causes problems see #66256.

Parameters

dict_p	A pointer to #bContext.data.py_context so we can assign a new value.
dict_orig	The value of #bContext.data.py_context_orig to check if we need to copy.

Definition at line 169 of file bpy_interface.cc.

References BLI_assert, BPY_context_dict_clear_members_array(), i, and PyC_IsInterpreterActive().

Referenced by BPY_context_dict_clear_members_array(), CTX_data_scene_set(), CTX_wm_area_set(), CTX_wm_region_set(), CTX_wm_screen_set(), and CTX_wm_window_set().

◆ bpy_context_end()

void bpy_context_end ( bContext * C )

static

Definition at line 161 of file bpy_interface.cc.

References bpy_context_end(), C, CTX_wm_operator_poll_msg_clear(), and UNLIKELY.

Referenced by bpy_context_end(), and BPY_python_end().

◆ BPY_context_get()

bContext * BPY_context_get ( )

Definition at line 235 of file bpy_interface.cc.

References BPY_context_get(), bpy_context_module, and BPy_StructRNA::ptr.

Referenced by bpy_atexit(), bpy_class_call(), BPY_context_get(), bpy_gizmo_target_set_value(), bpy_lib_load(), bpy_msgbus_clear_by_owner(), bpy_msgbus_publish_rna(), bpy_msgbus_subscribe_rna(), BPY_python_end(), BPy_reports_write_stdout(), BPY_rna_operator_poll_message_set(), foreach_getset(), mathutils_rna_matrix_set(), mathutils_rna_vector_set(), mathutils_rna_vector_set_index(), pyop_as_string(), pyop_call(), pyop_poll(), pyrna_enum_as_string(), pyrna_enum_to_py(), pyrna_func_call(), pyrna_prop_array_ass_subscript(), pyrna_prop_to_enum_bitfield(), pyrna_prop_update(), pyrna_py_to_prop(), pyrna_py_to_prop_array_index(), pyrna_register_class(), pyrna_string_to_enum(), pyrna_struct_driver_add(), pyrna_struct_driver_remove(), pyrna_struct_keyframe_insert(), pyrna_struct_keyframe_parse(), and pyrna_unregister_class().

◆ BPY_context_member_get()

int BPY_context_member_get	(	bContext *	C,
		const char *	member,
		bContextDataResult *	result )

Definition at line 732 of file bpy_interface.cc.

References BPY_context_member_get(), BPY_LOG_CONTEXT, BPy_StructRNA_Check, C, CLOG_INFO, CTX_data_list_add_ptr(), CTX_data_pointer_set_ptr(), CTX_DATA_TYPE_COLLECTION, CTX_DATA_TYPE_POINTER, CTX_data_type_set(), CTX_py_dict_get(), i, len(), PyC_IsInterpreterActive(), and result.

Referenced by BPY_context_member_get(), ctx_data_get(), and ctx_wm_python_context_get().

◆ BPY_context_set()

void BPY_context_set ( bContext * C )

Definition at line 240 of file bpy_interface.cc.

References bpy_context_module, BPY_context_set(), C, and BPy_StructRNA::ptr.

Referenced by bpy_context_clear(), BPY_context_set(), and BPY_context_update().

◆ bpy_context_set()

void bpy_context_set	(	bContext *	C,
		PyGILState_STATE *	gilstate )

◆ BPY_context_update()

void BPY_context_update ( bContext * C )

Use for updating while a python script runs - in case of file load.

Definition at line 97 of file bpy_interface.cc.

References BLI_thread_is_main(), BPY_context_set(), BPY_context_update(), BPY_modules_update(), and C.

Referenced by bpy_context_set(), BPY_context_update(), BPY_modules_load_user(), and setup_app_data().

◆ BPY_DECREF()

void BPY_DECREF ( void * pyob_ptr )

Acquire the global-interpreter-lock (GIL) and wrap Py_DECREF. as there are some cases when this needs to be called outside the Python API code.

Definition at line 669 of file bpy_interface.cc.

References BPY_DECREF().

Referenced by BPY_DECREF(), fcurve_free_driver(), pyop_poll_message_free_fn(), and RNA_struct_free_extension().

◆ BPY_DECREF_RNA_INVALIDATE()

void BPY_DECREF_RNA_INVALIDATE ( void * pyob_ptr )

Definition at line 676 of file bpy_interface.cc.

References BPY_DECREF_RNA_INVALIDATE(), and pyrna_invalidate().

Referenced by BKE_libblock_free_data_py(), BPY_DECREF_RNA_INVALIDATE(), RE_engine_free(), WM_gizmo_free(), wm_gizmogroup_free(), and WM_operator_free().

◆ BPY_modules_load_user()

void BPY_modules_load_user ( bContext * C )

Definition at line 687 of file bpy_interface.cc.

References BKE_main_blendfile_path(), bpy_context_clear(), bpy_context_set(), BPY_context_update(), BPY_modules_load_user(), BPY_run_text(), C, CTX_data_main(), ListBase::first, Text::flags, G, G_FLAG_SCRIPT_AUTOEXEC, G_FLAG_SCRIPT_AUTOEXEC_FAIL, G_FLAG_SCRIPT_AUTOEXEC_FAIL_QUIET, Text::id, ID::name, ID::next, printf, py_call_level, RPT_, SNPRINTF, Main::texts, and TXT_ISSCRIPT.

Referenced by BPY_modules_load_user(), and BPY_python_reset().

◆ BPY_modules_update()

void BPY_modules_update ( )

Needed so the Main pointer in bpy.data doesn't become out of date.

Definition at line 221 of file bpy_interface.cc.

References BPY_modules_update(), BPY_rna_module(), BPY_rna_types(), BPY_update_rna_module(), and mod.

Referenced by BPY_context_update(), BPY_modules_update(), and pyop_call().

◆ BPY_python_backtrace()

void BPY_python_backtrace ( FILE * fp )

Definition at line 648 of file bpy_interface.cc.

References BPY_python_backtrace(), and PyThreadState_GetUnchecked.

Referenced by BPY_python_backtrace(), and crashlog_file_generate().

◆ BPY_python_end()

void BPY_python_end ( const bool do_python_exit )

Definition at line 562 of file bpy_interface.cc.

References BLI_assert_msg, BLI_time_now_seconds(), BPY_app_translations_end(), BPY_atexit_unregister(), bpy_context_end(), BPY_context_get(), BPY_driver_exit(), bpy_intern_string_exit(), BPY_python_end(), BPY_rna_exit(), BPY_rna_props_clear_all(), printf, and RNA_bpy_exit().

Referenced by BPY_python_end(), and WM_exit_ex().

◆ BPY_python_reset()

void BPY_python_reset ( bContext * C )

Definition at line 624 of file bpy_interface.cc.

References BLI_assert_msg, BPY_app_handlers_reset(), BPY_driver_reset(), BPY_modules_load_user(), BPY_python_reset(), C, G, G_FLAG_SCRIPT_AUTOEXEC_FAIL, and G_FLAG_SCRIPT_AUTOEXEC_FAIL_QUIET.

Referenced by BPY_python_reset(), wm_file_read_post(), and WM_init().

◆ BPY_python_start()

void BPY_python_start	(	bContext *	C,
		int	argc,
		const char **	argv )

Call BPY_context_set first.

Definition at line 323 of file bpy_interface.cc.

References BKE_appdir_folder_id(), BKE_appdir_program_path(), BKE_appdir_program_python_search(), BLENDER_SYSTEM_PYTHON, BLI_assert, BLI_assert_msg, BLI_getenv(), BLI_path_join, BLI_setenv(), BPY_atexit_register(), BPy_init_modules(), bpy_intern_string_init(), bpy_internal_modules, BPY_LOG_INTERFACE, BPY_python_start(), BPY_rna_init(), BPY_run_string_eval(), C, CLOG_INFO, FILE_MAX, mod, py_use_system_env, pyrna_alloc_types(), and pystatus_exit_on_error().

Referenced by BPY_python_start(), and WM_init().

◆ BPY_python_use_system_env()

void BPY_python_use_system_env ( )

Definition at line 637 of file bpy_interface.cc.

References BLI_assert, BPY_python_use_system_env(), and py_use_system_env.

Referenced by arg_handle_python_use_system_env_set(), and BPY_python_use_system_env().

◆ BPY_python_use_system_env_get()

bool BPY_python_use_system_env_get ( )

Definition at line 643 of file bpy_interface.cc.

References BPY_python_use_system_env_get(), and py_use_system_env.

Referenced by bpy_app_python_args_get(), and BPY_python_use_system_env_get().

◆ BPY_string_is_keyword()

bool BPY_string_is_keyword ( const char * str )

Avoids duplicating keyword list.

Definition at line 962 of file bpy_interface.cc.

References BPY_string_is_keyword(), i, str, and STREQ.

Referenced by BPY_string_is_keyword(), and driver_variable_name_validate().

◆ BPY_text_free_code()

void BPY_text_free_code ( Text * text )

Definition at line 202 of file bpy_interface.cc.

References BPY_text_free_code(), Text::compiled, and PyC_IsInterpreterActive().

Referenced by BPY_text_free_code(), text_free_data(), text_reload_exec(), and txt_make_dirty().

◆ CLG_LOGREF_DECLARE_GLOBAL() [1/3]

CLG_LOGREF_DECLARE_GLOBAL	(	BPY_LOG_CONTEXT	,
		"bpy.context"	)

References BPY_LOG_CONTEXT, and CLG_LOGREF_DECLARE_GLOBAL.

◆ CLG_LOGREF_DECLARE_GLOBAL() [2/3]

CLG_LOGREF_DECLARE_GLOBAL	(	BPY_LOG_INTERFACE	,
		"bpy.interface"	)

References BPY_LOG_INTERFACE, and CLG_LOGREF_DECLARE_GLOBAL.

◆ CLG_LOGREF_DECLARE_GLOBAL() [3/3]

CLG_LOGREF_DECLARE_GLOBAL	(	BPY_LOG_RNA	,
		"bpy.rna"	)

References BPY_LOG_RNA, and CLG_LOGREF_DECLARE_GLOBAL.

◆ pystatus_exit_on_error()

void pystatus_exit_on_error ( const PyStatus & status )

static

Convenience function for BPY_python_start.

These should happen so rarely that having comprehensive errors isn't needed. For example if sys.argv fails to allocate memory.

Show an error just to avoid silent failure in the unlikely event something goes wrong, in this case a developer will need to track down the root cause.

Definition at line 313 of file bpy_interface.cc.

References pystatus_exit_on_error(), and UNLIKELY.

Referenced by BPY_python_start(), and pystatus_exit_on_error().

◆ text_check_identifier_nodigit_unicode()

int text_check_identifier_nodigit_unicode ( const uint ch )

Definition at line 993 of file bpy_interface.cc.

References text_check_identifier_nodigit(), and text_check_identifier_nodigit_unicode().

Referenced by text_autocomplete_build(), text_check_identifier_nodigit_unicode(), text_check_identifier_nodigit_unicode(), and txt_calc_tab_right().

◆ text_check_identifier_unicode()

int text_check_identifier_unicode ( const uint ch )

Definition at line 988 of file bpy_interface.cc.

References text_check_identifier(), and text_check_identifier_unicode().

Referenced by text_autocomplete_build(), text_check_identifier_unicode(), text_check_identifier_unicode(), and txt_calc_tab_right().

Variable Documentation

◆ bpy_internal_modules

_inittab bpy_internal_modules[]

static

Definition at line 268 of file bpy_interface.cc.

Referenced by BPY_python_start().

◆ py_call_level

int py_call_level = 0

static

Definition at line 79 of file bpy_interface.cc.

Referenced by bpy_context_clear(), bpy_context_set(), and BPY_modules_load_user().

◆ py_use_system_env

bool py_use_system_env = false

static

Definition at line 82 of file bpy_interface.cc.

Referenced by BPY_python_start(), BPY_python_use_system_env(), and BPY_python_use_system_env_get().

Functions

Variables

Detailed Description

Function Documentation

◆ bpy_context_clear()

◆ BPY_context_dict_clear_members_array()

◆ bpy_context_end()

◆ BPY_context_get()

◆ BPY_context_member_get()

◆ BPY_context_set()

◆ bpy_context_set()

◆ BPY_context_update()

◆ BPY_DECREF()

◆ BPY_DECREF_RNA_INVALIDATE()

◆ BPY_modules_load_user()

◆ BPY_modules_update()

◆ BPY_python_backtrace()

◆ BPY_python_end()

◆ BPY_python_reset()

◆ BPY_python_start()

◆ BPY_python_use_system_env()

◆ BPY_python_use_system_env_get()

◆ BPY_string_is_keyword()

◆ BPY_text_free_code()

◆ CLG_LOGREF_DECLARE_GLOBAL() [1/3]

◆ CLG_LOGREF_DECLARE_GLOBAL() [2/3]

◆ CLG_LOGREF_DECLARE_GLOBAL() [3/3]

◆ pystatus_exit_on_error()

◆ text_check_identifier_nodigit_unicode()

◆ text_check_identifier_unicode()

Variable Documentation

◆ bpy_internal_modules

◆ py_call_level

◆ py_use_system_env