# -*- coding: utf-8 -*- # Copyright (c) 2020-2021 Salvador E. Tropea # Copyright (c) 2020-2021 Instituto Nacional de TecnologĂ­a Industrial # License: GPL-3.0 # Project: KiBot (formerly KiPlot) """ Base class for output options """ import os import re import inspect from re import compile from .error import KiPlotConfigurationError from .gs import GS from .misc import W_UNKOPS from . import log logger = log.get_logger(__name__) def filter(v): return inspect.isclass(v) or not (callable(v) or isinstance(v, (dict, list))) class Optionable(object): """ A class to validate and hold configuration outputs/options. Is configured from a dict and the collected values are stored in its attributes. """ _str_values_re = compile(r"string=.*\] \[([^\]]+)\]") _num_range_re = compile(r"number=.*\] \[(-?\d+),(-?\d+)\]") def __init__(self): self._unkown_is_error = False self._error_context = '' self._tree = {} self._configured = False super().__init__() if GS.global_output is not None and getattr(self, 'output', None): setattr(self, 'output', GS.global_output) if GS.global_variant is not None and hasattr(self, 'variant'): setattr(self, 'variant', GS.global_variant) @staticmethod def _check_str(key, val, doc): if not isinstance(val, str): raise KiPlotConfigurationError("Option `{}` must be a string".format(key)) # If the docstring specifies the allowed values in the form [v1,v2...] enforce it m = Optionable._str_values_re.search(doc) if m: vals = m.group(1).split(',') if val not in vals: raise KiPlotConfigurationError("Option `{}` must be any of {} not `{}`".format(key, vals, val)) @staticmethod def _check_num(key, val, doc): if not isinstance(val, (int, float)): raise KiPlotConfigurationError("Option `{}` must be a number".format(key)) # If the docstring specifies a range in the form [from-to] enforce it m = Optionable._num_range_re.search(doc) if m: min = float(m.group(1)) max = float(m.group(2)) if val < min or val > max: raise KiPlotConfigurationError("Option `{}` outside its range [{},{}]".format(key, min, max)) @staticmethod def _check_bool(key, val): if not isinstance(val, bool): raise KiPlotConfigurationError("Option `{}` must be true/false".format(key)) def get_doc(self, name): try: doc = getattr(self, '_help_'+name).strip() except AttributeError: return None, name, False if doc[0] == '{': alias = doc[1:-1] return getattr(self, '_help_'+alias).strip(), alias, True return doc, name, False def add_to_doc(self, name, text): doc = getattr(self, '_help_'+name).strip() setattr(self, '_help_'+name, doc+'.\n'+text) def set_doc(self, name, text): setattr(self, '_help_'+name, text) @staticmethod def _typeof(v): if isinstance(v, bool): return 'boolean' if isinstance(v, (int, float)): return 'number' if isinstance(v, str): return 'string' if isinstance(v, dict): return 'dict' if isinstance(v, list): if len(v) == 0: return 'list(string)' return 'list({})'.format(Optionable._typeof(v[0])) return 'None' def _perform_config_mapping(self): """ Map the options to class attributes """ attrs = self.get_attrs_for() for k, v in self._tree.items(): # Map known attributes and avoid mapping private ones if (k[0] == '_') or (k not in attrs): if self._unkown_is_error: raise KiPlotConfigurationError("Unknown {}option `{}`".format(self._error_context, k)) logger.warning(W_UNKOPS + "Unknown {}option `{}`".format(self._error_context, k)) continue # Check the data type cur_doc, alias, is_alias = self.get_doc(k) cur_val = getattr(self, alias) if isinstance(cur_val, bool): Optionable._check_bool(k, v) elif isinstance(cur_val, (int, float)): Optionable._check_num(k, v, cur_doc) elif isinstance(cur_val, str): Optionable._check_str(k, v, cur_doc) elif isinstance(cur_val, type): # A class, so we need more information i.e. "[dict|string]" if cur_doc[0] == '[': # Separate the valid types for this key valid = cur_doc[1:].split(']')[0].split('|') # Remove the XXXX=Value if '=' in valid[-1]: valid[-1] = valid[-1].split('=')[0] # Get the type used by the user as a string v_type = Optionable._typeof(v) if v_type not in valid: # Not a valid type for this key if v_type == 'None': raise KiPlotConfigurationError("Empty option `{}`".format(k)) raise KiPlotConfigurationError("Option `{}` must be any of {} not `{}`".format(k, valid, v_type)) # We know the type matches, now apply validations if isinstance(v, (int, float)) and not isinstance(v, bool): # Note: booleans are also instance of int # Not used yet Optionable._check_num(k, v, cur_doc) # pragma: no cover (Internal) elif isinstance(v, str): Optionable._check_str(k, v, cur_doc) elif isinstance(v, dict): # Dicts are solved using Optionable classes new_val = v # Create an object for the valid class v = cur_val() # Delegate the validation to the object v.set_tree(new_val) v.config() elif isinstance(v, list): new_val = [] for element in v: e_type = 'list('+Optionable._typeof(element)+')' if e_type not in valid: raise KiPlotConfigurationError("Option `{}` must be any of {} not `{}`". format(element, valid, e_type)) if isinstance(element, dict): nv = cur_val() nv.set_tree(element) nv.config() new_val.append(nv) else: new_val.append(element) v = new_val # Seems to be ok, map it setattr(self, alias if is_alias else k, v) def set_tree(self, tree): self._tree = tree def config(self): if self._tree and not self._configured: self._perform_config_mapping() self._configured = True def get_attrs_for(self): """ Returns all attributes """ return dict(inspect.getmembers(self, filter)) def get_attrs_gen(self): """ Returns a (key, val) iterator on public attributes """ attrs = self.get_attrs_for() return ((k, v) for k, v in attrs.items() if k[0] != '_') def _find_variant(self): """ Returns the text to add for the current variant. If no variant is defined an empty string is returned. """ if hasattr(self, 'variant') and self.variant and hasattr(self.variant, 'file_id'): return self.variant.file_id return '' def expand_filename(self, out_dir, name, id='', ext=''): """ Expands %* values in filenames. Uses data from the PCB. """ if GS.board: GS.load_pcb_title_block() # Do the replacements name = name.replace('%c', GS.pcb_comp) name = name.replace('%d', GS.pcb_date) name = name.replace('%D', GS.today) name = name.replace('%F', GS.pcb_no_ext) name = name.replace('%f', GS.pcb_basename) name = name.replace('%i', id) name = name.replace('%p', GS.pcb_title) name = name.replace('%r', GS.pcb_rev) name = name.replace('%T', GS.time) name = name.replace('%v', self._find_variant() if self else '') name = name.replace('%x', ext) # sanitize the name to avoid characters illegal in file systems name = name.replace('\\', '/') name = re.sub(r'[?%*:|"<>]', '_', name) return os.path.abspath(os.path.join(out_dir, name)) def expand_filename_sch(self, out_dir, name, id='', ext=''): """ Expands %* values in filenames. Uses data from the SCH. """ if GS.sch_file: GS.load_sch_title_block() # Do the replacements name = name.replace('%c', GS.sch_comp) name = name.replace('%d', GS.sch_date) name = name.replace('%D', GS.today) name = name.replace('%F', GS.sch_no_ext) name = name.replace('%f', GS.sch_basename) name = name.replace('%i', id) name = name.replace('%p', GS.sch_title) name = name.replace('%r', GS.sch_rev) name = name.replace('%T', GS.time) name = name.replace('%v', self._find_variant() if self else '') name = name.replace('%x', ext) # sanitize the name to avoid characters illegal in file systems name = name.replace('\\', '/') name = re.sub(r'[?%*:|"<>]', '_', name) return os.path.abspath(os.path.join(out_dir, name)) class BaseOptions(Optionable): """ A class to validate and hold output options. Is configured from a dict and the collected values are stored in its attributes. """ def __init__(self): super().__init__() def read_vals_from_po(self, po): """ Set attributes from a PCB_PLOT_PARAMS (plot options) """ return