From patchwork Tue Feb 6 04:12:01 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Maxim Cournoyer X-Patchwork-Id: 59862 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id E0DC527BBEC; Tue, 6 Feb 2024 04:18:02 +0000 (GMT) X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-3.7 required=5.0 tests=BAYES_00,DKIM_ADSP_CUSTOM_MED, DKIM_INVALID,DKIM_SIGNED,FREEMAIL_FROM,MAILING_LIST_MULTI, RCVD_IN_MSPIKE_H5,RCVD_IN_MSPIKE_WL,SPF_HELO_PASS,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.6 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id 97CAA27BBEA for ; Tue, 6 Feb 2024 04:18:01 +0000 (GMT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rXCu8-0004gi-VE; Mon, 05 Feb 2024 23:17:52 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rXCu7-0004gE-LJ for guix-patches@gnu.org; Mon, 05 Feb 2024 23:17:51 -0500 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rXCu7-0001Wh-21; Mon, 05 Feb 2024 23:17:51 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rXCuI-0006Eb-3L; Mon, 05 Feb 2024 23:18:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#68946] [RFC PATCH 1/1] guix: Add logging module. Resent-From: Maxim Cournoyer Original-Sender: "Debbugs-submit" Resent-CC: guix@cbaines.net, dev@jpoiret.xyz, ludo@gnu.org, othacehe@gnu.org, rekado@elephly.net, zimon.toutoune@gmail.com, me@tobias.gr, guix-patches@gnu.org Resent-Date: Tue, 06 Feb 2024 04:18:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 68946 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 68946@debbugs.gnu.org Cc: Maxim Cournoyer , Christopher Baines , Josselin Poiret , Ludovic =?utf-8?q?Court=C3=A8s?= , Mathieu Othacehe , Ricardo Wurmus , Simon Tournier , Tobias Geerinckx-Rice X-Debbugs-Original-To: guix-patches@gnu.org X-Debbugs-Original-Xcc: Christopher Baines , Josselin Poiret , Ludovic =?utf-8?q?Court=C3=A8s?= , Mathieu Othacehe , Ricardo Wurmus , Simon Tournier , Tobias Geerinckx-Rice Received: via spool by submit@debbugs.gnu.org id=B.170719302323902 (code B ref -1); Tue, 06 Feb 2024 04:18:02 +0000 Received: (at submit) by debbugs.gnu.org; 6 Feb 2024 04:17:03 +0000 Received: from localhost ([127.0.0.1]:53058 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rXCtL-0006DR-32 for submit@debbugs.gnu.org; Mon, 05 Feb 2024 23:17:03 -0500 Received: from lists.gnu.org ([2001:470:142::17]:35880) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rXCtI-0006Cq-6Y for submit@debbugs.gnu.org; Mon, 05 Feb 2024 23:17:01 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rXCsy-0004a2-Qq for guix-patches@gnu.org; Mon, 05 Feb 2024 23:16:40 -0500 Received: from mail-qv1-xf2b.google.com ([2607:f8b0:4864:20::f2b]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rXCsj-0001TU-Du for guix-patches@gnu.org; Mon, 05 Feb 2024 23:16:39 -0500 Received: by mail-qv1-xf2b.google.com with SMTP id 6a1803df08f44-68c427136b0so24804196d6.1 for ; Mon, 05 Feb 2024 20:16:24 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1707192983; x=1707797783; darn=gnu.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=VqUUYpiTVxa7yGta9HZDpfR36tGK9MZHHNeIqi0knaE=; b=cJpZV1VtJ/dN6VW+Z42mfJNvqgIMaswHDzoixQAXtROx2C8vqqFgQINi10GOZuguBV TztSspz1GM0CmfQybEsBndTjbSmMsn7ETKP2q7h0CusMV9CE+Enz3cx5GnJ5VD7iCPy0 n7Pzhd1AxThCN3421NWEcjOcm+SRFc8kH/WTd+aEdTyS5yBz8i8MtXJ0uchzktFocpe/ eqQF/srV1HIYP+hWM/cwERYrUNhShzt5wfqvl1/JsKii0Rj9wU3/TGEp7l28KpX2h8bT HTBU8WdGVpbQOsbbBYNJJw44DfCN1vfzHbMzLsVEorczUUCbaVPPe4MrwSvpEeWzdKK2 hP+w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1707192983; x=1707797783; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=VqUUYpiTVxa7yGta9HZDpfR36tGK9MZHHNeIqi0knaE=; b=AROsuMel+5yEDrACfotgvWcH1LjV++lahSUGfJOCz7WItVx0WcDPPJo+kCkWRWwrIu A4f/1u1Od/kRnIPBo1s6nqzLrabe/6F2r1CgYzOZ3zEpxt4BtJrM7Ig9cxGw16gNVmdS BfPKGdC71TKkxGO0OJlkY492PMmXVRmFx0KkbfgmCCIL3AjIpuqA+FPICFSGEdJsUoDv /FGHSn6225uGlqHJsztTJFwvoSwS19Pa0ujqyO+jkA8OOh1uaQpSH3bznFJBSx3yGaZM 8kIqdN/muzqoXx8Z5WKIITYt7UJk7FHa92V4KiX2NO2LlN38MZMRTwv3ajwK3DYUhqki Y52g== X-Gm-Message-State: AOJu0YyRZgySobsUogROS+6Zj1QWtFskvSxd2IaAz1sUGs4PF7Uzjhuq nS+p2cd3mwFECQ2QtjUETxAAc3+7CmEr4AHRoshuOojMttlZZyR9A5Rs77Px X-Google-Smtp-Source: AGHT+IEfzBuiQEnjpeh0SGsocf7ljch9pD7SZEmoE6P6tMhUpYDKVVgYKjjoq6V9wCZrt3fsM2oMeA== X-Received: by 2002:ad4:594b:0:b0:68c:aa81:4f2 with SMTP id eo11-20020ad4594b000000b0068caa8104f2mr1442369qvb.13.1707192983533; Mon, 05 Feb 2024 20:16:23 -0800 (PST) Received: from localhost.localdomain (dsl-10-130-152.b2b2c.ca. [72.10.130.152]) by smtp.gmail.com with ESMTPSA id ez4-20020ad45904000000b0068ca41d6c26sm644179qvb.78.2024.02.05.20.16.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 05 Feb 2024 20:16:23 -0800 (PST) From: Maxim Cournoyer Date: Mon, 5 Feb 2024 23:12:01 -0500 Message-ID: <8aa12707e491aa2fc5da48ba3877d368fe5710cf.1707192720.git.maxim.cournoyer@gmail.com> X-Mailer: git-send-email 2.41.0 In-Reply-To: References: MIME-Version: 1.0 Received-SPF: pass client-ip=2607:f8b0:4864:20::f2b; envelope-from=maxim.cournoyer@gmail.com; helo=mail-qv1-xf2b.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, T_SPF_HELO_TEMPERROR=0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org X-getmail-retrieved-from-mailbox: Patches * configure.ac: Require Guile-Lib. * guix/logging.scm: New module. * Makefile.am (MODULES): Register it. * guix/ui.scm (show-guix-help): Document --log-level global option. (%log-level): New parameter. (run-guix-command): Init logging. (run-guix): Parse new --log-level option. Change-Id: I5026a0d62119615fec3cd0131309f9bcc346a7e9 --- Makefile.am | 5 ++- configure.ac | 6 +-- guix/logging.scm | 98 ++++++++++++++++++++++++++++++++++++++++++++++++ guix/ui.scm | 17 ++++++++- 4 files changed, 120 insertions(+), 6 deletions(-) create mode 100644 guix/logging.scm diff --git a/Makefile.am b/Makefile.am index cef972880c..6929ee5f69 100644 --- a/Makefile.am +++ b/Makefile.am @@ -14,7 +14,7 @@ # Copyright © 2018 Oleg Pykhalov # Copyright © 2018 Alex Vong # Copyright © 2019, 2023 Efraim Flashner -# Copyright © 2020, 2021, 2023 Maxim Cournoyer +# Copyright © 2020, 2021, 2023, 2024 Maxim Cournoyer # Copyright © 2021 Chris Marusich # Copyright © 2021 Andrew Tropin # Copyright © 2023 Clément Lassieur @@ -125,7 +125,8 @@ MODULES = \ guix/substitutes.scm \ guix/upstream.scm \ guix/licenses.scm \ - guix/lint.scm \ + guix/lint.scm \ + guix/logging.scm \ guix/glob.scm \ guix/git.scm \ guix/git-authenticate.scm \ diff --git a/configure.ac b/configure.ac index ecbd596a34..133692c033 100644 --- a/configure.ac +++ b/configure.ac @@ -149,12 +149,12 @@ if test "x$guix_cv_have_recent_guile_git" != "xyes"; then AC_MSG_ERROR([A recent Guile-Git could not be found; please install it.]) fi -dnl Check for the optional Guile-Lib. +dnl Require Guile-Lib, for logging and HTML parsing. +GUILE_MODULE_REQUIRED([logging logger]) GUILE_MODULE_EXPORTS([have_guile_lib], [(htmlprag)], [%strict-tokenizer?]) AM_CONDITIONAL([HAVE_GUILE_LIB], [test "x$have_guile_lib" = "xyes"]) AM_COND_IF(HAVE_GUILE_LIB,, - [AC_MSG_WARN([The Guile-Lib requirement was not satisfied (>= 0.2.7); -Some features such as the Go importer will not be usable.])]) + [AC_MSG_ERROR([The Guile-Lib requirement was not satisfied (>= 0.2.7)])]) dnl Check for Guile-zlib. GUIX_CHECK_GUILE_ZLIB diff --git a/guix/logging.scm b/guix/logging.scm new file mode 100644 index 0000000000..913bc9ed3f --- /dev/null +++ b/guix/logging.scm @@ -0,0 +1,98 @@ +;;; GNU Guix --- Functional package management for GNU +;;; Copyright © 2023, 2024 Maxim Cournoyer +;;; +;;; This file is part of GNU Guix. +;;; +;;; GNU Guix 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. +;;; +;;; GNU Guix 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 GNU Guix. If not, see . + +(define-module (guix logging) + #:use-module (logging logger) + #:use-module (logging port-log) + + #:use-module (oop goops) + #:use-module (srfi srfi-209) + + #:export (setup-logging + shutdown-logging + + log-level + log-debug + log-info + log-warning + log-error + log-critical)) + +(define-syntax define-log-level + ;; This macro defines a log-level enum type bound to ENUM-NAME for the + ;; provided levels. The levels should be specified in increasing order of + ;; severity. It also defines 'log-LEVEL' syntax to more conveniently log at + ;; LEVEL, with location information. + (lambda (x) + (define-syntax-rule (id parts ...) + ;; Assemble PARTS into a raw (unhygienic) identifier. + (datum->syntax x (symbol-append (syntax->datum parts) ...))) + + (syntax-case x () + ((_ enum-name (level ...)) + #`(begin + (define enum-name + (make-enum-type '(level ...))) + + #,@(map (lambda (lvl) + (with-syntax ((log (id 'log- lvl)) + (lvl lvl)) + #'(define-syntax log + (lambda (y) + (syntax-case y () + ((log . args) + #`(log-msg + '#,(datum->syntax + y (syntax-source #'log)) + 'lvl #,@#'args))))))) + #'(level ...))))))) + +(define-log-level log-level + (debug info warning error critical)) + +(define* (setup-logging #:key (level 'warning)) + "Configure and open logger at LEVEL)." + (let* ((level-enum (or (enum-name->enum log-level level) + (begin + (format (current-error-port) + "error: invalid log level~%") + (exit 1)))) + (lgr (make )) + (console (make #:port (current-error-port))) + (levels-count (enum-type-size log-level))) + + ;; Register logging handlers. + (add-handler! lgr console) + + ;; Configure the log level. + (let loop ((enum (enum-min log-level))) + (let ((lvl (enum-name enum))) + (unless (eq? level lvl) + (disable-log-level! lgr lvl) + (loop (enum-next enum))))) + + ;; Activate the configured logger. + (set-default-logger! lgr) + (open-log! lgr) + (log-debug "logging initialized"))) + +(define (shutdown-logging) + "Flush and destroy logger." + (flush-log) + (close-log!) + (set-default-logger! #f)) diff --git a/guix/ui.scm b/guix/ui.scm index 962d291d2e..b42d620a0c 100644 --- a/guix/ui.scm +++ b/guix/ui.scm @@ -44,6 +44,7 @@ (define-module (guix ui) #:use-module (guix utils) #:use-module (guix store) #:use-module (guix config) + #:use-module (guix logging) #:use-module (guix packages) #:use-module (guix profiles) #:use-module (guix derivations) @@ -2225,6 +2226,9 @@ (define (show-guix-help) -h, --help display this helpful text again and exit")) (display (G_ " -V, --version display version and copyright information and exit")) + (display (G_ " + --log-level=LEVEL set the logging verbosity to LEVEL, one of + debug, warning, error or critical")) (newline) (newline) @@ -2248,6 +2252,8 @@ (define (show-guix-help) categories)) (show-bug-report-information)) +(define %log-level (make-parameter 'warning)) + (define (run-guix-command command . args) "Run COMMAND with the given ARGS. Report an error when COMMAND is not found." @@ -2282,10 +2288,12 @@ (define (run-guix-command command . args) (symbol-append 'guix- command)))) (parameterize ((program-name command)) (dynamic-wind - (const #f) + (lambda () + (setup-logging #:level (%log-level))) (lambda () (apply command-main args)) (lambda () + (shutdown-logging) ;; Abuse 'exit-hook' (which is normally meant to be used by the ;; REPL) to run things like profiling hooks upon completion. (run-hook exit-hook)))))) @@ -2311,6 +2319,13 @@ (define (run-guix . args) (leave-on-EPIPE (show-guix-help))) ((or ("-V") ("--version")) (show-version-and-exit "guix")) + (((? (cut string-prefix? "--log-level=" <>) o) args ...) + (parameterize ((%log-level (string->symbol + (second (string-split o #\=))))) + (apply run-guix args))) + (("--log-level" level args ...) + (parameterize ((%log-level (string->symbol level))) + (apply run-guix args))) (((? option? o) args ...) (format (current-error-port) (G_ "guix: unrecognized option '~a'~%") o)