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
|
# -*- coding: utf-8 -*-
#
# AWL simulator - Instance write protection
#
# Copyright 2015 Michael Buesch <m@bues.ch>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License along
# with this program; if not, write to the Free Software Foundation, Inc.,
# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
#
from __future__ import division, absolute_import, print_function, unicode_literals
#from awlsim.common.cython_support cimport * #@cy
from awlsim.common.compat import *
__all__ = [
"OptionalImmutable",
]
__useDummy = False
if isMicroPython: #@nocov
__useDummy = True
if __useDummy: #@nocov
class OptionalImmutable(object):
"""Optional instance write protection.
Dummy implementation.
"""
_immutable = False
def isImmutable(self):
return self._immutable
def setImmutable(self):
self._immutable = True
else:
class OptionalImmutable(object):
"""Optional instance write protection.
By default, instances are not write protected (not immutable).
If setImmutable() is called, assignment to instance attributes
and deletion of attributes is restricted.
This cannot be reverted.
Subclass this class to use this mechanism."""
__slots__ = (
"_immutable",
)
def __new__(cls, *args, **kwargs):
self = super(OptionalImmutable, cls).__new__(cls)
super(OptionalImmutable, self).__setattr__("_immutable", False)
return self
def isImmutable(self):
"""Returns True, if self is immutable."""
return self._immutable
def setImmutable(self):
"""Make self immutable. This is not reversible."""
self._immutable = True
def __setattr__(self, name, value):
if self._immutable: #@nocov
raise AttributeError("Assignment to '%s' "
"of immutable %s." %\
(name, str(type(self))))
super(OptionalImmutable, self).__setattr__(name, value)
def __delattr__(self, name):
if self._immutable: #@nocov
raise AttributeError("Deletion of '%s' "
"from immutable %s." %\
(name, str(type(self))))
super(OptionalImmutable, self).__delattr__(name)
|