Merge branch 'master' into blender2.8
[blender.git] / release / scripts / startup / bl_operators / wm.py
1 # ##### BEGIN GPL LICENSE BLOCK #####
2 #
3 #  This program is free software; you can redistribute it and/or
4 #  modify it under the terms of the GNU General Public License
5 #  as published by the Free Software Foundation; either version 2
6 #  of the License, or (at your option) any later version.
7 #
8 #  This program is distributed in the hope that it will be useful,
9 #  but WITHOUT ANY WARRANTY; without even the implied warranty of
10 #  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11 #  GNU General Public License for more details.
12 #
13 #  You should have received a copy of the GNU General Public License
14 #  along with this program; if not, write to the Free Software Foundation,
15 #  Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
16 #
17 # ##### END GPL LICENSE BLOCK #####
18
19 # <pep8 compliant>
20
21 import bpy
22 from bpy.types import Operator
23 from bpy.props import (
24     BoolProperty,
25     EnumProperty,
26     FloatProperty,
27     IntProperty,
28     StringProperty,
29 )
30
31 from bpy.app.translations import pgettext_tip as tip_
32
33
34 rna_path_prop = StringProperty(
35         name="Context Attributes",
36         description="RNA context string",
37         maxlen=1024,
38         )
39
40 rna_reverse_prop = BoolProperty(
41         name="Reverse",
42         description="Cycle backwards",
43         default=False,
44         )
45
46 rna_wrap_prop = BoolProperty(
47         name="Wrap",
48         description="Wrap back to the first/last values",
49         default=False,
50         )
51
52 rna_relative_prop = BoolProperty(
53         name="Relative",
54         description="Apply relative to the current value (delta)",
55         default=False,
56         )
57
58
59 def context_path_validate(context, data_path):
60     try:
61         value = eval("context.%s" % data_path) if data_path else Ellipsis
62     except AttributeError as e:
63         if str(e).startswith("'NoneType'"):
64             # One of the items in the rna path is None, just ignore this
65             value = Ellipsis
66         else:
67             # We have a real error in the rna path, don't ignore that
68             raise
69
70     return value
71
72
73 def operator_value_is_undo(value):
74     if value in {None, Ellipsis}:
75         return False
76
77     # typical properties or objects
78     id_data = getattr(value, "id_data", Ellipsis)
79
80     if id_data is None:
81         return False
82     elif id_data is Ellipsis:
83         # handle mathutils types
84         id_data = getattr(getattr(value, "owner", None), "id_data", None)
85
86         if id_data is None:
87             return False
88
89     # return True if its a non window ID type
90     return (isinstance(id_data, bpy.types.ID) and
91             (not isinstance(id_data, (bpy.types.WindowManager,
92                                       bpy.types.Screen,
93                                       bpy.types.Brush,
94                                       ))))
95
96
97 def operator_path_is_undo(context, data_path):
98     # note that if we have data paths that use strings this could fail
99     # luckily we don't do this!
100     #
101     # When we cant find the data owner assume no undo is needed.
102     data_path_head = data_path.rpartition(".")[0]
103
104     if not data_path_head:
105         return False
106
107     value = context_path_validate(context, data_path_head)
108
109     return operator_value_is_undo(value)
110
111
112 def operator_path_undo_return(context, data_path):
113     return {'FINISHED'} if operator_path_is_undo(context, data_path) else {'CANCELLED'}
114
115
116 def operator_value_undo_return(value):
117     return {'FINISHED'} if operator_value_is_undo(value) else {'CANCELLED'}
118
119
120 def execute_context_assign(self, context):
121     data_path = self.data_path
122     if context_path_validate(context, data_path) is Ellipsis:
123         return {'PASS_THROUGH'}
124
125     if getattr(self, "relative", False):
126         exec("context.%s += self.value" % data_path)
127     else:
128         exec("context.%s = self.value" % data_path)
129
130     return operator_path_undo_return(context, data_path)
131
132
133 def module_filesystem_remove(path_base, module_name):
134     import os
135     module_name = os.path.splitext(module_name)[0]
136     for f in os.listdir(path_base):
137         f_base = os.path.splitext(f)[0]
138         if f_base == module_name:
139             f_full = os.path.join(path_base, f)
140
141             if os.path.isdir(f_full):
142                 os.rmdir(f_full)
143             else:
144                 os.remove(f_full)
145
146
147 class BRUSH_OT_active_index_set(Operator):
148     """Set active sculpt/paint brush from it's number"""
149     bl_idname = "brush.active_index_set"
150     bl_label = "Set Brush Number"
151
152     mode = StringProperty(
153             name="Mode",
154             description="Paint mode to set brush for",
155             maxlen=1024,
156             )
157     index = IntProperty(
158             name="Number",
159             description="Brush number",
160             )
161
162     _attr_dict = {"sculpt": "use_paint_sculpt",
163                   "vertex_paint": "use_paint_vertex",
164                   "weight_paint": "use_paint_weight",
165                   "image_paint": "use_paint_image",
166                   }
167
168     def execute(self, context):
169         attr = self._attr_dict.get(self.mode)
170         if attr is None:
171             return {'CANCELLED'}
172
173         toolsettings = context.tool_settings
174         for i, brush in enumerate((cur for cur in bpy.data.brushes if getattr(cur, attr))):
175             if i == self.index:
176                 getattr(toolsettings, self.mode).brush = brush
177                 return {'FINISHED'}
178
179         return {'CANCELLED'}
180
181
182 class WM_OT_context_set_boolean(Operator):
183     """Set a context value"""
184     bl_idname = "wm.context_set_boolean"
185     bl_label = "Context Set Boolean"
186     bl_options = {'UNDO', 'INTERNAL'}
187
188     data_path = rna_path_prop
189     value = BoolProperty(
190             name="Value",
191             description="Assignment value",
192             default=True,
193             )
194
195     execute = execute_context_assign
196
197
198 class WM_OT_context_set_int(Operator):  # same as enum
199     """Set a context value"""
200     bl_idname = "wm.context_set_int"
201     bl_label = "Context Set"
202     bl_options = {'UNDO', 'INTERNAL'}
203
204     data_path = rna_path_prop
205     value = IntProperty(
206             name="Value",
207             description="Assign value",
208             default=0,
209             )
210     relative = rna_relative_prop
211
212     execute = execute_context_assign
213
214
215 class WM_OT_context_scale_float(Operator):
216     """Scale a float context value"""
217     bl_idname = "wm.context_scale_float"
218     bl_label = "Context Scale Float"
219     bl_options = {'UNDO', 'INTERNAL'}
220
221     data_path = rna_path_prop
222     value = FloatProperty(
223             name="Value",
224             description="Assign value",
225             default=1.0,
226             )
227
228     def execute(self, context):
229         data_path = self.data_path
230         if context_path_validate(context, data_path) is Ellipsis:
231             return {'PASS_THROUGH'}
232
233         value = self.value
234
235         if value == 1.0:  # nothing to do
236             return {'CANCELLED'}
237
238         exec("context.%s *= value" % data_path)
239
240         return operator_path_undo_return(context, data_path)
241
242
243 class WM_OT_context_scale_int(Operator):
244     """Scale an int context value"""
245     bl_idname = "wm.context_scale_int"
246     bl_label = "Context Scale Int"
247     bl_options = {'UNDO', 'INTERNAL'}
248
249     data_path = rna_path_prop
250     value = FloatProperty(
251             name="Value",
252             description="Assign value",
253             default=1.0,
254             )
255     always_step = BoolProperty(
256             name="Always Step",
257             description="Always adjust the value by a minimum of 1 when 'value' is not 1.0",
258             default=True,
259             )
260
261     def execute(self, context):
262         data_path = self.data_path
263         if context_path_validate(context, data_path) is Ellipsis:
264             return {'PASS_THROUGH'}
265
266         value = self.value
267
268         if value == 1.0:  # nothing to do
269             return {'CANCELLED'}
270
271         if getattr(self, "always_step", False):
272             if value > 1.0:
273                 add = "1"
274                 func = "max"
275             else:
276                 add = "-1"
277                 func = "min"
278             exec("context.%s = %s(round(context.%s * value), context.%s + %s)" %
279                  (data_path, func, data_path, data_path, add))
280         else:
281             exec("context.%s *= value" % data_path)
282
283         return operator_path_undo_return(context, data_path)
284
285
286 class WM_OT_context_set_float(Operator):  # same as enum
287     """Set a context value"""
288     bl_idname = "wm.context_set_float"
289     bl_label = "Context Set Float"
290     bl_options = {'UNDO', 'INTERNAL'}
291
292     data_path = rna_path_prop
293     value = FloatProperty(
294             name="Value",
295             description="Assignment value",
296             default=0.0,
297             )
298     relative = rna_relative_prop
299
300     execute = execute_context_assign
301
302
303 class WM_OT_context_set_string(Operator):  # same as enum
304     """Set a context value"""
305     bl_idname = "wm.context_set_string"
306     bl_label = "Context Set String"
307     bl_options = {'UNDO', 'INTERNAL'}
308
309     data_path = rna_path_prop
310     value = StringProperty(
311             name="Value",
312             description="Assign value",
313             maxlen=1024,
314             )
315
316     execute = execute_context_assign
317
318
319 class WM_OT_context_set_enum(Operator):
320     """Set a context value"""
321     bl_idname = "wm.context_set_enum"
322     bl_label = "Context Set Enum"
323     bl_options = {'UNDO', 'INTERNAL'}
324
325     data_path = rna_path_prop
326     value = StringProperty(
327             name="Value",
328             description="Assignment value (as a string)",
329             maxlen=1024,
330             )
331
332     execute = execute_context_assign
333
334
335 class WM_OT_context_set_value(Operator):
336     """Set a context value"""
337     bl_idname = "wm.context_set_value"
338     bl_label = "Context Set Value"
339     bl_options = {'UNDO', 'INTERNAL'}
340
341     data_path = rna_path_prop
342     value = StringProperty(
343             name="Value",
344             description="Assignment value (as a string)",
345             maxlen=1024,
346             )
347
348     def execute(self, context):
349         data_path = self.data_path
350         if context_path_validate(context, data_path) is Ellipsis:
351             return {'PASS_THROUGH'}
352         exec("context.%s = %s" % (data_path, self.value))
353         return operator_path_undo_return(context, data_path)
354
355
356 class WM_OT_context_toggle(Operator):
357     """Toggle a context value"""
358     bl_idname = "wm.context_toggle"
359     bl_label = "Context Toggle"
360     bl_options = {'UNDO', 'INTERNAL'}
361
362     data_path = rna_path_prop
363
364     def execute(self, context):
365         data_path = self.data_path
366
367         if context_path_validate(context, data_path) is Ellipsis:
368             return {'PASS_THROUGH'}
369
370         exec("context.%s = not (context.%s)" % (data_path, data_path))
371
372         return operator_path_undo_return(context, data_path)
373
374
375 class WM_OT_context_toggle_enum(Operator):
376     """Toggle a context value"""
377     bl_idname = "wm.context_toggle_enum"
378     bl_label = "Context Toggle Values"
379     bl_options = {'UNDO', 'INTERNAL'}
380
381     data_path = rna_path_prop
382     value_1 = StringProperty(
383             name="Value",
384             description="Toggle enum",
385             maxlen=1024,
386             )
387     value_2 = StringProperty(
388             name="Value",
389             description="Toggle enum",
390             maxlen=1024,
391             )
392
393     def execute(self, context):
394         data_path = self.data_path
395
396         if context_path_validate(context, data_path) is Ellipsis:
397             return {'PASS_THROUGH'}
398
399         # failing silently is not ideal, but we don't want errors for shortcut
400         # keys that some values that are only available in a particular context
401         try:
402             exec("context.%s = ('%s', '%s')[context.%s != '%s']" %
403                  (data_path, self.value_1,
404                   self.value_2, data_path,
405                   self.value_2,
406                   ))
407         except:
408             return {'PASS_THROUGH'}
409
410         return operator_path_undo_return(context, data_path)
411
412
413 class WM_OT_context_cycle_int(Operator):
414     """Set a context value (useful for cycling active material, """ \
415     """vertex keys, groups, etc.)"""
416     bl_idname = "wm.context_cycle_int"
417     bl_label = "Context Int Cycle"
418     bl_options = {'UNDO', 'INTERNAL'}
419
420     data_path = rna_path_prop
421     reverse = rna_reverse_prop
422     wrap = rna_wrap_prop
423
424     def execute(self, context):
425         data_path = self.data_path
426         value = context_path_validate(context, data_path)
427         if value is Ellipsis:
428             return {'PASS_THROUGH'}
429
430         if self.reverse:
431             value -= 1
432         else:
433             value += 1
434
435         exec("context.%s = value" % data_path)
436
437         if self.wrap:
438             if value != eval("context.%s" % data_path):
439                 # relies on rna clamping integers out of the range
440                 if self.reverse:
441                     value = (1 << 31) - 1
442                 else:
443                     value = -1 << 31
444
445                 exec("context.%s = value" % data_path)
446
447         return operator_path_undo_return(context, data_path)
448
449
450 class WM_OT_context_cycle_enum(Operator):
451     """Toggle a context value"""
452     bl_idname = "wm.context_cycle_enum"
453     bl_label = "Context Enum Cycle"
454     bl_options = {'UNDO', 'INTERNAL'}
455
456     data_path = rna_path_prop
457     reverse = rna_reverse_prop
458     wrap = rna_wrap_prop
459
460     def execute(self, context):
461         data_path = self.data_path
462         value = context_path_validate(context, data_path)
463         if value is Ellipsis:
464             return {'PASS_THROUGH'}
465
466         orig_value = value
467
468         # Have to get rna enum values
469         rna_struct_str, rna_prop_str = data_path.rsplit('.', 1)
470         i = rna_prop_str.find('[')
471
472         # just in case we get "context.foo.bar[0]"
473         if i != -1:
474             rna_prop_str = rna_prop_str[0:i]
475
476         rna_struct = eval("context.%s.rna_type" % rna_struct_str)
477
478         rna_prop = rna_struct.properties[rna_prop_str]
479
480         if type(rna_prop) != bpy.types.EnumProperty:
481             raise Exception("expected an enum property")
482
483         enums = rna_struct.properties[rna_prop_str].enum_items.keys()
484         orig_index = enums.index(orig_value)
485
486         # Have the info we need, advance to the next item.
487         #
488         # When wrap's disabled we may set the value to its self,
489         # this is done to ensure update callbacks run.
490         if self.reverse:
491             if orig_index == 0:
492                 advance_enum = enums[-1] if self.wrap else enums[0]
493             else:
494                 advance_enum = enums[orig_index - 1]
495         else:
496             if orig_index == len(enums) - 1:
497                 advance_enum = enums[0] if self.wrap else enums[-1]
498             else:
499                 advance_enum = enums[orig_index + 1]
500
501         # set the new value
502         exec("context.%s = advance_enum" % data_path)
503         return operator_path_undo_return(context, data_path)
504
505
506 class WM_OT_context_cycle_array(Operator):
507     """Set a context array value """ \
508     """(useful for cycling the active mesh edit mode)"""
509     bl_idname = "wm.context_cycle_array"
510     bl_label = "Context Array Cycle"
511     bl_options = {'UNDO', 'INTERNAL'}
512
513     data_path = rna_path_prop
514     reverse = rna_reverse_prop
515
516     def execute(self, context):
517         data_path = self.data_path
518         value = context_path_validate(context, data_path)
519         if value is Ellipsis:
520             return {'PASS_THROUGH'}
521
522         def cycle(array):
523             if self.reverse:
524                 array.insert(0, array.pop())
525             else:
526                 array.append(array.pop(0))
527             return array
528
529         exec("context.%s = cycle(context.%s[:])" % (data_path, data_path))
530
531         return operator_path_undo_return(context, data_path)
532
533
534 class WM_OT_context_menu_enum(Operator):
535     bl_idname = "wm.context_menu_enum"
536     bl_label = "Context Enum Menu"
537     bl_options = {'UNDO', 'INTERNAL'}
538     data_path = rna_path_prop
539
540     def execute(self, context):
541         data_path = self.data_path
542         value = context_path_validate(context, data_path)
543
544         if value is Ellipsis:
545             return {'PASS_THROUGH'}
546
547         base_path, prop_string = data_path.rsplit(".", 1)
548         value_base = context_path_validate(context, base_path)
549         prop = value_base.bl_rna.properties[prop_string]
550
551         def draw_cb(self, context):
552             layout = self.layout
553             layout.prop(value_base, prop_string, expand=True)
554
555         context.window_manager.popup_menu(draw_func=draw_cb, title=prop.name, icon=prop.icon)
556
557         return {'FINISHED'}
558
559
560 class WM_OT_context_pie_enum(Operator):
561     bl_idname = "wm.context_pie_enum"
562     bl_label = "Context Enum Pie"
563     bl_options = {'UNDO', 'INTERNAL'}
564     data_path = rna_path_prop
565
566     def invoke(self, context, event):
567         wm = context.window_manager
568         data_path = self.data_path
569         value = context_path_validate(context, data_path)
570
571         if value is Ellipsis:
572             return {'PASS_THROUGH'}
573
574         base_path, prop_string = data_path.rsplit(".", 1)
575         value_base = context_path_validate(context, base_path)
576         prop = value_base.bl_rna.properties[prop_string]
577
578         def draw_cb(self, context):
579             layout = self.layout
580             layout.prop(value_base, prop_string, expand=True)
581
582         wm.popup_menu_pie(draw_func=draw_cb, title=prop.name, icon=prop.icon, event=event)
583
584         return {'FINISHED'}
585
586
587 class WM_OT_operator_pie_enum(Operator):
588     bl_idname = "wm.operator_pie_enum"
589     bl_label = "Operator Enum Pie"
590     bl_options = {'UNDO', 'INTERNAL'}
591     data_path = StringProperty(
592             name="Operator",
593             description="Operator name (in python as string)",
594             maxlen=1024,
595             )
596     prop_string = StringProperty(
597             name="Property",
598             description="Property name (as a string)",
599             maxlen=1024,
600             )
601
602     def invoke(self, context, event):
603         wm = context.window_manager
604
605         data_path = self.data_path
606         prop_string = self.prop_string
607
608         # same as eval("bpy.ops." + data_path)
609         op_mod_str, ob_id_str = data_path.split(".", 1)
610         op = getattr(getattr(bpy.ops, op_mod_str), ob_id_str)
611         del op_mod_str, ob_id_str
612
613         try:
614             op_rna = op.get_rna()
615         except KeyError:
616             self.report({'ERROR'}, "Operator not found: bpy.ops.%s" % data_path)
617             return {'CANCELLED'}
618
619         def draw_cb(self, context):
620             layout = self.layout
621             pie = layout.menu_pie()
622             pie.operator_enum(data_path, prop_string)
623
624         wm.popup_menu_pie(draw_func=draw_cb, title=op_rna.bl_rna.name, event=event)
625
626         return {'FINISHED'}
627
628
629 class WM_OT_context_set_id(Operator):
630     """Set a context value to an ID data-block"""
631     bl_idname = "wm.context_set_id"
632     bl_label = "Set Library ID"
633     bl_options = {'UNDO', 'INTERNAL'}
634
635     data_path = rna_path_prop
636     value = StringProperty(
637             name="Value",
638             description="Assign value",
639             maxlen=1024,
640             )
641
642     def execute(self, context):
643         value = self.value
644         data_path = self.data_path
645
646         # match the pointer type from the target property to bpy.data.*
647         # so we lookup the correct list.
648         data_path_base, data_path_prop = data_path.rsplit(".", 1)
649         data_prop_rna = eval("context.%s" % data_path_base).rna_type.properties[data_path_prop]
650         data_prop_rna_type = data_prop_rna.fixed_type
651
652         id_iter = None
653
654         for prop in bpy.data.rna_type.properties:
655             if prop.rna_type.identifier == "CollectionProperty":
656                 if prop.fixed_type == data_prop_rna_type:
657                     id_iter = prop.identifier
658                     break
659
660         if id_iter:
661             value_id = getattr(bpy.data, id_iter).get(value)
662             exec("context.%s = value_id" % data_path)
663
664         return operator_path_undo_return(context, data_path)
665
666
667 doc_id = StringProperty(
668         name="Doc ID",
669         maxlen=1024,
670         options={'HIDDEN'},
671         )
672
673 data_path_iter = StringProperty(
674         description="The data path relative to the context, must point to an iterable")
675
676 data_path_item = StringProperty(
677         description="The data path from each iterable to the value (int or float)")
678
679
680 class WM_OT_context_collection_boolean_set(Operator):
681     """Set boolean values for a collection of items"""
682     bl_idname = "wm.context_collection_boolean_set"
683     bl_label = "Context Collection Boolean Set"
684     bl_options = {'UNDO', 'REGISTER', 'INTERNAL'}
685
686     data_path_iter = data_path_iter
687     data_path_item = data_path_item
688
689     type = EnumProperty(
690             name="Type",
691             items=(('TOGGLE', "Toggle", ""),
692                    ('ENABLE', "Enable", ""),
693                    ('DISABLE', "Disable", ""),
694                    ),
695             )
696
697     def execute(self, context):
698         data_path_iter = self.data_path_iter
699         data_path_item = self.data_path_item
700
701         items = list(getattr(context, data_path_iter))
702         items_ok = []
703         is_set = False
704         for item in items:
705             try:
706                 value_orig = eval("item." + data_path_item)
707             except:
708                 continue
709
710             if value_orig is True:
711                 is_set = True
712             elif value_orig is False:
713                 pass
714             else:
715                 self.report({'WARNING'}, "Non boolean value found: %s[ ].%s" %
716                             (data_path_iter, data_path_item))
717                 return {'CANCELLED'}
718
719             items_ok.append(item)
720
721         # avoid undo push when nothing to do
722         if not items_ok:
723             return {'CANCELLED'}
724
725         if self.type == 'ENABLE':
726             is_set = True
727         elif self.type == 'DISABLE':
728             is_set = False
729         else:
730             is_set = not is_set
731
732         exec_str = "item.%s = %s" % (data_path_item, is_set)
733         for item in items_ok:
734             exec(exec_str)
735
736         return operator_value_undo_return(item)
737
738
739 class WM_OT_context_modal_mouse(Operator):
740     """Adjust arbitrary values with mouse input"""
741     bl_idname = "wm.context_modal_mouse"
742     bl_label = "Context Modal Mouse"
743     bl_options = {'GRAB_CURSOR', 'BLOCKING', 'UNDO', 'INTERNAL'}
744
745     data_path_iter = data_path_iter
746     data_path_item = data_path_item
747     header_text = StringProperty(
748             name="Header Text",
749             description="Text to display in header during scale",
750             )
751
752     input_scale = FloatProperty(
753             description="Scale the mouse movement by this value before applying the delta",
754             default=0.01,
755             )
756     invert = BoolProperty(
757             description="Invert the mouse input",
758             default=False,
759             )
760     initial_x = IntProperty(options={'HIDDEN'})
761
762     def _values_store(self, context):
763         data_path_iter = self.data_path_iter
764         data_path_item = self.data_path_item
765
766         self._values = values = {}
767
768         for item in getattr(context, data_path_iter):
769             try:
770                 value_orig = eval("item." + data_path_item)
771             except:
772                 continue
773
774             # check this can be set, maybe this is library data.
775             try:
776                 exec("item.%s = %s" % (data_path_item, value_orig))
777             except:
778                 continue
779
780             values[item] = value_orig
781
782     def _values_delta(self, delta):
783         delta *= self.input_scale
784         if self.invert:
785             delta = - delta
786
787         data_path_item = self.data_path_item
788         for item, value_orig in self._values.items():
789             if type(value_orig) == int:
790                 exec("item.%s = int(%d)" % (data_path_item, round(value_orig + delta)))
791             else:
792                 exec("item.%s = %f" % (data_path_item, value_orig + delta))
793
794     def _values_restore(self):
795         data_path_item = self.data_path_item
796         for item, value_orig in self._values.items():
797             exec("item.%s = %s" % (data_path_item, value_orig))
798
799         self._values.clear()
800
801     def _values_clear(self):
802         self._values.clear()
803
804     def modal(self, context, event):
805         event_type = event.type
806
807         if event_type == 'MOUSEMOVE':
808             delta = event.mouse_x - self.initial_x
809             self._values_delta(delta)
810             header_text = self.header_text
811             if header_text:
812                 if len(self._values) == 1:
813                     (item, ) = self._values.keys()
814                     header_text = header_text % eval("item.%s" % self.data_path_item)
815                 else:
816                     header_text = (self.header_text % delta) + " (delta)"
817                 context.area.header_text_set(header_text)
818
819         elif 'LEFTMOUSE' == event_type:
820             item = next(iter(self._values.keys()))
821             self._values_clear()
822             context.area.header_text_set()
823             return operator_value_undo_return(item)
824
825         elif event_type in {'RIGHTMOUSE', 'ESC'}:
826             self._values_restore()
827             context.area.header_text_set()
828             return {'CANCELLED'}
829
830         return {'RUNNING_MODAL'}
831
832     def invoke(self, context, event):
833         self._values_store(context)
834
835         if not self._values:
836             self.report({'WARNING'}, "Nothing to operate on: %s[ ].%s" %
837                         (self.data_path_iter, self.data_path_item))
838
839             return {'CANCELLED'}
840         else:
841             self.initial_x = event.mouse_x
842
843             context.window_manager.modal_handler_add(self)
844             return {'RUNNING_MODAL'}
845
846
847 class WM_OT_url_open(Operator):
848     """Open a website in the web-browser"""
849     bl_idname = "wm.url_open"
850     bl_label = ""
851     bl_options = {'INTERNAL'}
852
853     url = StringProperty(
854             name="URL",
855             description="URL to open",
856             )
857
858     def execute(self, context):
859         import webbrowser
860         webbrowser.open(self.url)
861         return {'FINISHED'}
862
863
864 class WM_OT_path_open(Operator):
865     """Open a path in a file browser"""
866     bl_idname = "wm.path_open"
867     bl_label = ""
868     bl_options = {'INTERNAL'}
869
870     filepath = StringProperty(
871             subtype='FILE_PATH',
872             options={'SKIP_SAVE'},
873             )
874
875     def execute(self, context):
876         import sys
877         import os
878         import subprocess
879
880         filepath = self.filepath
881
882         if not filepath:
883             self.report({'ERROR'}, "File path was not set")
884             return {'CANCELLED'}
885
886         filepath = bpy.path.abspath(filepath)
887         filepath = os.path.normpath(filepath)
888
889         if not os.path.exists(filepath):
890             self.report({'ERROR'}, "File '%s' not found" % filepath)
891             return {'CANCELLED'}
892
893         if sys.platform[:3] == "win":
894             os.startfile(filepath)
895         elif sys.platform == "darwin":
896             subprocess.check_call(["open", filepath])
897         else:
898             try:
899                 subprocess.check_call(["xdg-open", filepath])
900             except:
901                 # xdg-open *should* be supported by recent Gnome, KDE, Xfce
902                 import traceback
903                 traceback.print_exc()
904
905         return {'FINISHED'}
906
907
908 def _wm_doc_get_id(doc_id, do_url=True, url_prefix=""):
909
910     def operator_exists_pair(a, b):
911         # Not fast, this is only for docs.
912         return b in dir(getattr(bpy.ops, a))
913
914     def operator_exists_single(a):
915         a, b = a.partition("_OT_")[::2]
916         return operator_exists_pair(a.lower(), b)
917
918     id_split = doc_id.split(".")
919     url = rna = None
920
921     if len(id_split) == 1:  # rna, class
922         if do_url:
923             url = "%s/bpy.types.%s.html" % (url_prefix, id_split[0])
924         else:
925             rna = "bpy.types.%s" % id_split[0]
926
927     elif len(id_split) == 2:  # rna, class.prop
928         class_name, class_prop = id_split
929
930         # an operator (common case - just button referencing an op)
931         if operator_exists_pair(class_name, class_prop):
932             if do_url:
933                 url = (
934                     "%s/bpy.ops.%s.html#bpy.ops.%s.%s" %
935                     (url_prefix, class_name, class_name, class_prop)
936                 )
937             else:
938                 rna = "bpy.ops.%s.%s" % (class_name, class_prop)
939         elif operator_exists_single(class_name):
940             # note: ignore the prop name since we don't have a way to link into it
941             class_name, class_prop = class_name.split("_OT_", 1)
942             class_name = class_name.lower()
943             if do_url:
944                 url = (
945                     "%s/bpy.ops.%s.html#bpy.ops.%s.%s" %
946                     (url_prefix, class_name, class_name, class_prop)
947                 )
948             else:
949                 rna = "bpy.ops.%s.%s" % (class_name, class_prop)
950         else:
951             # an RNA setting, common case
952             rna_class = getattr(bpy.types, class_name)
953
954             # detect if this is a inherited member and use that name instead
955             rna_parent = rna_class.bl_rna
956             rna_prop = rna_parent.properties.get(class_prop)
957             if rna_prop:
958                 rna_parent = rna_parent.base
959                 while rna_parent and rna_prop == rna_parent.properties.get(class_prop):
960                     class_name = rna_parent.identifier
961                     rna_parent = rna_parent.base
962
963                 if do_url:
964                     url = (
965                         "%s/bpy.types.%s.html#bpy.types.%s.%s" %
966                         (url_prefix, class_name, class_name, class_prop)
967                     )
968                 else:
969                     rna = "bpy.types.%s.%s" % (class_name, class_prop)
970             else:
971                 # We assume this is custom property, only try to generate generic url/rna_id...
972                 if do_url:
973                     url = ("%s/bpy.types.bpy_struct.html#bpy.types.bpy_struct.items" % (url_prefix,))
974                 else:
975                     rna = "bpy.types.bpy_struct"
976
977     return url if do_url else rna
978
979
980 class WM_OT_doc_view_manual(Operator):
981     """Load online manual"""
982     bl_idname = "wm.doc_view_manual"
983     bl_label = "View Manual"
984
985     doc_id = doc_id
986
987     @staticmethod
988     def _find_reference(rna_id, url_mapping, verbose=True):
989         if verbose:
990             print("online manual check for: '%s'... " % rna_id)
991         from fnmatch import fnmatchcase
992         # XXX, for some reason all RNA ID's are stored lowercase
993         # Adding case into all ID's isn't worth the hassle so force lowercase.
994         rna_id = rna_id.lower()
995         for pattern, url_suffix in url_mapping:
996             if fnmatchcase(rna_id, pattern):
997                 if verbose:
998                     print("            match found: '%s' --> '%s'" % (pattern, url_suffix))
999                 return url_suffix
1000         if verbose:
1001             print("match not found")
1002         return None
1003
1004     @staticmethod
1005     def _lookup_rna_url(rna_id, verbose=True):
1006         for prefix, url_manual_mapping in bpy.utils.manual_map():
1007             rna_ref = WM_OT_doc_view_manual._find_reference(rna_id, url_manual_mapping, verbose=verbose)
1008             if rna_ref is not None:
1009                 url = prefix + rna_ref
1010                 return url
1011
1012     def execute(self, context):
1013         rna_id = _wm_doc_get_id(self.doc_id, do_url=False)
1014         if rna_id is None:
1015             return {'PASS_THROUGH'}
1016
1017         url = self._lookup_rna_url(rna_id)
1018
1019         if url is None:
1020             self.report(
1021                     {'WARNING'},
1022                     "No reference available %r, "
1023                     "Update info in 'rna_manual_reference.py' "
1024                     "or callback to bpy.utils.manual_map()" %
1025                     self.doc_id)
1026             return {'CANCELLED'}
1027         else:
1028             import webbrowser
1029             webbrowser.open(url)
1030             return {'FINISHED'}
1031
1032
1033 class WM_OT_doc_view(Operator):
1034     """Load online reference docs"""
1035     bl_idname = "wm.doc_view"
1036     bl_label = "View Documentation"
1037
1038     doc_id = doc_id
1039     if bpy.app.version_cycle == "release":
1040         _prefix = ("https://docs.blender.org/api/blender_python_api_current")
1041     else:
1042         _prefix = ("https://docs.blender.org/api/blender_python_api_master")
1043
1044     def execute(self, context):
1045         url = _wm_doc_get_id(self.doc_id, do_url=True, url_prefix=self._prefix)
1046         if url is None:
1047             return {'PASS_THROUGH'}
1048
1049         import webbrowser
1050         webbrowser.open(url)
1051
1052         return {'FINISHED'}
1053
1054
1055 rna_path = StringProperty(
1056         name="Property Edit",
1057         description="Property data_path edit",
1058         maxlen=1024,
1059         options={'HIDDEN'},
1060         )
1061
1062 rna_value = StringProperty(
1063         name="Property Value",
1064         description="Property value edit",
1065         maxlen=1024,
1066         )
1067
1068 rna_property = StringProperty(
1069         name="Property Name",
1070         description="Property name edit",
1071         maxlen=1024,
1072         )
1073
1074 rna_min = FloatProperty(
1075         name="Min",
1076         default=-10000.0,
1077         precision=3,
1078         )
1079
1080 rna_max = FloatProperty(
1081         name="Max",
1082         default=10000.0,
1083         precision=3,
1084         )
1085
1086 rna_use_soft_limits = BoolProperty(
1087         name="Use Soft Limits",
1088         )
1089
1090
1091 class WM_OT_properties_edit(Operator):
1092     bl_idname = "wm.properties_edit"
1093     bl_label = "Edit Property"
1094     # register only because invoke_props_popup requires.
1095     bl_options = {'REGISTER', 'INTERNAL'}
1096
1097     data_path = rna_path
1098     property = rna_property
1099     value = rna_value
1100     min = rna_min
1101     max = rna_max
1102     use_soft_limits = rna_use_soft_limits
1103     soft_min = rna_min
1104     soft_max = rna_max
1105     description = StringProperty(
1106             name="Tooltip",
1107             )
1108
1109     def _cmp_props_get(self):
1110         # Changing these properties will refresh the UI
1111         return {
1112             "use_soft_limits": self.use_soft_limits,
1113             "soft_range": (self.soft_min, self.soft_max),
1114             "hard_range": (self.min, self.max),
1115             }
1116
1117     def execute(self, context):
1118         from rna_prop_ui import (
1119             rna_idprop_ui_prop_get,
1120             rna_idprop_ui_prop_clear,
1121             rna_idprop_ui_prop_update,
1122         )
1123
1124         data_path = self.data_path
1125         value = self.value
1126         prop = self.property
1127
1128         prop_old = getattr(self, "_last_prop", [None])[0]
1129
1130         if prop_old is None:
1131             self.report({'ERROR'}, "Direct execution not supported")
1132             return {'CANCELLED'}
1133
1134         try:
1135             value_eval = eval(value)
1136             # assert else None -> None, not "None", see [#33431]
1137             assert(type(value_eval) in {str, float, int, bool, tuple, list})
1138         except:
1139             value_eval = value
1140
1141         # First remove
1142         item = eval("context.%s" % data_path)
1143         prop_type_old = type(item[prop_old])
1144
1145         rna_idprop_ui_prop_clear(item, prop_old)
1146         exec_str = "del item[%r]" % prop_old
1147         # print(exec_str)
1148         exec(exec_str)
1149
1150         # Reassign
1151         exec_str = "item[%r] = %s" % (prop, repr(value_eval))
1152         # print(exec_str)
1153         exec(exec_str)
1154
1155         rna_idprop_ui_prop_update(item, prop)
1156
1157         self._last_prop[:] = [prop]
1158
1159         prop_type = type(item[prop])
1160
1161         prop_ui = rna_idprop_ui_prop_get(item, prop)
1162
1163         if prop_type in {float, int}:
1164             prop_ui["min"] = prop_type(self.min)
1165             prop_ui["max"] = prop_type(self.max)
1166
1167             if self.use_soft_limits:
1168                 prop_ui["soft_min"] = prop_type(self.soft_min)
1169                 prop_ui["soft_max"] = prop_type(self.soft_max)
1170             else:
1171                 prop_ui["soft_min"] = prop_type(self.min)
1172                 prop_ui["soft_max"] = prop_type(self.max)
1173
1174         prop_ui["description"] = self.description
1175
1176         # If we have changed the type of the property, update its potential anim curves!
1177         if prop_type_old != prop_type:
1178             data_path = '["%s"]' % bpy.utils.escape_identifier(prop)
1179             done = set()
1180
1181             def _update(fcurves):
1182                 for fcu in fcurves:
1183                     if fcu not in done and fcu.data_path == data_path:
1184                         fcu.update_autoflags(item)
1185                         done.add(fcu)
1186
1187             def _update_strips(strips):
1188                 for st in strips:
1189                     if st.type == 'CLIP' and st.action:
1190                         _update(st.action.fcurves)
1191                     elif st.type == 'META':
1192                         _update_strips(st.strips)
1193
1194             adt = getattr(item, "animation_data", None)
1195             if adt is not None:
1196                 if adt.action:
1197                     _update(adt.action.fcurves)
1198                 if adt.drivers:
1199                     _update(adt.drivers)
1200                 if adt.nla_tracks:
1201                     for nt in adt.nla_tracks:
1202                         _update_strips(nt.strips)
1203
1204         # otherwise existing buttons which reference freed
1205         # memory may crash blender [#26510]
1206         # context.area.tag_redraw()
1207         for win in context.window_manager.windows:
1208             for area in win.screen.areas:
1209                 area.tag_redraw()
1210
1211         return {'FINISHED'}
1212
1213     def invoke(self, context, event):
1214         from rna_prop_ui import rna_idprop_ui_prop_get
1215
1216         data_path = self.data_path
1217
1218         if not data_path:
1219             self.report({'ERROR'}, "Data path not set")
1220             return {'CANCELLED'}
1221
1222         self._last_prop = [self.property]
1223
1224         item = eval("context.%s" % data_path)
1225
1226         # setup defaults
1227         prop_ui = rna_idprop_ui_prop_get(item, self.property, False)  # don't create
1228         if prop_ui:
1229             self.min = prop_ui.get("min", -1000000000)
1230             self.max = prop_ui.get("max", 1000000000)
1231             self.description = prop_ui.get("description", "")
1232
1233             self.soft_min = prop_ui.get("soft_min", self.min)
1234             self.soft_max = prop_ui.get("soft_max", self.max)
1235             self.use_soft_limits = (
1236                     self.min != self.soft_min or
1237                     self.max != self.soft_max)
1238
1239         # store for comparison
1240         self._cmp_props = self._cmp_props_get()
1241
1242         wm = context.window_manager
1243         return wm.invoke_props_dialog(self)
1244
1245     def check(self, context):
1246         cmp_props = self._cmp_props_get()
1247         changed = False
1248         if self._cmp_props != cmp_props:
1249             if cmp_props["use_soft_limits"]:
1250                 if cmp_props["soft_range"] != self._cmp_props["soft_range"]:
1251                     self.min = min(self.min, self.soft_min)
1252                     self.max = max(self.max, self.soft_max)
1253                     changed = True
1254                 if cmp_props["hard_range"] != self._cmp_props["hard_range"]:
1255                     self.soft_min = max(self.min, self.soft_min)
1256                     self.soft_max = min(self.max, self.soft_max)
1257                     changed = True
1258             else:
1259                 if cmp_props["soft_range"] != cmp_props["hard_range"]:
1260                     self.soft_min = self.min
1261                     self.soft_max = self.max
1262                     changed = True
1263
1264             changed |= (cmp_props["use_soft_limits"] != self._cmp_props["use_soft_limits"])
1265
1266             if changed:
1267                 cmp_props = self._cmp_props_get()
1268
1269             self._cmp_props = cmp_props
1270
1271         return changed
1272
1273     def draw(self, context):
1274         layout = self.layout
1275         layout.prop(self, "property")
1276         layout.prop(self, "value")
1277         row = layout.row(align=True)
1278         row.prop(self, "min")
1279         row.prop(self, "max")
1280
1281         layout.prop(self, "use_soft_limits")
1282
1283         row = layout.row(align=True)
1284         row.enabled = self.use_soft_limits
1285         row.prop(self, "soft_min", text="Soft Min")
1286         row.prop(self, "soft_max", text="Soft Max")
1287         layout.prop(self, "description")
1288
1289
1290 class WM_OT_properties_add(Operator):
1291     bl_idname = "wm.properties_add"
1292     bl_label = "Add Property"
1293     bl_options = {'UNDO', 'INTERNAL'}
1294
1295     data_path = rna_path
1296
1297     def execute(self, context):
1298         from rna_prop_ui import (
1299             rna_idprop_ui_prop_get,
1300             rna_idprop_ui_prop_update,
1301         )
1302
1303         data_path = self.data_path
1304         item = eval("context.%s" % data_path)
1305
1306         def unique_name(names):
1307             prop = "prop"
1308             prop_new = prop
1309             i = 1
1310             while prop_new in names:
1311                 prop_new = prop + str(i)
1312                 i += 1
1313
1314             return prop_new
1315
1316         prop = unique_name({
1317             *item.keys(),
1318             *type(item).bl_rna.properties.keys(),
1319         })
1320
1321         item[prop] = 1.0
1322         rna_idprop_ui_prop_update(item, prop)
1323
1324         # not essential, but without this we get [#31661]
1325         prop_ui = rna_idprop_ui_prop_get(item, prop)
1326         prop_ui["soft_min"] = prop_ui["min"] = 0.0
1327         prop_ui["soft_max"] = prop_ui["max"] = 1.0
1328
1329         return {'FINISHED'}
1330
1331
1332 class WM_OT_properties_context_change(Operator):
1333     """Jump to a different tab inside the properties editor"""
1334     bl_idname = "wm.properties_context_change"
1335     bl_label = ""
1336     bl_options = {'INTERNAL'}
1337
1338     context = StringProperty(
1339             name="Context",
1340             maxlen=64,
1341             )
1342
1343     def execute(self, context):
1344         context.space_data.context = self.context
1345         return {'FINISHED'}
1346
1347
1348 class WM_OT_properties_remove(Operator):
1349     """Internal use (edit a property data_path)"""
1350     bl_idname = "wm.properties_remove"
1351     bl_label = "Remove Property"
1352     bl_options = {'UNDO', 'INTERNAL'}
1353
1354     data_path = rna_path
1355     property = rna_property
1356
1357     def execute(self, context):
1358         from rna_prop_ui import (
1359             rna_idprop_ui_prop_clear,
1360             rna_idprop_ui_prop_update,
1361         )
1362         data_path = self.data_path
1363         item = eval("context.%s" % data_path)
1364         prop = self.property
1365         rna_idprop_ui_prop_update(item, prop)
1366         del item[prop]
1367         rna_idprop_ui_prop_clear(item, prop)
1368
1369         return {'FINISHED'}
1370
1371
1372 class WM_OT_keyconfig_activate(Operator):
1373     bl_idname = "wm.keyconfig_activate"
1374     bl_label = "Activate Keyconfig"
1375
1376     filepath = StringProperty(
1377             subtype='FILE_PATH',
1378             )
1379
1380     def execute(self, context):
1381         if bpy.utils.keyconfig_set(self.filepath, report=self.report):
1382             return {'FINISHED'}
1383         else:
1384             return {'CANCELLED'}
1385
1386
1387 class WM_OT_appconfig_default(Operator):
1388     bl_idname = "wm.appconfig_default"
1389     bl_label = "Default Application Configuration"
1390
1391     def execute(self, context):
1392         import os
1393
1394         context.window_manager.keyconfigs.active = context.window_manager.keyconfigs.default
1395
1396         filepath = os.path.join(bpy.utils.preset_paths("interaction")[0], "blender.py")
1397
1398         if os.path.exists(filepath):
1399             bpy.ops.script.execute_preset(
1400                 filepath=filepath,
1401                 menu_idname="USERPREF_MT_interaction_presets",
1402             )
1403
1404         return {'FINISHED'}
1405
1406
1407 class WM_OT_appconfig_activate(Operator):
1408     bl_idname = "wm.appconfig_activate"
1409     bl_label = "Activate Application Configuration"
1410
1411     filepath = StringProperty(
1412             subtype='FILE_PATH',
1413             )
1414
1415     def execute(self, context):
1416         import os
1417         bpy.utils.keyconfig_set(self.filepath)
1418
1419         filepath = self.filepath.replace("keyconfig", "interaction")
1420
1421         if os.path.exists(filepath):
1422             bpy.ops.script.execute_preset(
1423                 filepath=filepath,
1424                 menu_idname="USERPREF_MT_interaction_presets",
1425             )
1426
1427         return {'FINISHED'}
1428
1429
1430 class WM_OT_sysinfo(Operator):
1431     """Generate system information, saved into a text file"""
1432
1433     bl_idname = "wm.sysinfo"
1434     bl_label = "Save System Info"
1435
1436     filepath = StringProperty(
1437             subtype='FILE_PATH',
1438             options={'SKIP_SAVE'},
1439             )
1440
1441     def execute(self, context):
1442         import sys_info
1443         sys_info.write_sysinfo(self.filepath)
1444         return {'FINISHED'}
1445
1446     def invoke(self, context, event):
1447         import os
1448
1449         if not self.filepath:
1450             self.filepath = os.path.join(
1451                     os.path.expanduser("~"), "system-info.txt")
1452
1453         wm = context.window_manager
1454         wm.fileselect_add(self)
1455         return {'RUNNING_MODAL'}
1456
1457
1458 class WM_OT_copy_prev_settings(Operator):
1459     """Copy settings from previous version"""
1460     bl_idname = "wm.copy_prev_settings"
1461     bl_label = "Copy Previous Settings"
1462
1463     def execute(self, context):
1464         import os
1465         import shutil
1466         ver = bpy.app.version
1467         ver_old = ((ver[0] * 100) + ver[1]) - 1
1468         path_src = bpy.utils.resource_path('USER', ver_old // 100, ver_old % 100)
1469         path_dst = bpy.utils.resource_path('USER')
1470
1471         if os.path.isdir(path_dst):
1472             self.report({'ERROR'}, "Target path %r exists" % path_dst)
1473         elif not os.path.isdir(path_src):
1474             self.report({'ERROR'}, "Source path %r does not exist" % path_src)
1475         else:
1476             shutil.copytree(path_src, path_dst, symlinks=True)
1477
1478             # reload recent-files.txt
1479             bpy.ops.wm.read_history()
1480
1481             # don't loose users work if they open the splash later.
1482             if bpy.data.is_saved is bpy.data.is_dirty is False:
1483                 bpy.ops.wm.read_homefile()
1484             else:
1485                 self.report({'INFO'}, "Reload Start-Up file to restore settings")
1486
1487             return {'FINISHED'}
1488
1489         return {'CANCELLED'}
1490
1491
1492 class WM_OT_blenderplayer_start(Operator):
1493     """Launch the blender-player with the current blend-file"""
1494     bl_idname = "wm.blenderplayer_start"
1495     bl_label = "Start Game In Player"
1496
1497     def execute(self, context):
1498         import os
1499         import sys
1500         import subprocess
1501
1502         gs = context.scene.game_settings
1503
1504         # these remain the same every execution
1505         blender_bin_path = bpy.app.binary_path
1506         blender_bin_dir = os.path.dirname(blender_bin_path)
1507         ext = os.path.splitext(blender_bin_path)[-1]
1508         player_path = os.path.join(blender_bin_dir, "blenderplayer" + ext)
1509         # done static vars
1510
1511         if sys.platform == "darwin":
1512             player_path = os.path.join(blender_bin_dir, "../../../blenderplayer.app/Contents/MacOS/blenderplayer")
1513
1514         if not os.path.exists(player_path):
1515             self.report({'ERROR'}, "Player path: %r not found" % player_path)
1516             return {'CANCELLED'}
1517
1518         filepath = bpy.data.filepath + '~' if bpy.data.is_saved else os.path.join(bpy.app.tempdir, "game.blend")
1519         bpy.ops.wm.save_as_mainfile('EXEC_DEFAULT', filepath=filepath, copy=True)
1520
1521         # start the command line call with the player path
1522         args = [player_path]
1523
1524         # handle some UI options as command line arguments
1525         args.extend([
1526             "-g", "show_framerate", "=", "%d" % gs.show_framerate_profile,
1527             "-g", "show_profile", "=", "%d" % gs.show_framerate_profile,
1528             "-g", "show_properties", "=", "%d" % gs.show_debug_properties,
1529             "-g", "ignore_deprecation_warnings", "=", "%d" % (not gs.use_deprecation_warnings),
1530         ])
1531
1532         # finish the call with the path to the blend file
1533         args.append(filepath)
1534
1535         subprocess.call(args)
1536         os.remove(filepath)
1537         return {'FINISHED'}
1538
1539
1540 class WM_OT_keyconfig_test(Operator):
1541     """Test key-config for conflicts"""
1542     bl_idname = "wm.keyconfig_test"
1543     bl_label = "Test Key Configuration for Conflicts"
1544
1545     def execute(self, context):
1546         from bpy_extras import keyconfig_utils
1547
1548         wm = context.window_manager
1549         kc = wm.keyconfigs.default
1550
1551         if keyconfig_utils.keyconfig_test(kc):
1552             print("CONFLICT")
1553
1554         return {'FINISHED'}
1555
1556
1557 class WM_OT_keyconfig_import(Operator):
1558     """Import key configuration from a python script"""
1559     bl_idname = "wm.keyconfig_import"
1560     bl_label = "Import Key Configuration..."
1561
1562     filepath = StringProperty(
1563             subtype='FILE_PATH',
1564             default="keymap.py",
1565             )
1566     filter_folder = BoolProperty(
1567             name="Filter folders",
1568             default=True,
1569             options={'HIDDEN'},
1570             )
1571     filter_text = BoolProperty(
1572             name="Filter text",
1573             default=True,
1574             options={'HIDDEN'},
1575             )
1576     filter_python = BoolProperty(
1577             name="Filter python",
1578             default=True,
1579             options={'HIDDEN'},
1580             )
1581     keep_original = BoolProperty(
1582             name="Keep original",
1583             description="Keep original file after copying to configuration folder",
1584             default=True,
1585             )
1586
1587     def execute(self, context):
1588         import os
1589         from os.path import basename
1590         import shutil
1591
1592         if not self.filepath:
1593             self.report({'ERROR'}, "Filepath not set")
1594             return {'CANCELLED'}
1595
1596         config_name = basename(self.filepath)
1597
1598         path = bpy.utils.user_resource('SCRIPTS', os.path.join("presets", "keyconfig"), create=True)
1599         path = os.path.join(path, config_name)
1600
1601         try:
1602             if self.keep_original:
1603                 shutil.copy(self.filepath, path)
1604             else:
1605                 shutil.move(self.filepath, path)
1606         except Exception as e:
1607             self.report({'ERROR'}, "Installing keymap failed: %s" % e)
1608             return {'CANCELLED'}
1609
1610         # sneaky way to check we're actually running the code.
1611         if bpy.utils.keyconfig_set(path, report=self.report):
1612             return {'FINISHED'}
1613         else:
1614             return {'CANCELLED'}
1615
1616     def invoke(self, context, event):
1617         wm = context.window_manager
1618         wm.fileselect_add(self)
1619         return {'RUNNING_MODAL'}
1620
1621 # This operator is also used by interaction presets saving - AddPresetBase
1622
1623
1624 class WM_OT_keyconfig_export(Operator):
1625     """Export key configuration to a python script"""
1626     bl_idname = "wm.keyconfig_export"
1627     bl_label = "Export Key Configuration..."
1628
1629     filepath = StringProperty(
1630             subtype='FILE_PATH',
1631             default="keymap.py",
1632             )
1633     filter_folder = BoolProperty(
1634             name="Filter folders",
1635             default=True,
1636             options={'HIDDEN'},
1637             )
1638     filter_text = BoolProperty(
1639             name="Filter text",
1640             default=True,
1641             options={'HIDDEN'},
1642             )
1643     filter_python = BoolProperty(
1644             name="Filter python",
1645             default=True,
1646             options={'HIDDEN'},
1647             )
1648
1649     def execute(self, context):
1650         from bpy_extras import keyconfig_utils
1651
1652         if not self.filepath:
1653             raise Exception("Filepath not set")
1654
1655         if not self.filepath.endswith(".py"):
1656             self.filepath += ".py"
1657
1658         wm = context.window_manager
1659
1660         keyconfig_utils.keyconfig_export(
1661             wm,
1662             wm.keyconfigs.active,
1663             self.filepath,
1664         )
1665
1666         return {'FINISHED'}
1667
1668     def invoke(self, context, event):
1669         wm = context.window_manager
1670         wm.fileselect_add(self)
1671         return {'RUNNING_MODAL'}
1672
1673
1674 class WM_OT_keymap_restore(Operator):
1675     """Restore key map(s)"""
1676     bl_idname = "wm.keymap_restore"
1677     bl_label = "Restore Key Map(s)"
1678
1679     all = BoolProperty(
1680             name="All Keymaps",
1681             description="Restore all keymaps to default",
1682             )
1683
1684     def execute(self, context):
1685         wm = context.window_manager
1686
1687         if self.all:
1688             for km in wm.keyconfigs.user.keymaps:
1689                 km.restore_to_default()
1690         else:
1691             km = context.keymap
1692             km.restore_to_default()
1693
1694         return {'FINISHED'}
1695
1696
1697 class WM_OT_keyitem_restore(Operator):
1698     """Restore key map item"""
1699     bl_idname = "wm.keyitem_restore"
1700     bl_label = "Restore Key Map Item"
1701
1702     item_id = IntProperty(
1703             name="Item Identifier",
1704             description="Identifier of the item to remove",
1705             )
1706
1707     @classmethod
1708     def poll(cls, context):
1709         keymap = getattr(context, "keymap", None)
1710         return keymap
1711
1712     def execute(self, context):
1713         km = context.keymap
1714         kmi = km.keymap_items.from_id(self.item_id)
1715
1716         if (not kmi.is_user_defined) and kmi.is_user_modified:
1717             km.restore_item_to_default(kmi)
1718
1719         return {'FINISHED'}
1720
1721
1722 class WM_OT_keyitem_add(Operator):
1723     """Add key map item"""
1724     bl_idname = "wm.keyitem_add"
1725     bl_label = "Add Key Map Item"
1726
1727     def execute(self, context):
1728         km = context.keymap
1729
1730         if km.is_modal:
1731             km.keymap_items.new_modal("", 'A', 'PRESS')
1732         else:
1733             km.keymap_items.new("none", 'A', 'PRESS')
1734
1735         # clear filter and expand keymap so we can see the newly added item
1736         if context.space_data.filter_text != "":
1737             context.space_data.filter_text = ""
1738             km.show_expanded_items = True
1739             km.show_expanded_children = True
1740
1741         return {'FINISHED'}
1742
1743
1744 class WM_OT_keyitem_remove(Operator):
1745     """Remove key map item"""
1746     bl_idname = "wm.keyitem_remove"
1747     bl_label = "Remove Key Map Item"
1748
1749     item_id = IntProperty(
1750             name="Item Identifier",
1751             description="Identifier of the item to remove",
1752             )
1753
1754     @classmethod
1755     def poll(cls, context):
1756         return hasattr(context, "keymap")
1757
1758     def execute(self, context):
1759         km = context.keymap
1760         kmi = km.keymap_items.from_id(self.item_id)
1761         km.keymap_items.remove(kmi)
1762         return {'FINISHED'}
1763
1764
1765 class WM_OT_keyconfig_remove(Operator):
1766     """Remove key config"""
1767     bl_idname = "wm.keyconfig_remove"
1768     bl_label = "Remove Key Config"
1769
1770     @classmethod
1771     def poll(cls, context):
1772         wm = context.window_manager
1773         keyconf = wm.keyconfigs.active
1774         return keyconf and keyconf.is_user_defined
1775
1776     def execute(self, context):
1777         wm = context.window_manager
1778         keyconfig = wm.keyconfigs.active
1779         wm.keyconfigs.remove(keyconfig)
1780         return {'FINISHED'}
1781
1782
1783 class WM_OT_operator_cheat_sheet(Operator):
1784     """List all the Operators in a text-block, useful for scripting"""
1785     bl_idname = "wm.operator_cheat_sheet"
1786     bl_label = "Operator Cheat Sheet"
1787
1788     def execute(self, context):
1789         op_strings = []
1790         tot = 0
1791         for op_module_name in dir(bpy.ops):
1792             op_module = getattr(bpy.ops, op_module_name)
1793             for op_submodule_name in dir(op_module):
1794                 op = getattr(op_module, op_submodule_name)
1795                 text = repr(op)
1796                 if text.split("\n")[-1].startswith("bpy.ops."):
1797                     op_strings.append(text)
1798                     tot += 1
1799
1800             op_strings.append('')
1801
1802         textblock = bpy.data.texts.new("OperatorList.txt")
1803         textblock.write('# %d Operators\n\n' % tot)
1804         textblock.write('\n'.join(op_strings))
1805         self.report({'INFO'}, "See OperatorList.txt textblock")
1806         return {'FINISHED'}
1807
1808
1809 # -----------------------------------------------------------------------------
1810 # Add-on Operators
1811
1812 class WM_OT_addon_enable(Operator):
1813     """Enable an add-on"""
1814     bl_idname = "wm.addon_enable"
1815     bl_label = "Enable Add-on"
1816
1817     module = StringProperty(
1818             name="Module",
1819             description="Module name of the add-on to enable",
1820             )
1821
1822     def execute(self, context):
1823         import addon_utils
1824
1825         err_str = ""
1826
1827         def err_cb(ex):
1828             import traceback
1829             nonlocal err_str
1830             err_str = traceback.format_exc()
1831             print(err_str)
1832
1833         mod = addon_utils.enable(self.module, default_set=True, handle_error=err_cb)
1834
1835         if mod:
1836             info = addon_utils.module_bl_info(mod)
1837
1838             info_ver = info.get("blender", (0, 0, 0))
1839
1840             if info_ver > bpy.app.version:
1841                 self.report({'WARNING'},
1842                             ("This script was written Blender "
1843                              "version %d.%d.%d and might not "
1844                              "function (correctly), "
1845                              "though it is enabled" %
1846                              info_ver))
1847             return {'FINISHED'}
1848         else:
1849
1850             if err_str:
1851                 self.report({'ERROR'}, err_str)
1852
1853             return {'CANCELLED'}
1854
1855
1856 class WM_OT_addon_disable(Operator):
1857     """Disable an add-on"""
1858     bl_idname = "wm.addon_disable"
1859     bl_label = "Disable Add-on"
1860
1861     module = StringProperty(
1862             name="Module",
1863             description="Module name of the add-on to disable",
1864             )
1865
1866     def execute(self, context):
1867         import addon_utils
1868
1869         err_str = ""
1870
1871         def err_cb(ex):
1872             import traceback
1873             nonlocal err_str
1874             err_str = traceback.format_exc()
1875             print(err_str)
1876
1877         addon_utils.disable(self.module, default_set=True, handle_error=err_cb)
1878
1879         if err_str:
1880             self.report({'ERROR'}, err_str)
1881
1882         return {'FINISHED'}
1883
1884
1885 class WM_OT_theme_install(Operator):
1886     """Load and apply a Blender XML theme file"""
1887     bl_idname = "wm.theme_install"
1888     bl_label = "Install Theme..."
1889
1890     overwrite = BoolProperty(
1891             name="Overwrite",
1892             description="Remove existing theme file if exists",
1893             default=True,
1894             )
1895     filepath = StringProperty(
1896             subtype='FILE_PATH',
1897             )
1898     filter_folder = BoolProperty(
1899             name="Filter folders",
1900             default=True,
1901             options={'HIDDEN'},
1902             )
1903     filter_glob = StringProperty(
1904             default="*.xml",
1905             options={'HIDDEN'},
1906             )
1907
1908     def execute(self, context):
1909         import os
1910         import shutil
1911         import traceback
1912
1913         xmlfile = self.filepath
1914
1915         path_themes = bpy.utils.user_resource('SCRIPTS', "presets/interface_theme", create=True)
1916
1917         if not path_themes:
1918             self.report({'ERROR'}, "Failed to get themes path")
1919             return {'CANCELLED'}
1920
1921         path_dest = os.path.join(path_themes, os.path.basename(xmlfile))
1922
1923         if not self.overwrite:
1924             if os.path.exists(path_dest):
1925                 self.report({'WARNING'}, "File already installed to %r\n" % path_dest)
1926                 return {'CANCELLED'}
1927
1928         try:
1929             shutil.copyfile(xmlfile, path_dest)
1930             bpy.ops.script.execute_preset(
1931                 filepath=path_dest,
1932                 menu_idname="USERPREF_MT_interface_theme_presets",
1933             )
1934
1935         except:
1936             traceback.print_exc()
1937             return {'CANCELLED'}
1938
1939         return {'FINISHED'}
1940
1941     def invoke(self, context, event):
1942         wm = context.window_manager
1943         wm.fileselect_add(self)
1944         return {'RUNNING_MODAL'}
1945
1946
1947 class WM_OT_addon_refresh(Operator):
1948     """Scan add-on directories for new modules"""
1949     bl_idname = "wm.addon_refresh"
1950     bl_label = "Refresh"
1951
1952     def execute(self, context):
1953         import addon_utils
1954
1955         addon_utils.modules_refresh()
1956
1957         return {'FINISHED'}
1958
1959
1960 # Note: shares some logic with WM_OT_app_template_install
1961 # but not enough to de-duplicate. Fixed here may apply to both.
1962 class WM_OT_addon_install(Operator):
1963     """Install an add-on"""
1964     bl_idname = "wm.addon_install"
1965     bl_label = "Install Add-on from File..."
1966
1967     overwrite = BoolProperty(
1968             name="Overwrite",
1969             description="Remove existing add-ons with the same ID",
1970             default=True,
1971             )
1972     target = EnumProperty(
1973             name="Target Path",
1974             items=(('DEFAULT', "Default", ""),
1975                    ('PREFS', "User Prefs", "")),
1976             )
1977
1978     filepath = StringProperty(
1979             subtype='FILE_PATH',
1980             )
1981     filter_folder = BoolProperty(
1982             name="Filter folders",
1983             default=True,
1984             options={'HIDDEN'},
1985             )
1986     filter_python = BoolProperty(
1987             name="Filter python",
1988             default=True,
1989             options={'HIDDEN'},
1990             )
1991     filter_glob = StringProperty(
1992             default="*.py;*.zip",
1993             options={'HIDDEN'},
1994             )
1995
1996     def execute(self, context):
1997         import addon_utils
1998         import traceback
1999         import zipfile
2000         import shutil
2001         import os
2002
2003         pyfile = self.filepath
2004
2005         if self.target == 'DEFAULT':
2006             # don't use bpy.utils.script_paths("addons") because we may not be able to write to it.
2007             path_addons = bpy.utils.user_resource('SCRIPTS', "addons", create=True)
2008         else:
2009             path_addons = context.user_preferences.filepaths.script_directory
2010             if path_addons:
2011                 path_addons = os.path.join(path_addons, "addons")
2012
2013         if not path_addons:
2014             self.report({'ERROR'}, "Failed to get add-ons path")
2015             return {'CANCELLED'}
2016
2017         if not os.path.isdir(path_addons):
2018             try:
2019                 os.makedirs(path_addons, exist_ok=True)
2020             except:
2021                 traceback.print_exc()
2022
2023         # Check if we are installing from a target path,
2024         # doing so causes 2+ addons of same name or when the same from/to
2025         # location is used, removal of the file!
2026         addon_path = ""
2027         pyfile_dir = os.path.dirname(pyfile)
2028         for addon_path in addon_utils.paths():
2029             if os.path.samefile(pyfile_dir, addon_path):
2030                 self.report({'ERROR'}, "Source file is in the add-on search path: %r" % addon_path)
2031                 return {'CANCELLED'}
2032         del addon_path
2033         del pyfile_dir
2034         # done checking for exceptional case
2035
2036         addons_old = {mod.__name__ for mod in addon_utils.modules()}
2037
2038         # check to see if the file is in compressed format (.zip)
2039         if zipfile.is_zipfile(pyfile):
2040             try:
2041                 file_to_extract = zipfile.ZipFile(pyfile, 'r')
2042             except:
2043                 traceback.print_exc()
2044                 return {'CANCELLED'}
2045
2046             if self.overwrite:
2047                 for f in file_to_extract.namelist():
2048                     module_filesystem_remove(path_addons, f)
2049             else:
2050                 for f in file_to_extract.namelist():
2051                     path_dest = os.path.join(path_addons, os.path.basename(f))
2052                     if os.path.exists(path_dest):
2053                         self.report({'WARNING'}, "File already installed to %r\n" % path_dest)
2054                         return {'CANCELLED'}
2055
2056             try:  # extract the file to "addons"
2057                 file_to_extract.extractall(path_addons)
2058             except:
2059                 traceback.print_exc()
2060                 return {'CANCELLED'}
2061
2062         else:
2063             path_dest = os.path.join(path_addons, os.path.basename(pyfile))
2064
2065             if self.overwrite:
2066                 module_filesystem_remove(path_addons, os.path.basename(pyfile))
2067             elif os.path.exists(path_dest):
2068                 self.report({'WARNING'}, "File already installed to %r\n" % path_dest)
2069                 return {'CANCELLED'}
2070
2071             # if not compressed file just copy into the addon path
2072             try:
2073                 shutil.copyfile(pyfile, path_dest)
2074             except:
2075                 traceback.print_exc()
2076                 return {'CANCELLED'}
2077
2078         addons_new = {mod.__name__ for mod in addon_utils.modules()} - addons_old
2079         addons_new.discard("modules")
2080
2081         # disable any addons we may have enabled previously and removed.
2082         # this is unlikely but do just in case. bug [#23978]
2083         for new_addon in addons_new:
2084             addon_utils.disable(new_addon, default_set=True)
2085
2086         # possible the zip contains multiple addons, we could disallow this
2087         # but for now just use the first
2088         for mod in addon_utils.modules(refresh=False):
2089             if mod.__name__ in addons_new:
2090                 info = addon_utils.module_bl_info(mod)
2091
2092                 # show the newly installed addon.
2093                 context.window_manager.addon_filter = 'All'
2094                 context.window_manager.addon_search = info["name"]
2095                 break
2096
2097         # in case a new module path was created to install this addon.
2098         bpy.utils.refresh_script_paths()
2099
2100         # print message
2101         msg = (
2102             tip_("Modules Installed (%s) from %r into %r") %
2103             (", ".join(sorted(addons_new)), pyfile, path_addons)
2104         )
2105         print(msg)
2106         self.report({'INFO'}, msg)
2107
2108         return {'FINISHED'}
2109
2110     def invoke(self, context, event):
2111         wm = context.window_manager
2112         wm.fileselect_add(self)
2113         return {'RUNNING_MODAL'}
2114
2115
2116 class WM_OT_addon_remove(Operator):
2117     """Delete the add-on from the file system"""
2118     bl_idname = "wm.addon_remove"
2119     bl_label = "Remove Add-on"
2120
2121     module = StringProperty(
2122             name="Module",
2123             description="Module name of the add-on to remove",
2124             )
2125
2126     @staticmethod
2127     def path_from_addon(module):
2128         import os
2129         import addon_utils
2130
2131         for mod in addon_utils.modules():
2132             if mod.__name__ == module:
2133                 filepath = mod.__file__
2134                 if os.path.exists(filepath):
2135                     if os.path.splitext(os.path.basename(filepath))[0] == "__init__":
2136                         return os.path.dirname(filepath), True
2137                     else:
2138                         return filepath, False
2139         return None, False
2140
2141     def execute(self, context):
2142         import addon_utils
2143         import os
2144
2145         path, isdir = WM_OT_addon_remove.path_from_addon(self.module)
2146         if path is None:
2147             self.report({'WARNING'}, "Add-on path %r could not be found" % path)
2148             return {'CANCELLED'}
2149
2150         # in case its enabled
2151         addon_utils.disable(self.module, default_set=True)
2152
2153         import shutil
2154         if isdir:
2155             shutil.rmtree(path)
2156         else:
2157             os.remove(path)
2158
2159         addon_utils.modules_refresh()
2160
2161         context.area.tag_redraw()
2162         return {'FINISHED'}
2163
2164     # lame confirmation check
2165     def draw(self, context):
2166         self.layout.label(text="Remove Add-on: %r?" % self.module)
2167         path, isdir = WM_OT_addon_remove.path_from_addon(self.module)
2168         self.layout.label(text="Path: %r" % path)
2169
2170     def invoke(self, context, event):
2171         wm = context.window_manager
2172         return wm.invoke_props_dialog(self, width=600)
2173
2174
2175 class WM_OT_addon_expand(Operator):
2176     """Display information and preferences for this add-on"""
2177     bl_idname = "wm.addon_expand"
2178     bl_label = ""
2179     bl_options = {'INTERNAL'}
2180
2181     module = StringProperty(
2182             name="Module",
2183             description="Module name of the add-on to expand",
2184             )
2185
2186     def execute(self, context):
2187         import addon_utils
2188
2189         module_name = self.module
2190
2191         mod = addon_utils.addons_fake_modules.get(module_name)
2192         if mod is not None:
2193             info = addon_utils.module_bl_info(mod)
2194             info["show_expanded"] = not info["show_expanded"]
2195
2196         return {'FINISHED'}
2197
2198
2199 class WM_OT_addon_userpref_show(Operator):
2200     """Show add-on user preferences"""
2201     bl_idname = "wm.addon_userpref_show"
2202     bl_label = ""
2203     bl_options = {'INTERNAL'}
2204
2205     module = StringProperty(
2206             name="Module",
2207             description="Module name of the add-on to expand",
2208             )
2209
2210     def execute(self, context):
2211         import addon_utils
2212
2213         module_name = self.module
2214
2215         modules = addon_utils.modules(refresh=False)
2216         mod = addon_utils.addons_fake_modules.get(module_name)
2217         if mod is not None:
2218             info = addon_utils.module_bl_info(mod)
2219             info["show_expanded"] = True
2220
2221             bpy.context.user_preferences.active_section = 'ADDONS'
2222             context.window_manager.addon_filter = 'All'
2223             context.window_manager.addon_search = info["name"]
2224             bpy.ops.screen.userpref_show('INVOKE_DEFAULT')
2225
2226         return {'FINISHED'}
2227
2228
2229 # Note: shares some logic with WM_OT_addon_install
2230 # but not enough to de-duplicate. Fixes here may apply to both.
2231 class WM_OT_app_template_install(Operator):
2232     """Install an application-template"""
2233     bl_idname = "wm.app_template_install"
2234     bl_label = "Install Template from File..."
2235
2236     overwrite = BoolProperty(
2237             name="Overwrite",
2238             description="Remove existing template with the same ID",
2239             default=True,
2240             )
2241
2242     filepath = StringProperty(
2243             subtype='FILE_PATH',
2244             )
2245     filter_folder = BoolProperty(
2246             name="Filter folders",
2247             default=True,
2248             options={'HIDDEN'},
2249             )
2250     filter_glob = StringProperty(
2251             default="*.zip",
2252             options={'HIDDEN'},
2253             )
2254
2255     def execute(self, context):
2256         import traceback
2257         import zipfile
2258         import shutil
2259         import os
2260
2261         filepath = self.filepath
2262
2263         path_app_templates = bpy.utils.user_resource(
2264             'SCRIPTS', os.path.join("startup", "bl_app_templates_user"),
2265             create=True,
2266         )
2267
2268         if not path_app_templates:
2269             self.report({'ERROR'}, "Failed to get add-ons path")
2270             return {'CANCELLED'}
2271
2272         if not os.path.isdir(path_app_templates):
2273             try:
2274                 os.makedirs(path_app_templates, exist_ok=True)
2275             except:
2276                 traceback.print_exc()
2277
2278         app_templates_old = set(os.listdir(path_app_templates))
2279
2280         # check to see if the file is in compressed format (.zip)
2281         if zipfile.is_zipfile(filepath):
2282             try:
2283                 file_to_extract = zipfile.ZipFile(filepath, 'r')
2284             except:
2285                 traceback.print_exc()
2286                 return {'CANCELLED'}
2287
2288             if self.overwrite:
2289                 for f in file_to_extract.namelist():
2290                     module_filesystem_remove(path_app_templates, f)
2291             else:
2292                 for f in file_to_extract.namelist():
2293                     path_dest = os.path.join(path_app_templates, os.path.basename(f))
2294                     if os.path.exists(path_dest):
2295                         self.report({'WARNING'}, "File already installed to %r\n" % path_dest)
2296                         return {'CANCELLED'}
2297
2298             try:  # extract the file to "bl_app_templates_user"
2299                 file_to_extract.extractall(path_app_templates)
2300             except:
2301                 traceback.print_exc()
2302                 return {'CANCELLED'}
2303
2304         else:
2305             # Only support installing zipfiles
2306             self.report({'WARNING'}, "Expected a zip-file %r\n" % filepath)
2307             return {'CANCELLED'}
2308
2309         app_templates_new = set(os.listdir(path_app_templates)) - app_templates_old
2310
2311         # in case a new module path was created to install this addon.
2312         bpy.utils.refresh_script_paths()
2313
2314         # print message
2315         msg = (
2316             tip_("Template Installed (%s) from %r into %r") %
2317             (", ".join(sorted(app_templates_new)), filepath, path_app_templates)
2318         )
2319         print(msg)
2320         self.report({'INFO'}, msg)
2321
2322         return {'FINISHED'}
2323
2324     def invoke(self, context, event):
2325         wm = context.window_manager
2326         wm.fileselect_add(self)
2327         return {'RUNNING_MODAL'}
2328
2329
2330 classes = (
2331     BRUSH_OT_active_index_set,
2332     WM_OT_addon_disable,
2333     WM_OT_addon_enable,
2334     WM_OT_addon_expand,
2335     WM_OT_addon_install,
2336     WM_OT_addon_refresh,
2337     WM_OT_addon_remove,
2338     WM_OT_addon_userpref_show,
2339     WM_OT_app_template_install,
2340     WM_OT_appconfig_activate,
2341     WM_OT_appconfig_default,
2342     WM_OT_blenderplayer_start,
2343     WM_OT_context_collection_boolean_set,
2344     WM_OT_context_cycle_array,
2345     WM_OT_context_cycle_enum,
2346     WM_OT_context_cycle_int,
2347     WM_OT_context_menu_enum,
2348     WM_OT_context_modal_mouse,
2349     WM_OT_context_pie_enum,
2350     WM_OT_context_scale_float,
2351     WM_OT_context_scale_int,
2352     WM_OT_context_set_boolean,
2353     WM_OT_context_set_enum,
2354     WM_OT_context_set_float,
2355     WM_OT_context_set_id,
2356     WM_OT_context_set_int,
2357     WM_OT_context_set_string,
2358     WM_OT_context_set_value,
2359     WM_OT_context_toggle,
2360     WM_OT_context_toggle_enum,
2361     WM_OT_copy_prev_settings,
2362     WM_OT_doc_view,
2363     WM_OT_doc_view_manual,
2364     WM_OT_keyconfig_activate,
2365     WM_OT_keyconfig_export,
2366     WM_OT_keyconfig_import,
2367     WM_OT_keyconfig_remove,
2368     WM_OT_keyconfig_test,
2369     WM_OT_keyitem_add,
2370     WM_OT_keyitem_remove,
2371     WM_OT_keyitem_restore,
2372     WM_OT_keymap_restore,
2373     WM_OT_operator_cheat_sheet,
2374     WM_OT_operator_pie_enum,
2375     WM_OT_path_open,
2376     WM_OT_properties_add,
2377     WM_OT_properties_context_change,
2378     WM_OT_properties_edit,
2379     WM_OT_properties_remove,
2380     WM_OT_sysinfo,
2381     WM_OT_theme_install,
2382     WM_OT_url_open,
2383 )