# Licensed under the GPL: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html # For details: https://github.com/PyCQA/pylint/blob/master/COPYING import os import sys from pylint import __pkginfo__, config, extensions, interfaces from pylint.lint.pylinter import PyLinter from pylint.lint.utils import ArgumentPreprocessingError, preprocess_options from pylint.utils import utils try: import multiprocessing except ImportError: multiprocessing = None # type: ignore def _cpu_count() -> int: """Use sched_affinity if available for virtualized or containerized environments.""" sched_getaffinity = getattr(os, "sched_getaffinity", None) # pylint: disable=not-callable,using-constant-test if sched_getaffinity: return len(sched_getaffinity(0)) if multiprocessing: return multiprocessing.cpu_count() return 1 def cb_list_extensions(option, optname, value, parser): """List all the extensions under pylint.extensions""" for filename in os.listdir(os.path.dirname(extensions.__file__)): if filename.endswith(".py") and not filename.startswith("_"): extension_name, _, _ = filename.partition(".") print("pylint.extensions.{}".format(extension_name)) sys.exit(0) def cb_list_confidence_levels(option, optname, value, parser): for level in interfaces.CONFIDENCE_LEVELS: print("%-18s: %s" % level) sys.exit(0) def cb_init_hook(optname, value): """exec arbitrary code to set sys.path for instance""" exec(value) # pylint: disable=exec-used class Run: """helper class to use as main for pylint : run(*sys.argv[1:]) """ LinterClass = PyLinter option_groups = ( ( "Commands", "Options which are actually commands. Options in this \ group are mutually exclusive.", ), ) @staticmethod def _return_one(*args): # pylint: disable=unused-argument return 1 def __init__(self, args, reporter=None, do_exit=True): self._rcfile = None self._plugins = [] self.verbose = None try: preprocess_options( args, { # option: (callback, takearg) "init-hook": (cb_init_hook, True), "rcfile": (self.cb_set_rcfile, True), "load-plugins": (self.cb_add_plugins, True), "verbose": (self.cb_verbose_mode, False), }, ) except ArgumentPreprocessingError as ex: print(ex, file=sys.stderr) sys.exit(32) self.linter = linter = self.LinterClass( ( ( "rcfile", { "action": "callback", "callback": Run._return_one, "group": "Commands", "type": "string", "metavar": "", "help": "Specify a configuration file to load.", }, ), ( "init-hook", { "action": "callback", "callback": Run._return_one, "type": "string", "metavar": "", "level": 1, "help": "Python code to execute, usually for sys.path " "manipulation such as pygtk.require().", }, ), ( "help-msg", { "action": "callback", "type": "string", "metavar": "", "callback": self.cb_help_message, "group": "Commands", "help": "Display a help message for the given message id and " "exit. The value may be a comma separated list of message ids.", }, ), ( "list-msgs", { "action": "callback", "metavar": "", "callback": self.cb_list_messages, "group": "Commands", "level": 1, "help": "Generate pylint's messages.", }, ), ( "list-msgs-enabled", { "action": "callback", "metavar": "", "callback": self.cb_list_messages_enabled, "group": "Commands", "level": 1, "help": "Display a list of what messages are enabled " "and disabled with the given configuration.", }, ), ( "list-groups", { "action": "callback", "metavar": "", "callback": self.cb_list_groups, "group": "Commands", "level": 1, "help": "List pylint's message groups.", }, ), ( "list-conf-levels", { "action": "callback", "callback": cb_list_confidence_levels, "group": "Commands", "level": 1, "help": "Generate pylint's confidence levels.", }, ), ( "list-extensions", { "action": "callback", "callback": cb_list_extensions, "group": "Commands", "level": 1, "help": "List available extensions.", }, ), ( "full-documentation", { "action": "callback", "metavar": "", "callback": self.cb_full_documentation, "group": "Commands", "level": 1, "help": "Generate pylint's full documentation.", }, ), ( "generate-rcfile", { "action": "callback", "callback": self.cb_generate_config, "group": "Commands", "help": "Generate a sample configuration file according to " "the current configuration. You can put other options " "before this one to get them in the generated " "configuration.", }, ), ( "generate-man", { "action": "callback", "callback": self.cb_generate_manpage, "group": "Commands", "help": "Generate pylint's man page.", "hide": True, }, ), ( "errors-only", { "action": "callback", "callback": self.cb_error_mode, "short": "E", "help": "In error mode, checkers without error messages are " "disabled and for others, only the ERROR messages are " "displayed, and no reports are done by default.", }, ), ( "py3k", { "action": "callback", "callback": self.cb_python3_porting_mode, "help": "In Python 3 porting mode, all checkers will be " "disabled and only messages emitted by the porting " "checker will be displayed.", }, ), ( "verbose", { "action": "callback", "callback": self.cb_verbose_mode, "short": "v", "help": "In verbose mode, extra non-checker-related info " "will be displayed.", }, ), ), option_groups=self.option_groups, pylintrc=self._rcfile, ) # register standard checkers linter.load_default_plugins() # load command line plugins linter.load_plugin_modules(self._plugins) # add some help section linter.add_help_section("Environment variables", config.ENV_HELP, level=1) # pylint: disable=bad-continuation linter.add_help_section( "Output", "Using the default text output, the message format is : \n" " \n" " MESSAGE_TYPE: LINE_NUM:[OBJECT:] MESSAGE \n" " \n" "There are 5 kind of message types : \n" " * (C) convention, for programming standard violation \n" " * (R) refactor, for bad code smell \n" " * (W) warning, for python specific problems \n" " * (E) error, for probable bugs in the code \n" " * (F) fatal, if an error occurred which prevented pylint from doing further\n" "processing.\n", level=1, ) linter.add_help_section( "Output status code", "Pylint should leave with following status code: \n" " * 0 if everything went fine \n" " * 1 if a fatal message was issued \n" " * 2 if an error message was issued \n" " * 4 if a warning message was issued \n" " * 8 if a refactor message was issued \n" " * 16 if a convention message was issued \n" " * 32 on usage error \n" " \n" "status 1 to 16 will be bit-ORed so you can know which different categories has\n" "been issued by analysing pylint output status code\n", level=1, ) # read configuration linter.disable("I") linter.enable("c-extension-no-member") linter.read_config_file(verbose=self.verbose) config_parser = linter.cfgfile_parser # run init hook, if present, before loading plugins if config_parser.has_option("MASTER", "init-hook"): cb_init_hook( "init-hook", utils._unquote(config_parser.get("MASTER", "init-hook")) ) # is there some additional plugins in the file configuration, in if config_parser.has_option("MASTER", "load-plugins"): plugins = utils._splitstrip(config_parser.get("MASTER", "load-plugins")) linter.load_plugin_modules(plugins) # now we can load file config and command line, plugins (which can # provide options) have been registered linter.load_config_file() if reporter: # if a custom reporter is provided as argument, it may be overridden # by file parameters, so re-set it here, but before command line # parsing so it's still overrideable by command line option linter.set_reporter(reporter) try: args = linter.load_command_line_configuration(args) except SystemExit as exc: if exc.code == 2: # bad options exc.code = 32 raise if not args: print(linter.help()) sys.exit(32) if linter.config.jobs < 0: print( "Jobs number (%d) should be greater than or equal to 0" % linter.config.jobs, file=sys.stderr, ) sys.exit(32) if linter.config.jobs > 1 or linter.config.jobs == 0: if multiprocessing is None: print( "Multiprocessing library is missing, " "fallback to single process", file=sys.stderr, ) linter.set_option("jobs", 1) elif linter.config.jobs == 0: linter.config.jobs = _cpu_count() # We have loaded configuration from config file and command line. Now, we can # load plugin specific configuration. linter.load_plugin_configuration() linter.check(args) score_value = linter.generate_reports() if do_exit: if linter.config.exit_zero: sys.exit(0) else: if score_value and score_value > linter.config.fail_under: sys.exit(0) sys.exit(self.linter.msg_status) def cb_set_rcfile(self, name, value): """callback for option preprocessing (i.e. before option parsing)""" self._rcfile = value def cb_add_plugins(self, name, value): """callback for option preprocessing (i.e. before option parsing)""" self._plugins.extend(utils._splitstrip(value)) def cb_error_mode(self, *args, **kwargs): """error mode: * disable all but error messages * disable the 'miscellaneous' checker which can be safely deactivated in debug * disable reports * do not save execution information """ self.linter.error_mode() def cb_generate_config(self, *args, **kwargs): """optik callback for sample config file generation""" self.linter.generate_config(skipsections=("COMMANDS",)) sys.exit(0) def cb_generate_manpage(self, *args, **kwargs): """optik callback for sample config file generation""" self.linter.generate_manpage(__pkginfo__) sys.exit(0) def cb_help_message(self, option, optname, value, parser): """optik callback for printing some help about a particular message""" self.linter.msgs_store.help_message(utils._splitstrip(value)) sys.exit(0) def cb_full_documentation(self, option, optname, value, parser): """optik callback for printing full documentation""" self.linter.print_full_documentation() sys.exit(0) def cb_list_messages(self, option, optname, value, parser): """optik callback for printing available messages""" self.linter.msgs_store.list_messages() sys.exit(0) def cb_list_messages_enabled(self, option, optname, value, parser): """optik callback for printing available messages""" self.linter.list_messages_enabled() sys.exit(0) def cb_list_groups(self, *args, **kwargs): """List all the check groups that pylint knows about These should be useful to know what check groups someone can disable or enable. """ for check in self.linter.get_checker_names(): print(check) sys.exit(0) def cb_python3_porting_mode(self, *args, **kwargs): """Activate only the python3 porting checker.""" self.linter.python3_porting_mode() def cb_verbose_mode(self, *args, **kwargs): self.verbose = True