2018-11-28 22:51:00 +01:00
|
|
|
"""STIX 2.1 Bundle Representation."""
|
|
|
|
|
2018-06-14 02:09:07 +02:00
|
|
|
from collections import OrderedDict
|
|
|
|
|
2018-06-26 18:23:53 +02:00
|
|
|
from ..base import _STIXBase
|
2018-07-13 17:10:05 +02:00
|
|
|
from ..properties import (
|
|
|
|
IDProperty, ListProperty, STIXObjectProperty, TypeProperty,
|
|
|
|
)
|
2018-06-14 02:09:07 +02:00
|
|
|
|
|
|
|
|
|
|
|
class Bundle(_STIXBase):
|
2018-07-10 21:02:55 +02:00
|
|
|
# TODO: Add link
|
2018-06-14 02:09:07 +02:00
|
|
|
"""For more detailed information on this object's properties, see
|
2018-07-10 21:02:55 +02:00
|
|
|
`the STIX 2.1 specification <link here>`__.
|
2018-06-14 02:09:07 +02:00
|
|
|
"""
|
|
|
|
|
|
|
|
_type = 'bundle'
|
2018-06-30 00:38:04 +02:00
|
|
|
_properties = OrderedDict([
|
2018-06-14 02:09:07 +02:00
|
|
|
('type', TypeProperty(_type)),
|
2019-06-14 23:58:51 +02:00
|
|
|
('id', IDProperty(_type, spec_version='2.1')),
|
2018-07-10 21:02:55 +02:00
|
|
|
('objects', ListProperty(STIXObjectProperty(spec_version='2.1'))),
|
2018-06-14 02:09:07 +02:00
|
|
|
])
|
|
|
|
|
|
|
|
def __init__(self, *args, **kwargs):
|
|
|
|
# Add any positional arguments to the 'objects' kwarg.
|
|
|
|
if args:
|
|
|
|
if isinstance(args[0], list):
|
|
|
|
kwargs['objects'] = args[0] + list(args[1:]) + kwargs.get('objects', [])
|
|
|
|
else:
|
|
|
|
kwargs['objects'] = list(args) + kwargs.get('objects', [])
|
|
|
|
|
2018-12-14 10:12:30 +01:00
|
|
|
allow_custom = kwargs.get('allow_custom', False)
|
|
|
|
self.__allow_custom = allow_custom
|
|
|
|
self._properties['objects'].contained.allow_custom = allow_custom
|
|
|
|
interoperability = kwargs.get('interoperability', False)
|
|
|
|
self.__interoperability = interoperability
|
|
|
|
self._properties['id'].interoperability = interoperability
|
|
|
|
self._properties['objects'].contained.interoperability = interoperability
|
2018-06-14 02:09:07 +02:00
|
|
|
|
|
|
|
super(Bundle, self).__init__(**kwargs)
|
2019-05-14 19:48:54 +02:00
|
|
|
|
|
|
|
def get_obj(self, obj_uuid):
|
2019-05-20 22:29:01 +02:00
|
|
|
if "objects" in self._inner:
|
2019-06-27 17:19:05 +02:00
|
|
|
found_objs = [elem for elem in self.objects if elem['id'] == obj_uuid]
|
2019-05-20 22:29:01 +02:00
|
|
|
if found_objs == []:
|
|
|
|
raise KeyError("'%s' does not match the id property of any of the bundle's objects" % obj_uuid)
|
|
|
|
return found_objs
|
|
|
|
else:
|
|
|
|
raise KeyError("There are no objects in this empty bundle")
|
2019-05-17 21:21:35 +02:00
|
|
|
|
|
|
|
def __getitem__(self, key):
|
|
|
|
try:
|
|
|
|
return super(Bundle, self).__getitem__(key)
|
|
|
|
except KeyError:
|
|
|
|
try:
|
|
|
|
return self.get_obj(key)
|
|
|
|
except KeyError:
|
2019-05-22 17:05:01 +02:00
|
|
|
raise KeyError("'%s' is neither a property on the bundle nor does it match the id property of any of the bundle's objects" % key)
|