Source code for wield.declarative.overridable_object

#!/usr/bin/env python
# -*- coding: utf-8 -*-
# SPDX-License-Identifier: Apache-2.0
# SPDX-FileCopyrightText: © 2021 Massachusetts Institute of Technology.
# SPDX-FileCopyrightText: © 2021 Lee McCuller <mcculler@caltech.edu>
# NOTICE: authors should document their contributions in concisely in NOTICE
# with details inline in source files, comments, and docstrings.
"""
"""
import types

from .properties import HasDeclaritiveAttributes

from .utilities.representations import SuperBase




class OverridableObject(HasDeclaritiveAttributes, SuperBase, object):
    """ """

    _overridable_object_save_kwargs = False
    _overridable_object_kwargs = None

    def _overridable_object_inject(self, **kwargs):
        """ """
        kwargs_unmatched = {}
        for key, obj in list(kwargs.items()):
            try:
                parent_desc = getattr(self.__class__, key)
            except AttributeError:
                kwargs_unmatched[key] = obj
                continue

            if isinstance(parent_desc, (types.MethodType, staticmethod, classmethod)):
                raise ValueError(
                    (
                        "Can only redefine non-method descriptors, {0} a method of class {1}"
                    ).format(key, self.__class__.__name__)
                )
            try:
                use_bd = parent_desc._force_boot_dict
            except AttributeError:
                use_bd = False

            if not use_bd:
                setattr(self, key, obj)
            else:
                self.__boot_dict__[key] = obj
        return kwargs_unmatched



    def __init__(self, **kwargs):
        """ """
        if self._overridable_object_save_kwargs:
            self._overridable_object_kwargs = kwargs
        kwargs_unmatched = self._overridable_object_inject(**kwargs)
        if kwargs_unmatched:
            raise ValueError(
                (
                    "Can only redefine class-specified attributes, class {0} does not have elements {1}"
                ).format(self.__class__.__name__, list(kwargs_unmatched.keys()))
            )

        # now run the __mid_init__ before all of the declarative arguments trigger
        self.__mid_init__()
        super(OverridableObject, self).__init__()
        # print("OO: ", self)
        return


    def __mid_init__(self):
        """ """
        return