Merge from trunk -r 25003:25745.
[blender.git] / source / blender / python / intern / bpy_util.h
1 /**
2  * $Id$
3  *
4  * ***** BEGIN GPL LICENSE BLOCK *****
5  *
6  * This program is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU General Public License
8  * as published by the Free Software Foundation; either version 2
9  * of the License, or (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software Foundation,
18  * Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
19  *
20  * Contributor(s): Campbell Barton
21  *
22  * ***** END GPL LICENSE BLOCK *****
23  */
24
25 #include <Python.h>
26
27 #ifndef BPY_UTIL_H
28 #define BPY_UTIL_H
29
30 #if PY_VERSION_HEX <  0x03010000
31 #error "Python versions below 3.1 are not supported anymore, you'll need to update your python."
32 #endif
33
34 #include "RNA_types.h" /* for EnumPropertyItem only */
35
36 struct EnumPropertyItem;
37 struct ReportList;
38
39 void PyObSpit(char *name, PyObject *var);
40 void PyLineSpit(void);
41 void BPY_getFileAndNum(char **filename, int *lineno);
42
43 PyObject *BPY_exception_buffer(void);
44
45 /* own python like utility function */
46 PyObject *PyObject_GetAttrStringArgs(PyObject *o, Py_ssize_t n, ...);
47
48
49
50 /* Class type checking, use for checking classes can be added as operators, panels etc */
51 typedef struct BPY_class_attr_check {
52         const char      *name;          /* name of the class attribute */
53     char                type;           /* 's' = string, 'f' = function, 'l' = list, (add as needed) */
54     int                 arg_count;      /* only for function types, -1 for undefined, includes self arg */
55     int                 len;            /* only for string types currently */
56         int                     flag;           /* other options */
57 } BPY_class_attr_check;
58
59 /* BPY_class_attr_check, flag */
60 #define BPY_CLASS_ATTR_OPTIONAL 1
61 #define BPY_CLASS_ATTR_NONE_OK  2
62
63 int BPY_class_validate(const char *class_type, PyObject *class, PyObject *base_class, BPY_class_attr_check* class_attrs, PyObject **py_class_attrs);
64
65 char *BPy_enum_as_string(struct EnumPropertyItem *item);
66
67
68 #define BLANK_PYTHON_TYPE {PyVarObject_HEAD_INIT(NULL, 0) 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0}
69
70 /* error reporting */
71 int BPy_reports_to_error(struct ReportList *reports);
72 int BPy_errors_to_report(struct ReportList *reports);
73
74 /* TODO - find a better solution! */
75 struct bContext *BPy_GetContext(void);
76 void BPy_SetContext(struct bContext *C);
77
78 extern void bpy_context_set(struct bContext *C, PyGILState_STATE *gilstate);
79 extern void bpy_context_clear(struct bContext *C, PyGILState_STATE *gilstate);
80
81
82 #endif