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
|
# (C) Copyright 2007-2023 Enthought, Inc., Austin, TX
# All rights reserved.
#
# This software is provided without warranty under the terms of the BSD
# license included in LICENSE.txt and may be redistributed only under
# the conditions described in the aforementioned license. The license
# is also available online at http://www.enthought.com/licenses/BSD.txt
#
# Thanks for using Enthought open source!
# ------------------------------------------------------------------------------
# Copyright (c) 2007, Riverbank Computing Limited
# All rights reserved.
#
# This software is provided without warranty under the terms of the BSD
# license included in enthought/LICENSE.txt and may be redistributed only
# under the conditions described in the aforementioned license. The license
# is also available online at http://www.enthought.com/licenses/BSD.txt
# Thanks for using Enthought open source!
#
# Author: Riverbank Computing Limited
# Description: <Enthought undo package component>
# ------------------------------------------------------------------------------
# Enthought library imports.
from traits.api import Any, HasTraits, Str, provides
# Local imports.
from .i_command import ICommand
@provides(ICommand)
class AbstractCommand(HasTraits):
"""The AbstractCommand class is an abstract base class that implements the
ICommand interface.
"""
#### 'ICommand' interface #################################################
#: This is the data on which the command operates.
data = Any()
#: This is the name of the command as it will appear in any GUI element. It
#: may include '&' which will be automatically removed whenever it is
#: inappropriate.
name = Str()
###########################################################################
# 'ICommand' interface.
###########################################################################
def do(self):
"""This is called by the command stack to do the command and to return
any value. The command must save any state necessary for the 'redo()'
and 'undo()' methods to work. The class's __init__() must also ensure
that deep copies of any arguments are made if appropriate. It is
guaranteed that this will only ever be called once and that it will be
called before any call to 'redo()' or 'undo()'.
"""
raise NotImplementedError
def merge(self, other):
"""This is called by the command stack to try and merge another
command with this one. True is returned if the commands were merged.
'other' is the command that is about to be executed. If the commands
are merged then 'other' will discarded and not placed on the command
stack. A subsequent undo or redo of this modified command must have
the same effect as the two original commands.
"""
# By default merges never happen.
return False
def redo(self):
"""This is called by the command stack to redo the command. Any
returned value will replace the value that the command stack references
from the original call to 'do()' or previous call to 'redo()'.
"""
raise NotImplementedError
def undo(self):
""" This is called by the command stack to undo the command. """
raise NotImplementedError
|
