File: menutree.py

package info (click to toggle)
grass 8.4.2-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 277,040 kB
  • sloc: ansic: 460,798; python: 227,732; cpp: 42,026; sh: 11,262; makefile: 7,007; xml: 3,637; sql: 968; lex: 520; javascript: 484; yacc: 450; asm: 387; perl: 157; sed: 25; objc: 6; ruby: 4
file content (291 lines) | stat: -rw-r--r-- 9,227 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
"""
@package core.menutree

@brief Creates tree structure for wxGUI menus (former menudata.py)

Classes:
 - menutree::MenuTreeModelBuilder

Usage:
@code
python menutree.py [action] [menu]
@endcode

where <i>action</i>:
 - strings (default, used for translations)
 - tree (simple tree structure)
 - commands (command names and their place in tree)
 - dump (tree structure with stored data)

and <i>menu</i>:
 - manager (Main menu in Layer Manager)
 - module_tree (Module tree in Layer Manager)
 - modeler (Graphical Modeler)
 - psmap (Cartographic Composer)

(C) 2013 by the GRASS Development Team

This program is free software under the GNU General Public License
(>=v2). Read the file COPYING that comes with GRASS for details.

@author Glynn Clements (menudata.py)
@author Martin Landa <landa.martin gmail.com> (menudata.py)
@author Anna Petrasova <kratochanna gmail.com>
"""

import os
import sys
import copy
import xml.etree.ElementTree as etree

import wx

from core.treemodel import TreeModel, ModuleNode
from core.settings import UserSettings
from core.toolboxes import expandAddons as expAddons
from core.toolboxes import getMessages as getToolboxMessages
from core.toolboxes import clearMessages as clearToolboxMessages
from core.gcmd import GError

if not os.getenv("GISBASE"):
    sys.exit("GRASS is not running. Exiting...")


# TODO: change the system to remove strange derived classes
class MenuTreeModelBuilder:
    """Abstract menu data class"""

    # TODO: message_handler=GError is just for backwards compatibility
    # message_handler=GError should be replaced by None
    def __init__(self, filename, expandAddons=True, message_handler=GError):
        self.menustyle = UserSettings.Get(
            group="appearance", key="menustyle", subkey="selection"
        )

        xmlTree = etree.parse(filename)
        if expandAddons:
            expAddons(xmlTree)
            for message in getToolboxMessages():
                message_handler(message)
            clearToolboxMessages()

        self.model = TreeModel(ModuleNode)
        self._createModel(xmlTree)

    def _createModel(self, xmlTree):
        root = xmlTree.getroot()
        menubar = root.findall("menubar")[0]
        menus = menubar.findall("menu")
        for m in menus:
            self._createMenu(m, self.model.root)

    def _createMenu(self, menu, node):
        label = _(menu.find("label").text)
        items = menu.find("items")
        node = self.model.AppendNode(parent=node, label=label)
        for item in items:
            self._createItem(item, node)

    def _createItem(self, item, node):
        if item.tag == "separator":
            data = dict(
                label="",
                description="",
                handler="",
                command="",
                keywords="",
                shortcut="",
                wxId="",
                icon="",
            )
            self.model.AppendNode(parent=node, label="", data=data)
        elif item.tag == "menuitem":
            origLabel = _(item.find("label").text)
            handler = item.find("handler").text
            desc = item.find("help")  # optional
            gcmd = item.find("command")  # optional
            keywords = item.find("keywords")  # optional
            shortcut = item.find("shortcut")  # optional
            wxId = item.find("id")  # optional
            icon = item.find("icon")  # optional
            if gcmd is not None:
                gcmd = gcmd.text
            else:
                gcmd = ""
            if desc.text:
                desc = _(desc.text)
            else:
                desc = ""
            if keywords is None or keywords.text is None:
                keywords = ""
            else:
                keywords = keywords.text
            if shortcut is not None:
                shortcut = shortcut.text
            else:
                shortcut = ""
            if wxId is not None:
                wxId = eval("wx." + wxId.text)
            else:
                wxId = wx.ID_ANY
            if icon is not None:
                icon = icon.text
            else:
                icon = ""
            label = origLabel
            if gcmd:
                if self.menustyle == 1:
                    label += "   [" + gcmd + "]"
                elif self.menustyle == 2:
                    label = "      [" + gcmd + "]"
            data = dict(
                label=origLabel,
                description=desc,
                handler=handler,
                command=gcmd,
                keywords=keywords,
                shortcut=shortcut,
                wxId=wxId,
                icon=icon,
            )
            self.model.AppendNode(parent=node, label=label, data=data)
        elif item.tag == "menu":
            self._createMenu(item, node)
        else:
            raise ValueError(_("Unknow tag %s") % item.tag)

    def GetModel(self, separators=False):
        """Returns copy of model with or without separators
        (for menu or for search tree).
        """
        if separators:
            return copy.deepcopy(self.model)
        else:
            model = copy.deepcopy(self.model)
            removeSeparators(model)
            return model

    def PrintTree(self, fh):
        for child in self.model.root.children:
            printTree(node=child, fh=fh)

    def PrintStrings(self, fh):
        """Print menu strings to file (used for localization)

        :param fh: file descriptor
        """
        className = self.__class__.__name__
        fh.write("menustrings_%s = [\n" % className)
        for child in self.model.root.children:
            printStrings(child, fh)
        fh.write("    '']\n")

    def PrintCommands(self, fh):
        printCommands(self.model.root, fh, itemSep=" | ", menuSep=" > ")


def removeSeparators(model, node=None):
    if not node:
        node = model.root
    if node.label or node is model.root:
        for child in reversed(node.children):
            removeSeparators(model, child)
    else:
        model.RemoveNode(node)


def printTree(node, fh, indent=0):
    if not node.label:
        return
    text = "%s- %s\n" % (" " * indent, node.label.replace("&", ""))
    fh.write(text)
    for child in node.children:
        printTree(node=child, fh=fh, indent=indent + 2)


def printStrings(node, fh):
    # node.label  - with module in brackets
    # node.data['label'] - without module in brackets
    if node.label and not node.data:
        fh.write("    _(%r),\n" % str(node.label))
    if node.data:
        if "label" in node.data and node.data["label"]:
            fh.write("    _(%r),\n" % str(node.data["label"]))
        if "description" in node.data and node.data["description"]:
            fh.write("    _(%r),\n" % str(node.data["description"]))
    for child in node.children:
        printStrings(node=child, fh=fh)


def printCommands(node, fh, itemSep, menuSep):
    def collectParents(node, parents):
        parent = node.parent
        if parent.parent:
            parents.insert(0, node.parent)
            collectParents(node.parent, parents)

    data = node.data
    if data and "command" in data and data["command"]:
        fh.write("%s%s" % (data["command"], itemSep))
        parents = [node]
        collectParents(node, parents)
        labels = [parent.label.replace("&", "") for parent in parents]
        fh.write(menuSep.join(labels))
        fh.write("\n")

    for child in node.children:
        printCommands(child, fh, itemSep, menuSep)


if __name__ == "__main__":
    action = "strings"
    menu = "manager"

    for arg in sys.argv:
        if arg in ("strings", "tree", "commands", "dump"):
            action = arg
        elif arg in ("manager", "module_tree", "modeler", "psmap"):
            menu = arg

    # FIXME: cross-dependencies
    if menu == "manager":
        from lmgr.menudata import LayerManagerMenuData
        from core.globalvar import WXGUIDIR

        filename = os.path.join(WXGUIDIR, "xml", "menudata.xml")
        menudata = LayerManagerMenuData(filename)
    # FIXME: since module descriptions are used again we have now the third
    # copy of the same string (one is in modules)
    elif menu == "module_tree":
        from lmgr.menudata import LayerManagerModuleTree
        from core.globalvar import WXGUIDIR

        filename = os.path.join(WXGUIDIR, "xml", "module_tree_menudata.xml")
        menudata = LayerManagerModuleTree(filename)
    elif menu == "modeler":
        from gmodeler.menudata import ModelerMenuData

        menudata = ModelerMenuData()
    elif menu == "psmap":
        from psmap.menudata import PsMapMenuData

        menudata = PsMapMenuData()
    else:
        import grass.script.core as gscore

        gscore.fatal("Unknown value for parameter menu: " % menu)

    if action == "strings":
        menudata.PrintStrings(sys.stdout)
    elif action == "tree":
        menudata.PrintTree(sys.stdout)
    elif action == "commands":
        menudata.PrintCommands(sys.stdout)
    elif action == "dump":
        print(menudata.model)
    else:
        import grass.script.core as gscore

        gscore.fatal("Unknown value for parameter action: " % action)

    sys.exit(0)