MyClass

A class to perform some operations on a list of float items.

Attributes:

Name	Type	Description
items	(List[float]	List of float items to be processed.
config	MyClassConfigPM	Configuration for the module.

Methods:

Name	Description
__call__	Method to clean the items based on the threshold value.
run	Method to clean the items based on the threshold value.

Source code in src/my_module01/_base.py

class MyClass:
    """A class to perform some operations on a list of float items.

    Attributes:
        items  (List[float]    ): List of float items to be processed.
        config (MyClassConfigPM): Configuration for the module.

    Methods:
        __call__ (): Method to clean the items based on the threshold value.
        run      (): Method to clean the items based on the threshold value.
    """

    @validate_call
    def __init__(
        self,
        items: Union[List[float], None] = None,
        config: Union[MyClassConfigPM, Dict[str, Any], None] = None,
        auto_run: bool = False,
        **kwargs,
    ) -> None:
        """Initializer method for the MyClass class.

        Args:
            items  (Union[List[float], None]                    , optional): List of float items to be processed. Defaults to None.
            config (Union[MyClassConfigPM, Dict[str, Any], None], optional): Configuration for the module. Defaults to None.
        """

        logger.debug(
            f"Initializing <{self.__class__.__name__}> object with '{__version__}' version..."
        )
        if not config:
            config = MyClassConfigPM()

        self.config = config
        if kwargs:
            self.config = self.config.model_copy(update=kwargs)

        if items:
            self.items = items
        logger.debug(
            f"Initialized <{self.__class__.__name__}> object with '{__version__}' version."
        )

        if auto_run:
            self.__call__()

    @validate_call
    def __call__(
        self,
        items: Union[List[float], None] = None,
        threshold: Union[float, None] = None,
    ) -> List[float]:
        """Method to clean the items based on the threshold value.

        Args:
            items     (Union[List[float], None], optional): List of float items to be processed. Defaults to None.
            threshold (Union[float, None]      , optional): Threshold value for the cleaning process. Defaults to None.

        Raises:
            RuntimeError: If `items` attribute is not set.

        Returns:
            List[float]: List of cleaned items.
        """

        if items:
            self.items = items

        if not hasattr(self, "items"):
            raise RuntimeError(
                "`items` attribute is not set, must provide a list of float items to be processed!"
            )

        if not threshold:
            threshold = self.config.threshold

        logger.debug(f"Cleaning items with threshold '{threshold}'...")
        _clean_items = []
        for _item in self.items:
            if threshold <= _item:
                _clean_items.append(_item)
        logger.debug("Successfully cleaned items.")

        self.items = _clean_items
        return self.items

    @validate_call
    def run(
        self,
        items: Union[List[float], None] = None,
        threshold: Union[float, None] = None,
    ) -> List[float]:
        """Wrapper method for the __call__ method.

        Args:
            items     (Union[List[float], None], optional): List of float items to be processed. Defaults to None.
            threshold (Union[float, None]      , optional): Threshold value for the cleaning process. Defaults to None.

        Returns:
            List[float]: List of cleaned items.
        """

        return self.__call__(items=items, threshold=threshold)

    ### ATTRIBUTES ###
    ## config ##
    @property
    def config(self) -> MyClassConfigPM:
        try:
            return self.__config
        except AttributeError:
            self.__config = MyClassConfigPM()

        return self.__config

    @config.setter
    def config(self, config: Union[MyClassConfigPM, Dict[str, Any]]) -> None:
        if (not isinstance(config, MyClassConfigPM)) and (not isinstance(config, dict)):
            raise TypeError(
                f"`config` attribute type {type(config)} is invalid, must be a <class 'MyClassConfigPM'> or <dict>"
            )

        if isinstance(config, dict):
            config = MyClassConfigPM(**config)
        elif isinstance(config, MyClassConfigPM):
            config = config.model_copy(deep=True)

        self.__config = config

    ## config ##

    ## items ##
    @property
    def items(self) -> List[float]:
        try:
            return self.__items
        except AttributeError:
            raise AttributeError("`items` attribute is not set!")

    @items.setter
    def items(self, items: List[float]) -> None:
        if not isinstance(items, list):
            raise TypeError(
                f"`items` attribute type {type(items)} is invalid, must be a <class 'list'>"
            )

        if (len(items) < self.config.min_length) or (
            self.config.max_length < len(items)
        ):
            raise ValueError(
                f"`items` attribute length '{len(items)}' is too short or too long, must be between '{self.config.min_length}' and '{self.config.max_length}'!"
            )

        for _item in items:
            if not isinstance(_item, float):
                raise TypeError(
                    f"`items` attribute item type {type(_item)} is invalid, must be a <float>!"
                )

            if (_item < self.config.min_value) or (self.config.max_value < _item):
                raise ValueError(
                    f"`items` attribute item value '{_item}' is not in the allowed range, must be between '{self.config.min_value}' and '{self.config.max_value}'!"
                )

        self.__items = items

    ## items ##
    ### ATTRIBUTES ###

    ## METHOD OVERRIDING ##
    def __str__(self):
        _self_dict = utils.clean_obj_dict(self.__dict__, self.__class__.__name__)
        _self_str = f"{self.__class__.__name__}: {pprint.pformat(_self_dict)}"
        return _self_str

    def __repr__(self):
        _self_repr = utils.obj_to_repr(self)
        return _self_repr

__call__(items=None, threshold=None)

Method to clean the items based on the threshold value.

Parameters:

Name	Type	Description	Default
items	(Union[List[float], None]	List of float items to be processed. Defaults to None.	None
threshold	Union[float, None]	Threshold value for the cleaning process. Defaults to None.	None

Raises:

Type	Description
RuntimeError	If items attribute is not set.

Returns:

Type	Description
List[float]	List[float]: List of cleaned items.

Source code in src/my_module01/_base.py

@validate_call
def __call__(
    self,
    items: Union[List[float], None] = None,
    threshold: Union[float, None] = None,
) -> List[float]:
    """Method to clean the items based on the threshold value.

    Args:
        items     (Union[List[float], None], optional): List of float items to be processed. Defaults to None.
        threshold (Union[float, None]      , optional): Threshold value for the cleaning process. Defaults to None.

    Raises:
        RuntimeError: If `items` attribute is not set.

    Returns:
        List[float]: List of cleaned items.
    """

    if items:
        self.items = items

    if not hasattr(self, "items"):
        raise RuntimeError(
            "`items` attribute is not set, must provide a list of float items to be processed!"
        )

    if not threshold:
        threshold = self.config.threshold

    logger.debug(f"Cleaning items with threshold '{threshold}'...")
    _clean_items = []
    for _item in self.items:
        if threshold <= _item:
            _clean_items.append(_item)
    logger.debug("Successfully cleaned items.")

    self.items = _clean_items
    return self.items

__init__(items=None, config=None, auto_run=False, **kwargs)

Initializer method for the MyClass class.

Parameters:

Name	Type	Description	Default
items	(Union[List[float], None]	List of float items to be processed. Defaults to None.	None
config	Union[MyClassConfigPM, Dict[str, Any], None]	Configuration for the module. Defaults to None.	None

Source code in src/my_module01/_base.py

@validate_call
def __init__(
    self,
    items: Union[List[float], None] = None,
    config: Union[MyClassConfigPM, Dict[str, Any], None] = None,
    auto_run: bool = False,
    **kwargs,
) -> None:
    """Initializer method for the MyClass class.

    Args:
        items  (Union[List[float], None]                    , optional): List of float items to be processed. Defaults to None.
        config (Union[MyClassConfigPM, Dict[str, Any], None], optional): Configuration for the module. Defaults to None.
    """

    logger.debug(
        f"Initializing <{self.__class__.__name__}> object with '{__version__}' version..."
    )
    if not config:
        config = MyClassConfigPM()

    self.config = config
    if kwargs:
        self.config = self.config.model_copy(update=kwargs)

    if items:
        self.items = items
    logger.debug(
        f"Initialized <{self.__class__.__name__}> object with '{__version__}' version."
    )

    if auto_run:
        self.__call__()

run(items=None, threshold=None)

Wrapper method for the call method.

Parameters:

Name	Type	Description	Default
items	(Union[List[float], None]	List of float items to be processed. Defaults to None.	None
threshold	Union[float, None]	Threshold value for the cleaning process. Defaults to None.	None

Returns:

Type	Description
List[float]	List[float]: List of cleaned items.

Source code in src/my_module01/_base.py

@validate_call
def run(
    self,
    items: Union[List[float], None] = None,
    threshold: Union[float, None] = None,
) -> List[float]:
    """Wrapper method for the __call__ method.

    Args:
        items     (Union[List[float], None], optional): List of float items to be processed. Defaults to None.
        threshold (Union[float, None]      , optional): Threshold value for the cleaning process. Defaults to None.

    Returns:
        List[float]: List of cleaned items.
    """

    return self.__call__(items=items, threshold=threshold)