aboutsummaryrefslogtreecommitdiffstats
path: root/awlsim/core/instructions/parentinfo.py
blob: 0660157cd7080428d1b928ccccfde64af3796dc8 (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
97
98
99
100
101
# -*- coding: utf-8 -*-
#
# AWL simulator - Instruction parent information
#
# Copyright 2017 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 *

from awlsim.common.util import *
from awlsim.common.exceptions import *
from awlsim.common.enumeration import *


__all__ = [
	"AwlInsnParentInfo",
]


class AwlInsnParentInfo(object):
	"""Instruction parent information.
	The compiler (AWL, FUP, KOP) may place information about the
	source of the instruction and its generation here.
	"""

	__slots__ = (
		"uuid",
		"rawInsn",
		"connType",
		"connIndex",
	)

	# Connection types
	EnumGen.start
	CONNTYPE_NONE	= EnumGen.item # Unknown or none
	CONNTYPE_IN	= EnumGen.item # Input connection
	CONNTYPE_OUT	= EnumGen.item # Output connection
	CONNTYPE_INOUT	= EnumGen.item # In/Out connection
	EnumGen.end

	def __init__(self,
		     uuid=None,
		     rawInsn=None,
		     connType=CONNTYPE_NONE,
		     connIndex=-1):
		"""Construct parent information.
		All information is optional.
		uuid: The UUID string of the parent object.
		rawInsn: A reference to the raw AWL instruction.
		connType: The "connection type" of the parent object this
		          instruction belongs to.
		connIndex: The "connection index" of the parent object this
		           instruction belongs to.
		"""
		self.uuid = uuid
		self.rawInsn = rawInsn
		self.connType = connType
		self.connIndex = connIndex

	def __bool__(self):
		return bool(self.uuid or\
			    self.rawInsn or\
			    self.connType != self.CONNTYPE_NONE or\
			    self.connIndex >= 0)

	__nonzero__ = __bool__ # Python 2 compat

	def __str__(self):
		fields = []
		if self.uuid:
			fields.append(shortUUID(self.uuid))
		if self.rawInsn:
			fields.append(str(self.rawInsn))
		if self.connType != self.CONNTYPE_NONE:
			connTypeStr = {
				self.CONNTYPE_IN	: "IN",
				self.CONNTYPE_OUT	: "OUT",
				self.CONNTYPE_INOUT	: "IN_OUT",
			}[self.connType]
			if self.connIndex >= 0:
				fields.append("%s-%d" % (connTypeStr,
							 self.connIndex))
			else:
				fields.append(connTypeStr)
		return "parent=(%s)" % ", ".join(fields)
bues.ch cgit interface