summaryrefslogtreecommitdiff
path: root/grc/src/platforms/base/Element.py
blob: a16be912797b8f4287aaee53dcbc21f8b22d741b (plain)
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
"""
Copyright 2008 Free Software Foundation, Inc.
This file is part of GNU Radio

GNU Radio Companion 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.

GNU Radio Companion 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
"""

class Element(object):

	def __init__(self, parent=None):
		self._parent = parent
		self._error_messages = []
		self.flag()

	def test(self):
		"""
		Test the element against failures.
		Overload this method in sub-classes.
		"""
		pass

	def validate(self):
		"""
		Validate the data in this element.
		Set the error message non blank for errors.
		Overload this method in sub-classes.
		"""
		pass

	def is_valid(self):
		self._error_messages = []#reset err msgs
		if self.get_enabled():
			try: self.validate()
			except: pass
		return not self.get_error_messages()

	def get_enabled(self): return True

	def _add_error_message(self, msg):
		self._error_messages.append(msg)

	def get_error_messages(self):
		return self._error_messages

	def get_parent(self):
		return self._parent

	def _exit_with_error(self, error):
		parent = self
		#build hier list of elements
		elements = list()
		while(parent):
			elements.insert(0, parent)
			parent = parent.get_parent()
		#build error string
		err_str = ">>> Error:"
		for i, element in enumerate(elements + [error]):
			err_str = err_str + '\n' + ''.join('   '*(i+2)) + str(element)
		err_str = err_str + '\n'
		exit(err_str)

	##############################################
	## Update flagging
	##############################################
	def is_flagged(self): return self._flag
	def flag(self):
		self._flag = True
		if self.get_parent(): self.get_parent().flag()
	def deflag(self):
		self._flag = False
		if self.get_parent(): self.get_parent().deflag()

	##############################################
	## Type testing methods
	##############################################
	def is_element(self): return True
	def is_platform(self): return False
	def is_flow_graph(self): return False
	def is_connection(self): return False
	def is_block(self): return False
	def is_source(self): return False
	def is_sink(self): return False
	def is_port(self): return False
	def is_param(self): return False