dtlpy 1.114.17__py3-none-any.whl → 1.116.6__py3-none-any.whl

dtlpy/entities/base_entity.py

@@ -1,214 +1,214 @@
-import functools
-import logging
-import enum
-
-from .. import miscellaneous
-
-logger = logging.getLogger('dtlpy')
-
-
-class EntityScopeLevel(str, enum.Enum):
-    PRIVATE = 'private',
-    PROJECT = 'project',
-    ORG = 'org',
-    PUBLIC = 'public'
-
-
-class BaseEntity(object):
-    is_fetched = True
-
-    def print(self, to_return=False, columns=None):
-        """
-        :param to_return:
-        :param columns:
-        """
-        return miscellaneous.List([self]).print(to_return=to_return, columns=columns)
-
-    def to_df(self, show_all=False, columns=None):
-        """
-        :param show_all:
-        :param columns:
-        """
-        return miscellaneous.List([self]).to_df(show_all=show_all, columns=columns)
-
-
-# for auto-complete
-from typing import TYPE_CHECKING
-
-RUNTIME = not TYPE_CHECKING
-if RUNTIME:
-    def base_model(model):
-        return model
-else:
-    from dataclasses import dataclass as base_model
-
-
-class DlList(list):
-    def __init__(self, _list=None, _dict=None, _type=None):
-        if _list is None:
-            _list = list()
-        if _dict is None:
-            _dict = list()
-        self._dict = _dict
-        self._type = _type
-        super(DlList, self).__init__(_list)
-
-    def append(self, item) -> None:
-        if self._type is not None:
-            assert isinstance(item, self._type), f'Cannot append type: {type(item)}. Must be type {self._type}'
-        self._dict.append(item.to_json())
-        super(DlList, self).append(item)  # append the item to itself (the list)
-
-
-@base_model
-class DlEntity(object):
-    is_fetched = True
-
-    def __init__(self, _dict=None, **kwargs):
-        # using dict by reference and not creating a new one each time
-        if _dict is None:
-            _dict = dict()
-        self._dict = _dict
-        # this will set all the inputs to right location (using the dl.Property definitions)
-        for key, value in kwargs.items():
-            if key == "_dict":
-                self._dict.update(value.copy())
-            else:
-                self.__setattr__(key, value)
-        self._set_defaults()
-
-    def _set_defaults(self):
-        # getting all attribute (that are DlProperty) to set defaults to _dict
-        # https://stackoverflow.com/questions/21962769/is-it-possible-to-test-if-object-property-uses-a-descriptor
-        for att, a_type in type(self).__mro__[0].__dict__.items():
-            if isinstance(a_type, DlProperty):
-                _ = self.__getattribute__(att)
-
-    def print(self, to_return=False, columns=None):
-        """
-        :param to_return:
-        :param columns:
-        """
-        return miscellaneous.List([self]).print(to_return=to_return, columns=columns)
-
-    def to_df(self, show_all=False, columns=None):
-        """
-        :param show_all:
-        :param columns:
-        """
-        return miscellaneous.List([self]).to_df(show_all=show_all, columns=columns)
-
-
-class DlProperty:
-    def __init__(self, location=None, default='NODEFAULT', _type=None, _kls=None):
-        self.location = location
-        self._default = default
-        self._type = _type
-        self._validator = None
-        self._kls = _kls
-
-    ##############
-    # decorators #
-    ##############
-    def default(self, method=None):
-        @functools.wraps(method)
-        def _default(self):
-            return method(self)
-
-        self._default = _default
-        return self._default
-
-    def validator(self, method):
-        @functools.wraps(method)
-        def _validator(self, value):
-            return method(self, value)
-
-        self._validator = _validator
-        return self._validator
-
-    ############
-    # privates #
-    ############
-    @staticmethod
-    def _get_class(kls):
-        import importlib
-        module = importlib.import_module(f'.entities', package='dtlpy')
-        kls = getattr(module, kls)
-        return kls
-
-    def _get_default(self, instance):
-        if callable(self._default):
-            default = self._default(self=instance)
-        else:
-            default = self._default
-        return default
-
-    def _to_dict(self, inst):
-        if self._kls is not None:
-            if isinstance(inst, list) and all(hasattr(v, 'to_json') for v in inst):
-                _dict = [v.to_json() for v in inst]
-            elif hasattr(inst, 'to_json'):
-                _dict = inst.to_json()
-            else:
-                _dict = inst
-        else:
-            _dict = inst
-        return _dict
-
-    def _to_instance(self, _dict):
-        if self._kls is not None:
-            kls = self._get_class(kls=self._kls)
-            if isinstance(_dict, list) and all(isinstance(v, dict) for v in _dict):
-                value = DlList(_list=[kls.from_json(v) for v in _dict],
-                               _type=kls,
-                               _dict=_dict)
-            elif isinstance(_dict, dict):
-                value = kls(_dict=_dict, **_dict)
-            else:
-                value = _dict
-        else:
-            value = _dict
-        return value
-
-    def __get__(self, instance, owner):
-        _dict = instance._dict
-        for key in self.location[:-1]:
-            _dict = _dict.get(key, dict())
-
-        # get default if set - can also be callable
-        try:
-            value = _dict[self.location[-1]]
-        except KeyError:
-            # get the default only of value doesnt exists
-            value = self._get_default(instance=instance)
-            if value == 'NODEFAULT':
-                # if NODEFAULT - set value to None and DONT save in the _dict
-                value = None
-            else:
-                # if default value is set - add the value into the _dict
-                _dict[self.location[-1]] = value
-
-        # instantiate dictionary to the type
-        value = self._to_instance(_dict=value)
-        return value
-
-    def __set__(self, instance, value):
-
-        # validate - if validator is set
-        if self._validator is not None:
-            # instantiate the value before validation
-            inst = self._to_instance(_dict=value)
-            self._validator(self=instance, value=inst)
-
-        # convert to the value's kls
-        value = self._to_dict(inst=value)
-
-        # set value in the dictionary
-        _dict = instance._dict
-        for key in self.location[:-1]:
-            _tmp_dict = _dict.get(key, None)
-            # create the dict inside to be able to point
-            if _tmp_dict is None:
-                _dict[key] = dict()
-            _dict = _dict.get(key, None)
-        _dict[self.location[-1]] = value
+import functools
+import logging
+import enum
+
+from .. import miscellaneous
+
+logger = logging.getLogger('dtlpy')
+
+
+class EntityScopeLevel(str, enum.Enum):
+    PRIVATE = 'private',
+    PROJECT = 'project',
+    ORG = 'org',
+    PUBLIC = 'public'
+
+
+class BaseEntity(object):
+    is_fetched = True
+
+    def print(self, to_return=False, columns=None):
+        """
+        :param to_return:
+        :param columns:
+        """
+        return miscellaneous.List([self]).print(to_return=to_return, columns=columns)
+
+    def to_df(self, show_all=False, columns=None):
+        """
+        :param show_all:
+        :param columns:
+        """
+        return miscellaneous.List([self]).to_df(show_all=show_all, columns=columns)
+
+
+# for auto-complete
+from typing import TYPE_CHECKING
+
+RUNTIME = not TYPE_CHECKING
+if RUNTIME:
+    def base_model(model):
+        return model
+else:
+    from dataclasses import dataclass as base_model
+
+
+class DlList(list):
+    def __init__(self, _list=None, _dict=None, _type=None):
+        if _list is None:
+            _list = list()
+        if _dict is None:
+            _dict = list()
+        self._dict = _dict
+        self._type = _type
+        super(DlList, self).__init__(_list)
+
+    def append(self, item) -> None:
+        if self._type is not None:
+            assert isinstance(item, self._type), f'Cannot append type: {type(item)}. Must be type {self._type}'
+        self._dict.append(item.to_json())
+        super(DlList, self).append(item)  # append the item to itself (the list)
+
+
+@base_model
+class DlEntity(object):
+    is_fetched = True
+
+    def __init__(self, _dict=None, **kwargs):
+        # using dict by reference and not creating a new one each time
+        if _dict is None:
+            _dict = dict()
+        self._dict = _dict
+        # this will set all the inputs to right location (using the dl.Property definitions)
+        for key, value in kwargs.items():
+            if key == "_dict":
+                self._dict.update(value.copy())
+            else:
+                self.__setattr__(key, value)
+        self._set_defaults()
+
+    def _set_defaults(self):
+        # getting all attribute (that are DlProperty) to set defaults to _dict
+        # https://stackoverflow.com/questions/21962769/is-it-possible-to-test-if-object-property-uses-a-descriptor
+        for att, a_type in type(self).__mro__[0].__dict__.items():
+            if isinstance(a_type, DlProperty):
+                _ = self.__getattribute__(att)
+
+    def print(self, to_return=False, columns=None):
+        """
+        :param to_return:
+        :param columns:
+        """
+        return miscellaneous.List([self]).print(to_return=to_return, columns=columns)
+
+    def to_df(self, show_all=False, columns=None):
+        """
+        :param show_all:
+        :param columns:
+        """
+        return miscellaneous.List([self]).to_df(show_all=show_all, columns=columns)
+
+
+class DlProperty:
+    def __init__(self, location=None, default='NODEFAULT', _type=None, _kls=None):
+        self.location = location
+        self._default = default
+        self._type = _type
+        self._validator = None
+        self._kls = _kls
+
+    ##############
+    # decorators #
+    ##############
+    def default(self, method=None):
+        @functools.wraps(method)
+        def _default(self):
+            return method(self)
+
+        self._default = _default
+        return self._default
+
+    def validator(self, method):
+        @functools.wraps(method)
+        def _validator(self, value):
+            return method(self, value)
+
+        self._validator = _validator
+        return self._validator
+
+    ############
+    # privates #
+    ############
+    @staticmethod
+    def _get_class(kls):
+        import importlib
+        module = importlib.import_module(f'.entities', package='dtlpy')
+        kls = getattr(module, kls)
+        return kls
+
+    def _get_default(self, instance):
+        if callable(self._default):
+            default = self._default(self=instance)
+        else:
+            default = self._default
+        return default
+
+    def _to_dict(self, inst):
+        if self._kls is not None:
+            if isinstance(inst, list) and all(hasattr(v, 'to_json') for v in inst):
+                _dict = [v.to_json() for v in inst]
+            elif hasattr(inst, 'to_json'):
+                _dict = inst.to_json()
+            else:
+                _dict = inst
+        else:
+            _dict = inst
+        return _dict
+
+    def _to_instance(self, _dict):
+        if self._kls is not None:
+            kls = self._get_class(kls=self._kls)
+            if isinstance(_dict, list) and all(isinstance(v, dict) for v in _dict):
+                value = DlList(_list=[kls.from_json(v) for v in _dict],
+                               _type=kls,
+                               _dict=_dict)
+            elif isinstance(_dict, dict):
+                value = kls(_dict=_dict, **_dict)
+            else:
+                value = _dict
+        else:
+            value = _dict
+        return value
+
+    def __get__(self, instance, owner):
+        _dict = instance._dict
+        for key in self.location[:-1]:
+            _dict = _dict.get(key, dict())
+
+        # get default if set - can also be callable
+        try:
+            value = _dict[self.location[-1]]
+        except KeyError:
+            # get the default only of value doesnt exists
+            value = self._get_default(instance=instance)
+            if value == 'NODEFAULT':
+                # if NODEFAULT - set value to None and DONT save in the _dict
+                value = None
+            else:
+                # if default value is set - add the value into the _dict
+                _dict[self.location[-1]] = value
+
+        # instantiate dictionary to the type
+        value = self._to_instance(_dict=value)
+        return value
+
+    def __set__(self, instance, value):
+
+        # validate - if validator is set
+        if self._validator is not None:
+            # instantiate the value before validation
+            inst = self._to_instance(_dict=value)
+            self._validator(self=instance, value=inst)
+
+        # convert to the value's kls
+        value = self._to_dict(inst=value)
+
+        # set value in the dictionary
+        _dict = instance._dict
+        for key in self.location[:-1]:
+            _tmp_dict = _dict.get(key, None)
+            # create the dict inside to be able to point
+            if _tmp_dict is None:
+                _dict[key] = dict()
+            _dict = _dict.get(key, None)
+        _dict[self.location[-1]] = value

dtlpy/entities/bot.py

@@ -1,113 +1,113 @@
-import traceback
-import logging
-import attr
-
-from .. import entities, exceptions, repositories
-
-logger = logging.getLogger(name='dtlpy')
-
-
-@attr.s
-class Bot(entities.User):
-    """
-    Bot entity
-    """
-    _bots = attr.ib(repr=False, default=None)
-    password = attr.ib(default=None)
-
-    @staticmethod
-    def _protected_from_json(_json, project, client_api, bots=None):
-        """
-        Same as from_json but with try-except to catch if error
-        :param _json: platform json
-        :param project: project entity
-        :param client_api: ApiClient entity
-        :param bots:
-        :return:
-        """
-        try:
-            bot = Bot.from_json(_json=_json,
-                                project=project,
-                                bots=bots,
-                                client_api=client_api)
-            status = True
-        except Exception:
-            bot = traceback.format_exc()
-            status = False
-        return status, bot
-
-    @classmethod
-    def from_json(cls, _json, project, client_api, bots=None):
-        """
-        Build a Bot entity object from a json
-
-        :param _json: _json response from host
-        :param project: project entity
-        :param client_api: ApiClient entity
-        :param bots: Bots repository
-        :return: User object
-        """
-        return cls(
-            created_at=_json.get('createdAt', None),
-            name=_json.get('firstName', None),
-            updated_at=_json.get('updatedAt', None),
-            last_name=_json.get('lastName', None),
-            username=_json.get('username', None),
-            avatar=_json.get('avatar', None),
-            email=_json.get('email', None),
-            type=_json.get('type', None),
-            role=_json.get('role', None),
-            org=_json.get('org', None),
-            id=_json.get('id', None),
-            project=project,
-            client_api=client_api,
-            bots=bots,
-            password=_json.get('password', None),
-        )
-
-    @property
-    def bots(self):
-        if self._bots is None:
-            self._bots = repositories.Bots(client_api=self._client_api, project=self._project)
-        assert isinstance(self._bots, repositories.Bots)
-        return self._bots
-
-    @property
-    def project(self):
-        if self._project is None:
-            raise exceptions.PlatformException(error='2001',
-                                               message='Missing entity "project".')
-        assert isinstance(self._project, entities.Project)
-        return self._project
-
-    def to_json(self):
-        """
-        Returns platform _json format of object
-
-        :return: platform json format of object
-        :rtype: dict
-        """
-        _json = attr.asdict(self,
-                            filter=attr.filters.exclude(attr.fields(Bot)._project,
-                                                        attr.fields(Bot).name,
-                                                        attr.fields(Bot)._client_api,
-                                                        attr.fields(Bot)._bots,
-                                                        attr.fields(Bot)._users,
-                                                        attr.fields(Bot).last_name,
-                                                        attr.fields(Bot).created_at,
-                                                        attr.fields(Bot).updated_at,
-                                                        ))
-        _json['firstName'] = self.name
-        _json['lastName'] = self.last_name
-        _json['createdAt'] = self.created_at
-        _json['updatedAt'] = self.updated_at
-        return _json
-
-    def delete(self):
-        """
-        Delete the bot
-
-        :return: True
-        :rtype: bool
-        """
-        return self.bots.delete(bot_id=self.id)
+import traceback
+import logging
+import attr
+
+from .. import entities, exceptions, repositories
+
+logger = logging.getLogger(name='dtlpy')
+
+
+@attr.s
+class Bot(entities.User):
+    """
+    Bot entity
+    """
+    _bots = attr.ib(repr=False, default=None)
+    password = attr.ib(default=None)
+
+    @staticmethod
+    def _protected_from_json(_json, project, client_api, bots=None):
+        """
+        Same as from_json but with try-except to catch if error
+        :param _json: platform json
+        :param project: project entity
+        :param client_api: ApiClient entity
+        :param bots:
+        :return:
+        """
+        try:
+            bot = Bot.from_json(_json=_json,
+                                project=project,
+                                bots=bots,
+                                client_api=client_api)
+            status = True
+        except Exception:
+            bot = traceback.format_exc()
+            status = False
+        return status, bot
+
+    @classmethod
+    def from_json(cls, _json, project, client_api, bots=None):
+        """
+        Build a Bot entity object from a json
+
+        :param _json: _json response from host
+        :param project: project entity
+        :param client_api: ApiClient entity
+        :param bots: Bots repository
+        :return: User object
+        """
+        return cls(
+            created_at=_json.get('createdAt', None),
+            name=_json.get('firstName', None),
+            updated_at=_json.get('updatedAt', None),
+            last_name=_json.get('lastName', None),
+            username=_json.get('username', None),
+            avatar=_json.get('avatar', None),
+            email=_json.get('email', None),
+            type=_json.get('type', None),
+            role=_json.get('role', None),
+            org=_json.get('org', None),
+            id=_json.get('id', None),
+            project=project,
+            client_api=client_api,
+            bots=bots,
+            password=_json.get('password', None),
+        )
+
+    @property
+    def bots(self):
+        if self._bots is None:
+            self._bots = repositories.Bots(client_api=self._client_api, project=self._project)
+        assert isinstance(self._bots, repositories.Bots)
+        return self._bots
+
+    @property
+    def project(self):
+        if self._project is None:
+            raise exceptions.PlatformException(error='2001',
+                                               message='Missing entity "project".')
+        assert isinstance(self._project, entities.Project)
+        return self._project
+
+    def to_json(self):
+        """
+        Returns platform _json format of object
+
+        :return: platform json format of object
+        :rtype: dict
+        """
+        _json = attr.asdict(self,
+                            filter=attr.filters.exclude(attr.fields(Bot)._project,
+                                                        attr.fields(Bot).name,
+                                                        attr.fields(Bot)._client_api,
+                                                        attr.fields(Bot)._bots,
+                                                        attr.fields(Bot)._users,
+                                                        attr.fields(Bot).last_name,
+                                                        attr.fields(Bot).created_at,
+                                                        attr.fields(Bot).updated_at,
+                                                        ))
+        _json['firstName'] = self.name
+        _json['lastName'] = self.last_name
+        _json['createdAt'] = self.created_at
+        _json['updatedAt'] = self.updated_at
+        return _json
+
+    def delete(self):
+        """
+        Delete the bot
+
+        :return: True
+        :rtype: bool
+        """
+        return self.bots.delete(bot_id=self.id)