Manual merge of soc-2009-kazanbas branch:
[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 /* for internal use only, so python can interchange a sequence of strings with flags */
40 typedef struct BPY_flag_def {
41     const char  *name;
42     int                 flag;
43 } BPY_flag_def;
44
45
46 PyObject *BPY_flag_to_list(BPY_flag_def *flagdef, int flag);
47 int BPY_flag_from_seq(BPY_flag_def *flagdef, PyObject *seq, int *flag);
48
49 void PyObSpit(char *name, PyObject *var);
50 void PyLineSpit(void);
51 void BPY_getFileAndNum(char **filename, int *lineno);
52
53 PyObject *BPY_exception_buffer(void);
54
55 /* own python like utility function */
56 PyObject *PyObject_GetAttrStringArgs(PyObject *o, Py_ssize_t n, ...);
57
58
59
60 /* Class type checking, use for checking classes can be added as operators, panels etc */
61 typedef struct BPY_class_attr_check {
62         const char      *name;          /* name of the class attribute */
63     char                type;           /* 's' = string, 'f' = function, 'l' = list, (add as needed) */
64     int                 arg_count;      /* only for function types, -1 for undefined, includes self arg */
65     int                 len;            /* only for string types currently */
66         int                     flag;           /* other options */
67 } BPY_class_attr_check;
68
69 /* BPY_class_attr_check, flag */
70 #define BPY_CLASS_ATTR_OPTIONAL 1
71 #define BPY_CLASS_ATTR_NONE_OK  2
72
73 int BPY_class_validate(const char *class_type, PyObject *class, PyObject *base_class, BPY_class_attr_check* class_attrs, PyObject **py_class_attrs);
74
75 char *BPy_enum_as_string(struct EnumPropertyItem *item);
76
77
78 #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}
79
80 /* error reporting */
81 int BPy_reports_to_error(struct ReportList *reports);
82 int BPy_errors_to_report(struct ReportList *reports);
83
84 /* TODO - find a better solution! */
85 struct bContext *BPy_GetContext(void);
86 void BPy_SetContext(struct bContext *C);
87
88 extern void bpy_context_set(struct bContext *C, PyGILState_STATE *gilstate);
89 extern void bpy_context_clear(struct bContext *C, PyGILState_STATE *gilstate);
90
91
92 #endif