cti-python-stix2/stix2/base.py

101 lines
3.3 KiB
Python
Raw Normal View History

2017-02-10 22:35:02 +01:00
"""Base class for type definitions in the stix2 library."""
import collections
import datetime as dt
import json
2017-04-18 21:41:18 +02:00
from .exceptions import STIXValueError, MissingFieldsError
2017-02-10 22:35:02 +01:00
from .utils import format_datetime, get_timestamp, NOW
__all__ = ['STIXJSONEncoder', '_STIXBase']
DEFAULT_ERROR = "{type} must have {field}='{expected}'."
class STIXJSONEncoder(json.JSONEncoder):
def default(self, obj):
if isinstance(obj, (dt.date, dt.datetime)):
return format_datetime(obj)
elif isinstance(obj, _STIXBase):
return dict(obj)
else:
return super(STIXJSONEncoder, self).default(obj)
2017-02-24 16:28:53 +01:00
def get_required_properties(properties):
2017-03-22 14:26:13 +01:00
return (k for k, v in properties.items() if v.required)
2017-02-24 16:28:53 +01:00
2017-02-10 22:35:02 +01:00
class _STIXBase(collections.Mapping):
"""Base class for STIX object types"""
2017-02-24 17:20:24 +01:00
def _check_property(self, prop_name, prop, kwargs):
if prop_name not in kwargs:
if hasattr(prop, 'default'):
value = prop.default()
if value == NOW:
value = self.__now
kwargs[prop_name] = value
if prop_name in kwargs:
try:
kwargs[prop_name] = prop.validate(kwargs[prop_name])
except ValueError as exc:
raise STIXValueError(self.__class__, prop_name, reason=str(exc))
2017-02-24 17:20:24 +01:00
2017-02-10 22:35:02 +01:00
def __init__(self, **kwargs):
cls = self.__class__
# Use the same timestamp for any auto-generated datetimes
2017-02-24 16:28:53 +01:00
self.__now = get_timestamp()
2017-02-10 22:35:02 +01:00
# Detect any keyword arguments not allowed for a specific type
extra_kwargs = list(set(kwargs) - set(cls._properties))
if extra_kwargs:
raise TypeError("unexpected keyword arguments: " + str(extra_kwargs))
2017-02-24 16:28:53 +01:00
required_fields = get_required_properties(cls._properties)
2017-02-10 22:35:02 +01:00
missing_kwargs = set(required_fields) - set(kwargs)
if missing_kwargs:
2017-04-18 21:41:18 +02:00
raise MissingFieldsError(cls, missing_kwargs)
2017-02-10 22:35:02 +01:00
for prop_name, prop_metadata in cls._properties.items():
self._check_property(prop_name, prop_metadata, kwargs)
2017-02-10 22:35:02 +01:00
self._inner = kwargs
if self.granular_markings:
for m in self.granular_markings:
# TODO: check selectors
pass
2017-02-10 22:35:02 +01:00
def __getitem__(self, key):
return self._inner[key]
def __iter__(self):
return iter(self._inner)
def __len__(self):
return len(self._inner)
# Handle attribute access just like key access
def __getattr__(self, name):
return self.get(name)
def __setattr__(self, name, value):
2017-02-24 16:28:53 +01:00
if name != '_inner' and not name.startswith("_STIXBase__"):
print(name)
2017-02-10 22:35:02 +01:00
raise ValueError("Cannot modify properties after creation.")
super(_STIXBase, self).__setattr__(name, value)
def __str__(self):
# TODO: put keys in specific order. Probably need custom JSON encoder.
return json.dumps(self, indent=4, sort_keys=True, cls=STIXJSONEncoder,
separators=(",", ": ")) # Don't include spaces after commas.
2017-02-10 22:58:17 +01:00
def __repr__(self):
2017-02-10 23:09:37 +01:00
props = [(k, self[k]) for k in sorted(self._properties) if self.get(k)]
2017-02-10 22:58:17 +01:00
return "{0}({1})".format(self.__class__.__name__,
", ".join(["{0!s}={1!r}".format(k, v) for k, v in props]))