#!/usr/bin/env python # Copyright 2011 Corentin Chary # Copyright 2020-2023 src_prepare group # Distributed under the terms of the GNU General Public License v2 import os # Meta __author__ = "Corentin Chary (iksaif)" __email__ = "corentin.chary@gmail.com" __productname__ = "euscan" __description__ = "A tool to detect new upstream releases." # Imports import getopt import sys from errno import EINTR, EINVAL from http.client import HTTPConnection from gentoolkit import pprinter as pp from gentoolkit.errors import GentoolkitException from portage import settings from portage.exception import AmbiguousPackageName from portage.output import green, turquoise, white, yellow from euscan import CONFIG, output from euscan._version import __version__ from euscan.out import progress_bar # Globals isatty = os.environ.get("TERM") != "dumb" and sys.stdout.isatty() isatty_stderr = os.environ.get("TERM") != "dumb" and sys.stderr.isatty() def exit_helper(status): if CONFIG["format"]: print(output.get_formatted_output()) sys.exit(status) def setup_signals(): """This block ensures that ^C interrupts are handled quietly.""" import signal def exithandler(signum, frame): signal.signal(signal.SIGINT, signal.SIG_IGN) signal.signal(signal.SIGTERM, signal.SIG_IGN) print() exit_helper(EINTR) signal.signal(signal.SIGINT, exithandler) signal.signal(signal.SIGTERM, exithandler) signal.signal(signal.SIGPIPE, signal.SIG_DFL) def print_version(): """Output the version info.""" print("%s (%s) - %s" % (__productname__, __version__, __description__)) print() print("Author: %s <%s>" % (__author__, __email__)) print("Copyright 2011 Gentoo Foundation") print("Distributed under the terms of the GNU General Public License v2") def print_usage(_error=None, help=None): """Print help message. May also print partial help to stderr if an error from {'options'} is specified.""" out = sys.stdout if _error: out = sys.stderr if _error not in ( "global-options", "packages", ): _error = None if not _error and not help: help = "all" if _error in ("global-options",): output.eerror("Wrong option on command line.\n") if _error in ("packages",): output.eerror("You need to specify exactly one package.\n") print(white("Usage:"), file=out) if ( _error in ( "global-options", "packages", ) or help == "all" ): print( " " + turquoise(__productname__), yellow("[options]"), green(" [ [...]]"), file=out, ) if _error in ("global-options",) or help == "all": print(" " + turquoise(__productname__), yellow("[--help, --version]"), file=out) print(file=out) if _error in ("global-options",) or help: print("Available ", yellow("options") + ":", file=out) print( yellow(" -C, --nocolor") + " - turn off colors on output", file=out, ) print( yellow(" -q, --quiet") + " - be as quiet as possible", file=out, ) print( yellow(" -h, --help") + " - display the help screen", file=out, ) print( yellow(" -V, --version") + " - display version info", file=out, ) print(file=out) print( yellow(" -1, --oneshot") + " - stop as soon as a new version is found", file=out, ) print( yellow(" -b, --brute-force=") + " - define the brute force " + yellow("") + " (default: 2)\n" + " " * 38 + "bigger levels will generate more versions numbers\n" + " " * 38 + "0 means disabled", file=out, ) print( yellow(" -f, --format=") + " - define the output " + yellow("") + " (available: json, xml)", file=out, ) print( yellow(" -p, --progress") + " - display a progress bar", file=out, ) print( yellow(" -i, --ignore-pre-release") + " " * 11 + "- Ignore non-stable versions", file=out, ) print( yellow(" -I, --ignore-pre-release-if-stable") + " - Ignore non-stable versions only if current\n" + " " * 38 + "version is stable", file=out, ) print( yellow(" --mirror") + " - use mirror:// URIs", file=out, ) print( yellow(" --ebuild-uri") + " - use ebuild variables in URIs", file=out, ) print( yellow(" --no-handlers") + " - exclude handlers (comma-separated list)", file=out, ) print(file=out) if _error in ("packages",) or help: print( green(" package") + " " * 28 + "- the packages (or ebuilds) you want to scan", file=out, ) print(file=out) # print( "More detailed instruction can be found in", # turquoise("`man %s`" % __productname__), file=out) class ParseArgsException(Exception): """For parseArgs() -> main() communications.""" def __init__(self, value): self.value = value def __str__(self): return repr(self.value) def parse_args(): """Parse the command line arguments. Raise exceptions on errors. Returns packages and affects the CONFIG dict. """ def option_switch(opts): """local function for interpreting command line options and setting options accordingly""" return_code = True for o, a in opts: if o in ("-h", "--help"): raise ParseArgsException("help") elif o in ("-V", "--version"): raise ParseArgsException("version") elif o in ("-C", "--nocolor"): CONFIG["nocolor"] = True pp.output.nocolor() elif o in ("-q", "--quiet"): CONFIG["quiet"] = True CONFIG["verbose"] = 0 elif o in ("-1", "--oneshot"): CONFIG["oneshot"] = True elif o in ("-b", "--brute-force"): CONFIG["brute-force"] = int(a) elif o in ("-v", "--verbose") and not CONFIG["quiet"]: CONFIG["verbose"] += 1 elif o in ("-f", "--format"): CONFIG["format"] = a CONFIG["nocolor"] = True pp.output.nocolor() elif o in ("-p", "--progress"): CONFIG["progress"] = isatty_stderr elif o in ("--mirror"): CONFIG["mirror"] = True elif o in ("-i", "--ignore-pre-release"): CONFIG["ignore-pre-release"] = True elif o in ("-I", "--ignore-pre-release-if-stable"): CONFIG["ignore-pre-release-if-stable"] = True elif o in ("--ebuild-uri"): CONFIG["ebuild-uri"] = True elif o in ("--no-handlers"): CONFIG["handlers-exclude"] = a.split(",") else: return_code = False return return_code # here are the different allowed command line options (getopt args) getopt_options = {"short": {}, "long": {}} getopt_options["short"]["global"] = "hVCqv1b:f:piI" getopt_options["long"]["global"] = [ "help", "version", "nocolor", "quiet", "verbose", "oneshot", "brute-force=", "format=", "progress", "mirror", "ignore-pre-release", "ignore-pre-release-if-stable", "ebuild-uri", "no-handlers=", ] short_opts = getopt_options["short"]["global"] long_opts = getopt_options["long"]["global"] opts_mode = "global" # apply getopts to command line, show partial help on failure try: opts, args = getopt.getopt(sys.argv[1:], short_opts, long_opts) except getopt.GetoptError: raise ParseArgsException(opts_mode + "-options") # set options accordingly option_switch(opts) if len(args) < 1: raise ParseArgsException("packages") return args def main(): """Parse command line and execute all actions.""" CONFIG["nocolor"] = CONFIG["nocolor"] or ( settings["NOCOLOR"] in ("yes", "true") or not isatty ) if CONFIG["nocolor"]: pp.output.nocolor() # parse command line options and actions try: queries = parse_args() except ParseArgsException as e: if e.value == "help": print_usage(help="all") exit_helper(0) elif e.value[:5] == "help-": print_usage(help=e.value[5:]) exit_helper(0) elif e.value == "version": print_version() exit_helper(0) else: print_usage(e.value) exit_helper(EINVAL) if CONFIG["verbose"] > 2: HTTPConnection.debuglevel = 1 if not CONFIG["format"] and not CONFIG["quiet"]: CONFIG["progress"] = False on_progress = None if CONFIG["progress"]: on_progress_gen = progress_bar() on_progress = next(on_progress_gen) on_progress(maxval=len(queries) * 100, increment=0, label="Working...") # Importing stuff here for performance reasons from euscan.scan import scan_upstream for query in queries: if CONFIG["progress"]: on_progress(increment=10, label=query) ret = [] output.set_query(query) try: ret = scan_upstream(query, on_progress) except AmbiguousPackageName as e: pkgs = e.args[0] output.eerror("\n".join(pkgs)) from os.path import basename # To get the short name output.eerror( "The short ebuild name '%s' is ambiguous. Please specify" % basename(pkgs[0]) + "one of the above fully-qualified ebuild names instead." ) exit_helper(1) except GentoolkitException as err: output.eerror("%s: %s" % (query, str(err))) exit_helper(1) except Exception as err: import traceback print("-" * 60) traceback.print_exc(file=sys.stderr) print("-" * 60) output.eerror("%s: %s" % (query, str(err))) exit_helper(1) if not ret and not CONFIG["quiet"]: output.einfo( "Didn't find any new version, check package's homepage " + "for more informations" ) if not (CONFIG["format"] or CONFIG["quiet"]) and len(queries) > 1: print("") if CONFIG["progress"]: next(on_progress_gen) print("\n", file=sys.stderr) output.set_query(None) if __name__ == "__main__": setup_signals() main() exit_helper(0)