openc2lib.types.data.version

 1class Version(str):
 2	""" OpenC2 Version
 3
 4		Version of the OpenC2 protocol (Sec. 3.4.2.16). Currently a *<major>.<minor>* format is used.
 5	"""
 6	def __new__(cls, major, minor):
 7		""" Create `Version` instance
 8
 9			Create a Version instance from major and minor numbers, expressed as numbers.
10			:param major: Major number of OpenC2 version.
11			:param minor: Minor number of OpenC2 version.
12			:return: `Version` instance.
13		"""
14		vers = str(major) + '.' + str(minor)
15		instance = super().__new__(cls, vers)
16		return instance
17
18	def __init__(self, major, minor):
19		""" Initialize `Version` instance
20
21			Initialize with major and minor numbers.
22			:param major: Major number of OpenC2 version.
23			:param minor: Minor number of OpenC2 version.
24			:return: `Version` instance.
25		"""
26		self.major = major
27		self.minor = minor
28
29	@staticmethod
30	def fromstr(v):
31		""" Create `Version` instance
32
33			Create `Version` instance from string (in the *<major>.<minor>* notation.
34			:param v: Text string with the Version.
35			:return: `Version` instance.
36		"""
37		vers = v.split('.',2)
38		return Version(vers[0], vers[1])
39	
40	@classmethod
41	def fromdict(cls, vers, e=None):
42		""" Create `Version` instance
43
44			Create `Version` instance from string (in the *<major>.<minor>* notation.
45			This method is provided to deserialize an OpenC2 message according to the openc2lib approach.
46			This method should only be used internally the openc2lib.
47			:param vers: Text string with the Version.
48			:param e: `Encoder` instance to be used (only included to be compliance with the function footprint.
49			:return: `Version` instance.
50		"""
51		return Version.fromstr(vers)