File: Extension.py

package info (click to toggle)
uranium 5.0.0-7
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 5,304 kB
  • sloc: python: 31,765; sh: 132; makefile: 12
file content (58 lines) | stat: -rw-r--r-- 1,675 bytes parent folder | download | duplicates (3)
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
# Copyright (c) 2020 Ultimaker B.V.
# Uranium is released under the terms of the LGPLv3 or higher.

from UM.PluginObject import PluginObject
import collections
from typing import Optional, Any, Callable, List, Dict


class Extension(PluginObject):
    """Base class for plugins that extend the functionality of Uranium.

    Every extension adds a (sub) menu to the extension menu with one or
    more menu items.
    """

    def __init__(self) -> None:
        super().__init__()
        self._menu_function_dict = collections.OrderedDict()  # type: Dict[str, Callable[[], Any]]
        self._menu_name = None  # type: Optional[str]

    def addMenuItem(self, name: str, function: Callable[[], Any]) -> None:
        """Add an item to the sub-menu of the extension

        :param name: :type{string}
        :param function: :type{function}
        """

        self._menu_function_dict[name] = function

    def setMenuName(self, name: str) -> None:
        """Set name of the menu where all menu items are placed in

        :param name: :type{string}
        """

        self._menu_name = name

    def getMenuName(self) -> Optional[str]:
        """Get the name of the menu where all menu items are placed in"""

        return self._menu_name

    def activateMenuItem(self, name: str) -> None:
        """Call function associated with option

        :param name: :type{string}
        """

        if name in self._menu_function_dict:
            self._menu_function_dict[name]()

    def getMenuItemList(self) -> List[str]:
        """Get list of all menu item names

        :return: :type{list}
        """

        return list(self._menu_function_dict.keys())