Source code for gen_coap_service.pro.write_template

# -*- coding: UTF-8 -*-

'''
Module
    write_template.py
Copyright
    Copyright (C) 2020 - 2024 Vladimir Roncevic <elektron.ronca@gmail.com>
    gen_coap_service is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by the
    Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.
    gen_coap_service is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
    See the GNU General Public License for more details.
    You should have received a copy of the GNU General Public License along
    with this program. If not, see <http://www.gnu.org/licenses/>.
Info
    Defines class WriteTemplate with attribute(s) and method(s).
    Writes a templates with parameters.
'''

import sys
from typing import Any, List, Dict
from datetime import datetime
from string import Template

try:
    from ats_utilities.config_io.file_check import FileCheck
    from ats_utilities.console_io.verbose import verbose_message
    from ats_utilities.exceptions.ats_type_error import ATSTypeError
    from ats_utilities.exceptions.ats_value_error import ATSValueError
except ImportError as ats_error_message:
    # Force close python ATS ##################################################
    sys.exit(f'\n{__file__}\n{ats_error_message}\n')

__author__ = 'Vladimir Roncevic'
__copyright__ = '(C) 2024, https://vroncevic.github.io/gen_coap_service'
__credits__: List[str] = ['Vladimir Roncevic', 'Python Software Foundation']
__license__ = 'https://github.com/vroncevic/gen_coap_service/blob/dev/LICENSE'
__version__ = '1.1.2'
__maintainer__ = 'Vladimir Roncevic'
__email__ = 'elektron.ronca@gmail.com'
__status__ = 'Updated'


[docs]class WriteTemplate(FileCheck): ''' Defines class WriteTemplate with attribute(s) and method(s). Writes a templates with parameters. It Definess: :attributes: | _GEN_VERBOSE - Console text indicator for process-phase. :methods: | __init__ - Initials WriteTemplate constructor | write - Write a template content with parameters to a file ''' _GEN_VERBOSE: str = 'GEN_AUTOCONF::PRO::WRITE_TEMPLATE' def __init__(self, verbose: bool = False): ''' Initials WriteTemplate constructor. :param verbose: Enable/disable verbose option :type verbose: <bool> :exceptions: None ''' super().__init__(verbose) verbose_message( verbose, [f'{self._GEN_VERBOSE.lower()} init writer'] )
[docs] def write(self, config: Dict[Any, Any], verbose: bool = False) -> bool: ''' Write a template content with parameters to a file. :param config: Template content :type config: <Dict[Any, Any]> :param verbose: Enable/disable verbose option :type verbose: <bool> :return: True (success operation) | False :rtype: <bool> :exceptions: ATSTypeError | ATSValueError ''' error_msg: str | None = None error_id: int | None = None error_msg, error_id = self.check_params([('dict:config', config)]) if error_id == self.TYPE_ERROR: raise ATSTypeError(error_msg) if not bool(config): raise ATSValueError('missing content') verbose_message( verbose, [f'{self._GEN_VERBOSE.lower()} writes template'] ) status: bool = False template: Template = Template(config['template']) with open(config['module'], 'w', encoding='utf-8') as module_file: module_content: str = template.substitute({ 'PKG': f'{config["name"]}', 'YEAR': f'{datetime.now().year}' }) if module_file.write(module_content) > 0: status = True return status