Source code for PyFunceble.cli.system.integrator

The tool to check the availability or syntax of domain, IP or URL.


    ██████╗ ██╗   ██╗███████╗██╗   ██╗███╗   ██╗ ██████╗███████╗██████╗ ██╗     ███████╗
    ██╔══██╗╚██╗ ██╔╝██╔════╝██║   ██║████╗  ██║██╔════╝██╔════╝██╔══██╗██║     ██╔════╝
    ██████╔╝ ╚████╔╝ █████╗  ██║   ██║██╔██╗ ██║██║     █████╗  ██████╔╝██║     █████╗
    ██╔═══╝   ╚██╔╝  ██╔══╝  ██║   ██║██║╚██╗██║██║     ██╔══╝  ██╔══██╗██║     ██╔══╝
    ██║        ██║   ██║     ╚██████╔╝██║ ╚████║╚██████╗███████╗██████╔╝███████╗███████╗
    ╚═╝        ╚═╝   ╚═╝      ╚═════╝ ╚═╝  ╚═══╝ ╚═════╝╚══════╝╚═════╝ ╚══════╝╚══════╝

Provides our very own argument parser. Take this as a splitter which runs
some actions against other resource before returning the arguments.

    Nissar Chababy, @funilrys, contactTATAfunilrysTODTODcom

Special thanks:


Project link:

Project documentation:

Project homepage:


    Copyright 2017, 2018, 2019, 2020, 2022, 2023 Nissar Chababy

    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at

    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.

import os

import colorama

import PyFunceble.cli.facility
import PyFunceble.cli.factory
import PyFunceble.facility
from PyFunceble.cli.system.base import SystemBase
from PyFunceble.helpers.dict import DictHelper

[docs]class SystemIntegrator(SystemBase): """ Provides our system integrator. The idea is that we given an argparse Namespace, we should be able to parse it into our system. To simplify the trick and headache in the CLI management, I explicitely mapped the :code:`dest` argument to what we are supposed to have in the flatten version of the configuration. That way, we only need to compare against the flatten version instead of looping over all possible levels of the configuration tree. """
[docs] @SystemBase.ensure_args_is_given def init_logger(self) -> "SystemIntegrator": """ Initiate the loggers. In fact, before this moment, in a normal case the logger was not properly initiated. To avoid multiple management place, I took it to the essential. .. warning:: If you plan to play with the logger on your own, be sure to follow the same procedure. """ PyFunceble.facility.Logger.set_output_directory( os.path.join(,, ) ) if hasattr(self.args, "debug__active") and self.args.debug__active: PyFunceble.facility.Logger.set_activated(True) if hasattr(self.args, "debug__level") and self.args.debug__level: PyFunceble.facility.Logger.set_min_level(self.args.debug__level) PyFunceble.facility.Logger.set_activated(True) if not PyFunceble.facility.Logger.activated: PyFunceble.facility.Logger.guess_all_settings() # We do this because the starting point is here under the CLI :-) PyFunceble.facility.Logger.init_loggers()
[docs] @SystemBase.ensure_args_is_given def inject_into_config(self) -> "SystemIntegrator": """ Injects the configuration variables into the configuration after comparing each value with the current one. """ "Started to inject arguments info configuration." ) dict_helper = DictHelper( flatten_config = dict_helper.flatten() to_update = {} reserved_lookup_mode = [] for key, value in vars(self.args).items(): if value in (False, None): continue if "__" in key: key = key.replace("__", ".") if key in flatten_config: if isinstance(flatten_config[key], bool) and isinstance(value, bool): to_update[key] = not flatten_config[key] else: to_update[key] = value elif key.startswith("self_contained") and "lookup" in key: reserved_lookup_mode.append(key[key.rfind(".") + 1 :]) if reserved_lookup_mode: for lookup_key in if lookup_key in {"timeout"}: continue if lookup_key not in reserved_lookup_mode: to_update[f"lookup.{lookup_key}"] = False else: to_update[f"lookup.{lookup_key}"] = True dict_helper.set_subject(to_update) unflatten_to_update = dict_helper.unflatten() # We assume that the configuration was already loaded. PyFunceble.facility.ConfigLoader.custom_config = unflatten_to_update PyFunceble.facility.Logger.debug( "Injected into config: %r", unflatten_to_update ) "Finished to inject arguments info configuration." ) return self
[docs] @SystemBase.ensure_args_is_given def check_config(self) -> "SystemIntegrator": """ Checks or do some sanity check of the configuration. This method will basically check that the common mistakes while mixing configuration and CLI arguments are not found. .. warning:: The messages are not directly printed, but rather stored in the list. """ if ( not and not ): f"{colorama.Style.BRIGHT}{colorama.Fore.MAGENTA}Your setup won't " "generate any output! " "Reason: file_generation.hosts and file_generation.plain are " "both disabled." )
[docs] @SystemBase.ensure_args_is_given def check_deprecated(self) -> "SystemIntegrator": """ Checks or do some deprecation checks. This method will basically check if deprecated keys are still given and provide guidance for end-users. !!! warning The messages are not directly printed, but rather stored in the list. """ if "adblock_aggressive" in f"{colorama.Style.BRIGHT}{colorama.Fore.MAGENTA}The " "'cli_decoding.adblock_aggressive' configuration key has been " "replaced by the 'cli_decoding.aggressive' key but you are " "still setting it." )
[docs] @SystemBase.ensure_args_is_given def start(self) -> "SystemIntegrator": """ Starts a group of actions provided by this interface. """ if hasattr(self.args, "output_location") and self.args.output_location: = os.path.realpath( os.path.join( self.args.output_location,, ) ) self.init_logger() PyFunceble.facility.Logger.debug("Given arguments:\n%r", self.args) self.inject_into_config() self.check_config() self.check_deprecated() PyFunceble.cli.facility.CredentialLoader.start() PyFunceble.cli.factory.DBSession.init_db_sessions() return self