i18n: fake_gettext is no longer needed for python
[blender.git] / release / scripts / startup / bl_ui / space_userpref_keymap.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 import bpy
21 from bpy.types import Menu, Operator, OperatorProperties
22 import os
23 from blf import gettext as _
24
25
26 KM_HIERARCHY = [
27     ('Window', 'EMPTY', 'WINDOW', []),  # file save, window change, exit
28     ('Screen', 'EMPTY', 'WINDOW', [     # full screen, undo, screenshot
29         ('Screen Editing', 'EMPTY', 'WINDOW', []),    # resizing, action corners
30         ]),
31
32     ('View2D', 'EMPTY', 'WINDOW', []),    # view 2d navigation (per region)
33     ('View2D Buttons List', 'EMPTY', 'WINDOW', []),  # view 2d with buttons navigation
34     ('Header', 'EMPTY', 'WINDOW', []),    # header stuff (per region)
35     ('Grease Pencil', 'EMPTY', 'WINDOW', []),  # grease pencil stuff (per region)
36
37     ('3D View', 'VIEW_3D', 'WINDOW', [  # view 3d navigation and generic stuff (select, transform)
38         ('Object Mode', 'EMPTY', 'WINDOW', []),
39         ('Mesh', 'EMPTY', 'WINDOW', []),
40         ('Curve', 'EMPTY', 'WINDOW', []),
41         ('Armature', 'EMPTY', 'WINDOW', []),
42         ('Metaball', 'EMPTY', 'WINDOW', []),
43         ('Lattice', 'EMPTY', 'WINDOW', []),
44         ('Font', 'EMPTY', 'WINDOW', []),
45
46         ('Pose', 'EMPTY', 'WINDOW', []),
47
48         ('Vertex Paint', 'EMPTY', 'WINDOW', []),
49         ('Weight Paint', 'EMPTY', 'WINDOW', []),
50         ('Face Mask', 'EMPTY', 'WINDOW', []),
51         ('Image Paint', 'EMPTY', 'WINDOW', []),  # image and view3d
52         ('Sculpt', 'EMPTY', 'WINDOW', []),
53
54         ('Armature Sketch', 'EMPTY', 'WINDOW', []),
55         ('Particle', 'EMPTY', 'WINDOW', []),
56
57         ('Object Non-modal', 'EMPTY', 'WINDOW', []),  # mode change
58
59         ('3D View Generic', 'VIEW_3D', 'WINDOW', [])    # toolbar and properties
60         ]),
61
62     ('Frames', 'EMPTY', 'WINDOW', []),    # frame navigation (per region)
63     ('Markers', 'EMPTY', 'WINDOW', []),    # markers (per region)
64     ('Animation', 'EMPTY', 'WINDOW', []),    # frame change on click, preview range (per region)
65     ('Animation Channels', 'EMPTY', 'WINDOW', []),
66     ('Graph Editor', 'GRAPH_EDITOR', 'WINDOW', [
67         ('Graph Editor Generic', 'GRAPH_EDITOR', 'WINDOW', [])
68         ]),
69     ('Dopesheet', 'DOPESHEET_EDITOR', 'WINDOW', []),
70     ('NLA Editor', 'NLA_EDITOR', 'WINDOW', [
71         ('NLA Channels', 'NLA_EDITOR', 'WINDOW', []),
72         ('NLA Generic', 'NLA_EDITOR', 'WINDOW', [])
73         ]),
74
75     ('Image', 'IMAGE_EDITOR', 'WINDOW', [
76         ('UV Editor', 'EMPTY', 'WINDOW', []),  # image (reverse order, UVEdit before Image
77         ('Image Paint', 'EMPTY', 'WINDOW', []),  # image and view3d
78         ('Image Generic', 'IMAGE_EDITOR', 'WINDOW', [])
79         ]),
80
81     ('Timeline', 'TIMELINE', 'WINDOW', []),
82     ('Outliner', 'OUTLINER', 'WINDOW', []),
83
84     ('Node Editor', 'NODE_EDITOR', 'WINDOW', [
85         ('Node Generic', 'NODE_EDITOR', 'WINDOW', [])
86         ]),
87     ('Sequencer', 'SEQUENCE_EDITOR', 'WINDOW', []),
88     ('Logic Editor', 'LOGIC_EDITOR', 'WINDOW', []),
89
90     ('File Browser', 'FILE_BROWSER', 'WINDOW', [
91         ('File Browser Main', 'FILE_BROWSER', 'WINDOW', []),
92         ('File Browser Buttons', 'FILE_BROWSER', 'WINDOW', [])
93         ]),
94
95     ('Property Editor', 'PROPERTIES', 'WINDOW', []),  # align context menu
96
97     ('Script', 'SCRIPTS_WINDOW', 'WINDOW', []),
98     ('Text', 'TEXT_EDITOR', 'WINDOW', []),
99     ('Console', 'CONSOLE', 'WINDOW', []),
100
101     ('View3D Gesture Circle', 'EMPTY', 'WINDOW', []),
102     ('Gesture Border', 'EMPTY', 'WINDOW', []),
103     ('Standard Modal Map', 'EMPTY', 'WINDOW', []),
104     ('Transform Modal Map', 'EMPTY', 'WINDOW', []),
105     ('View3D Fly Modal', 'EMPTY', 'WINDOW', []),
106     ('View3D Rotate Modal', 'EMPTY', 'WINDOW', []),
107     ('View3D Move Modal', 'EMPTY', 'WINDOW', []),
108     ('View3D Zoom Modal', 'EMPTY', 'WINDOW', []),
109     ]
110
111
112 def _km_exists_in(km, export_keymaps):
113     for km2, kc in export_keymaps:
114         if km2.name == km.name:
115             return True
116     return False
117
118
119 def _merge_keymaps(kc1, kc2):
120     """ note: kc1 takes priority over kc2
121     """
122     merged_keymaps = [(km, kc1) for km in kc1.keymaps]
123     if kc1 != kc2:
124         merged_keymaps.extend((km, kc2) for km in kc2.keymaps if not _km_exists_in(km, merged_keymaps))
125
126     return merged_keymaps
127
128
129 class USERPREF_MT_keyconfigs(Menu):
130     bl_label = "KeyPresets"
131     preset_subdir = "keyconfig"
132     preset_operator = "wm.keyconfig_activate"
133
134     def draw(self, context):
135         props = self.layout.operator("wm.context_set_value", text=_("Blender (default)"))
136         props.data_path = "window_manager.keyconfigs.active"
137         props.value = "context.window_manager.keyconfigs.default"
138
139         # now draw the presets
140         Menu.draw_preset(self, context)
141
142
143 class InputKeyMapPanel:
144     bl_space_type = 'USER_PREFERENCES'
145     bl_label = "Input"
146     bl_region_type = 'WINDOW'
147     bl_options = {'HIDE_HEADER'}
148
149     def draw_entry(self, display_keymaps, entry, col, level=0):
150         idname, spaceid, regionid, children = entry
151
152         for km, kc in display_keymaps:
153             if km.name == idname and km.space_type == spaceid and km.region_type == regionid:
154                 self.draw_km(display_keymaps, kc, km, children, col, level)
155
156         '''
157         km = kc.keymaps.find(idname, space_type=spaceid, region_type=regionid)
158         if not km:
159             kc = defkc
160             km = kc.keymaps.find(idname, space_type=spaceid, region_type=regionid)
161
162         if km:
163             self.draw_km(kc, km, children, col, level)
164         '''
165
166     def indented_layout(self, layout, level):
167         indentpx = 16
168         if level == 0:
169             level = 0.0001   # Tweak so that a percentage of 0 won't split by half
170         indent = level * indentpx / bpy.context.region.width
171
172         split = layout.split(percentage=indent)
173         col = split.column()
174         col = split.column()
175         return col
176
177     def draw_km(self, display_keymaps, kc, km, children, layout, level):
178         km = km.active()
179
180         layout.context_pointer_set("keymap", km)
181
182         col = self.indented_layout(layout, level)
183
184         row = col.row()
185         row.prop(km, "show_expanded_children", text="", emboss=False)
186         row.label(text=_(km.name))
187
188         row.label()
189         row.label()
190
191         if km.is_modal:
192             row.label(text="", icon='LINKED')
193         if km.is_user_modified:
194             row.operator("wm.keymap_restore", text=_("Restore"))
195         else:
196             row.label()
197
198         if km.show_expanded_children:
199             if children:
200                 # Put the Parent key map's entries in a 'global' sub-category
201                 # equal in hierarchy to the other children categories
202                 subcol = self.indented_layout(col, level + 1)
203                 subrow = subcol.row()
204                 subrow.prop(km, "show_expanded_items", text="", emboss=False)
205                 subrow.label(text="%s " % _(km.name) + _("(Global)") )
206             else:
207                 km.show_expanded_items = True
208
209             # Key Map items
210             if km.show_expanded_items:
211                 for kmi in km.keymap_items:
212                     self.draw_kmi(display_keymaps, kc, km, kmi, col, level + 1)
213
214                 # "Add New" at end of keymap item list
215                 col = self.indented_layout(col, level + 1)
216                 subcol = col.split(percentage=0.2).column()
217                 subcol.operator("wm.keyitem_add", text=_("Add New"), icon='ZOOMIN')
218
219             col.separator()
220
221             # Child key maps
222             if children:
223                 subcol = col.column()
224                 row = subcol.row()
225
226                 for entry in children:
227                     self.draw_entry(display_keymaps, entry, col, level + 1)
228
229     @staticmethod
230     def draw_kmi_properties(box, properties, title=None):
231         box.separator()
232         if title:
233             box.label(text=title)
234         flow = box.column_flow(columns=2)
235         for pname, value in properties.bl_rna.properties.items():
236             if pname != "rna_type" and not properties.is_property_hidden(pname):
237                 if isinstance(value, OperatorProperties):
238                     InputKeyMapPanel.draw_kmi_properties(box, value, title=pname)
239                 else:
240                     flow.prop(properties, pname)
241
242     def draw_kmi(self, display_keymaps, kc, km, kmi, layout, level):
243         map_type = kmi.map_type
244
245         col = self.indented_layout(layout, level)
246
247         if kmi.show_expanded:
248             col = col.column(align=True)
249             box = col.box()
250         else:
251             box = col.column()
252
253         split = box.split(percentage=0.05)
254
255         # header bar
256         row = split.row()
257         row.prop(kmi, "show_expanded", text="", emboss=False)
258
259         row = split.row()
260         row.prop(kmi, "active", text="", emboss=False)
261
262         if km.is_modal:
263             row.prop(kmi, "propvalue", text="")
264         else:
265             row.label(text=_(kmi.name))
266
267         row = split.row()
268         row.prop(kmi, "map_type", text="")
269         if map_type == 'KEYBOARD':
270             row.prop(kmi, "type", text="", full_event=True)
271         elif map_type == 'MOUSE':
272             row.prop(kmi, "type", text="", full_event=True)
273         elif map_type == 'NDOF':
274             row.prop(kmi, "type", text="", full_event=True)
275         elif map_type == 'TWEAK':
276             subrow = row.row()
277             subrow.prop(kmi, "type", text="")
278             subrow.prop(kmi, "value", text="")
279         elif map_type == 'TIMER':
280             row.prop(kmi, "type", text="")
281         else:
282             row.label()
283
284         if (not kmi.is_user_defined) and kmi.is_user_modified:
285             op = row.operator("wm.keyitem_restore", text="", icon='BACK')
286             op.item_id = kmi.id
287         else:
288             op = row.operator("wm.keyitem_remove", text="", icon='X')
289             op.item_id = kmi.id
290
291         # Expanded, additional event settings
292         if kmi.show_expanded:
293             box = col.box()
294
295             if map_type not in {'TEXTINPUT', 'TIMER'}:
296                 split = box.split(percentage=0.4)
297                 sub = split.row()
298
299                 if km.is_modal:
300                     sub.prop(kmi, "propvalue", text="")
301                 else:
302                     # One day...
303                     # sub.prop_search(kmi, "idname", bpy.context.window_manager, "operators_all", text="")
304                     sub.prop(kmi, "idname", text="")
305
306                 sub = split.column()
307                 subrow = sub.row(align=True)
308
309                 if map_type in {'KEYBOARD', 'NDOF'}:
310                     subrow.prop(kmi, "type", text="", event=True)
311                     subrow.prop(kmi, "value", text="")
312                 elif map_type == 'MOUSE':
313                     subrow.prop(kmi, "type", text="")
314                     subrow.prop(kmi, "value", text="")
315
316                 subrow = sub.row()
317                 subrow.scale_x = 0.75
318                 subrow.prop(kmi, "any")
319                 subrow.prop(kmi, "shift")
320                 subrow.prop(kmi, "ctrl")
321                 subrow.prop(kmi, "alt")
322                 subrow.prop(kmi, "oskey", text="Cmd")
323                 subrow.prop(kmi, "key_modifier", text="", event=True)
324
325             # Operator properties
326             props = kmi.properties
327             if props is not None:
328                 InputKeyMapPanel.draw_kmi_properties(box, props)
329
330             # Modal key maps attached to this operator
331             if not km.is_modal:
332                 kmm = kc.keymaps.find_modal(kmi.idname)
333                 if kmm:
334                     self.draw_km(display_keymaps, kc, kmm, None, layout, level + 1)
335                     layout.context_pointer_set("keymap", km)
336
337     def draw_filtered(self, display_keymaps, filter_text, layout):
338         for km, kc in display_keymaps:
339             km = km.active()
340             layout.context_pointer_set("keymap", km)
341
342             filtered_items = [kmi for kmi in km.keymap_items if filter_text in kmi.name.lower()]
343
344             if len(filtered_items) != 0:
345                 col = layout.column()
346
347                 row = col.row()
348                 row.label(text=km.name, icon="DOT")
349
350                 row.label()
351                 row.label()
352
353                 if km.is_user_modified:
354                     row.operator("wm.keymap_restore", text=_("Restore"))
355                 else:
356                     row.label()
357
358                 for kmi in filtered_items:
359                     self.draw_kmi(display_keymaps, kc, km, kmi, col, 1)
360
361                 # "Add New" at end of keymap item list
362                 col = self.indented_layout(layout, 1)
363                 subcol = col.split(percentage=0.2).column()
364                 subcol.operator("wm.keyitem_add", text=_("Add New"), icon='ZOOMIN')
365
366     def draw_hierarchy(self, display_keymaps, layout):
367         for entry in KM_HIERARCHY:
368             self.draw_entry(display_keymaps, entry, layout)
369
370     def draw_keymaps(self, context, layout):
371         wm = context.window_manager
372         kc = wm.keyconfigs.user
373
374         col = layout.column()
375         sub = col.column()
376
377         subsplit = sub.split()
378         subcol = subsplit.column()
379
380         row = subcol.row(align=True)
381
382         #row.prop_search(wm.keyconfigs, "active", wm, "keyconfigs", text="Key Config:")
383         text = bpy.path.display_name(context.window_manager.keyconfigs.active.name)
384         if not text:
385             text = _("Blender (default)")
386         row.menu("USERPREF_MT_keyconfigs", text=text)
387         row.operator("wm.keyconfig_preset_add", text="", icon="ZOOMIN")
388         row.operator("wm.keyconfig_preset_add", text="", icon="ZOOMOUT").remove_active = True
389
390 #        layout.context_pointer_set("keyconfig", wm.keyconfigs.active)
391 #        row.operator("wm.keyconfig_remove", text="", icon='X')
392
393         row.prop(context.space_data, "filter_text", icon="VIEWZOOM")
394
395         col.separator()
396
397         display_keymaps = _merge_keymaps(kc, kc)
398         if context.space_data.filter_text != "":
399             filter_text = context.space_data.filter_text.lower()
400             self.draw_filtered(display_keymaps, filter_text, col)
401         else:
402             self.draw_hierarchy(display_keymaps, col)
403
404
405 from bpy.props import StringProperty, BoolProperty, IntProperty
406
407
408 def export_properties(prefix, properties, lines=None):
409     if lines is None:
410         lines = []
411
412     for pname in properties.bl_rna.properties.keys():
413         if pname != "rna_type" and not properties.is_property_hidden(pname):
414             value = getattr(properties, pname)
415             if isinstance(value, OperatorProperties):
416                 export_properties(prefix + "." + pname, value, lines)
417             elif properties.is_property_set(pname):
418                 value = _string_value(value)
419                 if value != "":
420                     lines.append("%s.%s = %s\n" % (prefix, pname, value))
421     return lines
422
423
424 class WM_OT_keyconfig_test(Operator):
425     "Test keyconfig for conflicts"
426     bl_idname = "wm.keyconfig_test"
427     bl_label = _("Test Key Configuration for Conflicts")
428
429     def testEntry(self, kc, entry, src=None, parent=None):
430         result = False
431
432         def kmistr(kmi):
433             if km.is_modal:
434                 s = ["kmi = km.keymap_items.new_modal(\'%s\', \'%s\', \'%s\'" % (kmi.propvalue, kmi.type, kmi.value)]
435             else:
436                 s = ["kmi = km.keymap_items.new(\'%s\', \'%s\', \'%s\'" % (kmi.idname, kmi.type, kmi.value)]
437
438             if kmi.any:
439                 s.append(", any=True")
440             else:
441                 if kmi.shift:
442                     s.append(", shift=True")
443                 if kmi.ctrl:
444                     s.append(", ctrl=True")
445                 if kmi.alt:
446                     s.append(", alt=True")
447                 if kmi.oskey:
448                     s.append(", oskey=True")
449             if kmi.key_modifier and kmi.key_modifier != 'NONE':
450                 s.append(", key_modifier=\'%s\'" % kmi.key_modifier)
451
452             s.append(")\n")
453
454             props = kmi.properties
455
456             if props is not None:
457                 export_properties("kmi.properties", props, s)
458
459             return "".join(s).strip()
460
461         idname, spaceid, regionid, children = entry
462
463         km = kc.keymaps.find(idname, space_type=spaceid, region_type=regionid)
464
465         if km:
466             km = km.active()
467
468             if src:
469                 for item in km.keymap_items:
470                     if src.compare(item):
471                         print("===========")
472                         print(parent.name)
473                         print(kmistr(src))
474                         print(km.name)
475                         print(kmistr(item))
476                         result = True
477
478                 for child in children:
479                     if self.testEntry(kc, child, src, parent):
480                         result = True
481             else:
482                 for i in range(len(km.keymap_items)):
483                     src = km.keymap_items[i]
484
485                     for child in children:
486                         if self.testEntry(kc, child, src, km):
487                             result = True
488
489                     for j in range(len(km.keymap_items) - i - 1):
490                         item = km.keymap_items[j + i + 1]
491                         if src.compare(item):
492                             print("===========")
493                             print(km.name)
494                             print(kmistr(src))
495                             print(kmistr(item))
496                             result = True
497
498                 for child in children:
499                     if self.testEntry(kc, child):
500                         result = True
501
502         return result
503
504     def testConfig(self, kc):
505         result = False
506         for entry in KM_HIERARCHY:
507             if self.testEntry(kc, entry):
508                 result = True
509         return result
510
511     def execute(self, context):
512         wm = context.window_manager
513         kc = wm.keyconfigs.default
514
515         if self.testConfig(kc):
516             print("CONFLICT")
517
518         return {'FINISHED'}
519
520
521 def _string_value(value):
522     if isinstance(value, str) or isinstance(value, bool) or isinstance(value, float) or isinstance(value, int):
523         result = repr(value)
524     elif getattr(value, '__len__', False):
525         return repr(list(value))
526     else:
527         print("Export key configuration: can't write ", value)
528
529     return result
530
531
532 class WM_OT_keyconfig_import(Operator):
533     "Import key configuration from a python script"
534     bl_idname = "wm.keyconfig_import"
535     bl_label = "Import Key Configuration..."
536
537     filepath = StringProperty(
538             name="File Path",
539             description="Filepath to write file to",
540             default="keymap.py",
541             )
542     filter_folder = BoolProperty(
543             name="Filter folders",
544             default=True,
545             options={'HIDDEN'},
546             )
547     filter_text = BoolProperty(
548             name="Filter text",
549             default=True,
550             options={'HIDDEN'},
551             )
552     filter_python = BoolProperty(
553             name="Filter python",
554             default=True,
555             options={'HIDDEN'},
556             )
557     keep_original = BoolProperty(
558             name="Keep original",
559             description="Keep original file after copying to configuration folder",
560             default=True,
561             )
562
563     def execute(self, context):
564         from os.path import basename
565         import shutil
566
567         if not self.filepath:
568             self.report({'ERROR'}, "Filepath not set")
569             return {'CANCELLED'}
570
571         config_name = basename(self.filepath)
572
573         path = bpy.utils.user_resource('SCRIPTS', os.path.join("presets", "keyconfig"), create=True)
574         path = os.path.join(path, config_name)
575
576         try:
577             if self.keep_original:
578                 shutil.copy(self.filepath, path)
579             else:
580                 shutil.move(self.filepath, path)
581         except Exception as e:
582             self.report({'ERROR'}, "Installing keymap failed: %s" % e)
583             return {'CANCELLED'}
584
585         # sneaky way to check we're actually running the code.
586         bpy.utils.keyconfig_set(path)
587
588         return {'FINISHED'}
589
590     def invoke(self, context, event):
591         wm = context.window_manager
592         wm.fileselect_add(self)
593         return {'RUNNING_MODAL'}
594
595 # This operator is also used by interaction presets saving - AddPresetBase
596
597
598 class WM_OT_keyconfig_export(Operator):
599     "Export key configuration to a python script"
600     bl_idname = "wm.keyconfig_export"
601     bl_label = _("Export Key Configuration...")
602
603     filepath = StringProperty(
604             name="File Path",
605             description="Filepath to write file to",
606             default="keymap.py",
607             )
608     filter_folder = BoolProperty(
609             name="Filter folders",
610             default=True,
611             options={'HIDDEN'},
612             )
613     filter_text = BoolProperty(
614             name="Filter text",
615             default=True,
616             options={'HIDDEN'},
617             )
618     filter_python = BoolProperty(
619             name="Filter python",
620             default=True,
621             options={'HIDDEN'},
622             )
623
624     def execute(self, context):
625         if not self.filepath:
626             raise Exception("Filepath not set")
627
628         if not self.filepath.endswith('.py'):
629             self.filepath += '.py'
630
631         f = open(self.filepath, "w")
632         if not f:
633             raise Exception("Could not open file")
634
635         wm = context.window_manager
636         kc = wm.keyconfigs.active
637
638         f.write("import bpy\n")
639         f.write("import os\n\n")
640         f.write("wm = bpy.context.window_manager\n")
641         f.write("kc = wm.keyconfigs.new(os.path.splitext(os.path.basename(__file__))[0])\n\n")  # keymap must be created by caller
642
643         # Generate a list of keymaps to export:
644         #
645         # First add all user_modified keymaps (found in keyconfigs.user.keymaps list),
646         # then add all remaining keymaps from the currently active custom keyconfig.
647         #
648         # This will create a final list of keymaps that can be used as a 'diff' against
649         # the default blender keyconfig, recreating the current setup from a fresh blender
650         # without needing to export keymaps which haven't been edited.
651
652         class FakeKeyConfig():
653             keymaps = []
654         edited_kc = FakeKeyConfig()
655         for km in wm.keyconfigs.user.keymaps:
656             if km.is_user_modified:
657                 edited_kc.keymaps.append(km)
658         # merge edited keymaps with non-default keyconfig, if it exists
659         if kc != wm.keyconfigs.default:
660             export_keymaps = _merge_keymaps(edited_kc, kc)
661         else:
662             export_keymaps = _merge_keymaps(edited_kc, edited_kc)
663
664         for km, kc_x in export_keymaps:
665
666             km = km.active()
667
668             f.write("# Map %s\n" % km.name)
669             f.write("km = kc.keymaps.new('%s', space_type='%s', region_type='%s', modal=%s)\n\n" % (km.name, km.space_type, km.region_type, km.is_modal))
670             for kmi in km.keymap_items:
671                 if km.is_modal:
672                     f.write("kmi = km.keymap_items.new_modal('%s', '%s', '%s'" % (kmi.propvalue, kmi.type, kmi.value))
673                 else:
674                     f.write("kmi = km.keymap_items.new('%s', '%s', '%s'" % (kmi.idname, kmi.type, kmi.value))
675                 if kmi.any:
676                     f.write(", any=True")
677                 else:
678                     if kmi.shift:
679                         f.write(", shift=True")
680                     if kmi.ctrl:
681                         f.write(", ctrl=True")
682                     if kmi.alt:
683                         f.write(", alt=True")
684                     if kmi.oskey:
685                         f.write(", oskey=True")
686                 if kmi.key_modifier and kmi.key_modifier != 'NONE':
687                     f.write(", key_modifier='%s'" % kmi.key_modifier)
688                 f.write(")\n")
689
690                 props = kmi.properties
691
692                 if props is not None:
693                     f.write("".join(export_properties("kmi.properties", props)))
694
695             f.write("\n")
696
697         f.close()
698
699         return {'FINISHED'}
700
701     def invoke(self, context, event):
702         wm = context.window_manager
703         wm.fileselect_add(self)
704         return {'RUNNING_MODAL'}
705
706
707 class WM_OT_keymap_restore(Operator):
708     "Restore key map(s)"
709     bl_idname = "wm.keymap_restore"
710     bl_label = "Restore Key Map(s)"
711
712     all = BoolProperty(
713             name="All Keymaps",
714             description="Restore all keymaps to default",
715             )
716
717     def execute(self, context):
718         wm = context.window_manager
719
720         if self.all:
721             for km in wm.keyconfigs.user.keymaps:
722                 km.restore_to_default()
723         else:
724             km = context.keymap
725             km.restore_to_default()
726
727         return {'FINISHED'}
728
729
730 class WM_OT_keyitem_restore(Operator):
731     "Restore key map item"
732     bl_idname = "wm.keyitem_restore"
733     bl_label = "Restore Key Map Item"
734
735     item_id = IntProperty(
736             name="Item Identifier",
737             description="Identifier of the item to remove",
738             )
739
740     @classmethod
741     def poll(cls, context):
742         keymap = getattr(context, "keymap", None)
743         return keymap
744
745     def execute(self, context):
746         km = context.keymap
747         kmi = km.keymap_items.from_id(self.item_id)
748
749         if (not kmi.is_user_defined) and kmi.is_user_modified:
750             km.restore_item_to_default(kmi)
751
752         return {'FINISHED'}
753
754
755 class WM_OT_keyitem_add(Operator):
756     "Add key map item"
757     bl_idname = "wm.keyitem_add"
758     bl_label = "Add Key Map Item"
759
760     def execute(self, context):
761         km = context.keymap
762
763         if km.is_modal:
764             km.keymap_items.new_modal("", 'A', 'PRESS')  # kmi
765         else:
766             km.keymap_items.new("none", 'A', 'PRESS')  # kmi
767
768         # clear filter and expand keymap so we can see the newly added item
769         if context.space_data.filter_text != "":
770             context.space_data.filter_text = ""
771             km.show_expanded_items = True
772             km.show_expanded_children = True
773
774         return {'FINISHED'}
775
776
777 class WM_OT_keyitem_remove(Operator):
778     "Remove key map item"
779     bl_idname = "wm.keyitem_remove"
780     bl_label = "Remove Key Map Item"
781
782     item_id = IntProperty(
783             name="Item Identifier",
784             description="Identifier of the item to remove",
785             )
786
787     @classmethod
788     def poll(cls, context):
789         return hasattr(context, "keymap")
790
791     def execute(self, context):
792         km = context.keymap
793         kmi = km.keymap_items.from_id(self.item_id)
794         km.keymap_items.remove(kmi)
795         return {'FINISHED'}
796
797
798 class WM_OT_keyconfig_remove(Operator):
799     "Remove key config"
800     bl_idname = "wm.keyconfig_remove"
801     bl_label = "Remove Key Config"
802
803     @classmethod
804     def poll(cls, context):
805         wm = context.window_manager
806         keyconf = wm.keyconfigs.active
807         return keyconf and keyconf.is_user_defined
808
809     def execute(self, context):
810         wm = context.window_manager
811         keyconfig = wm.keyconfigs.active
812         wm.keyconfigs.remove(keyconfig)
813         return {'FINISHED'}
814
815 if __name__ == "__main__":  # only for live edit.
816     bpy.utils.register_module(__name__)