Show a patch.

GET /api/1.1/patches/22752/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 22752,
    "url": "https://patchwork.libcamera.org/api/1.1/patches/22752/?format=api",
    "web_url": "https://patchwork.libcamera.org/patch/22752/",
    "project": {
        "id": 1,
        "url": "https://patchwork.libcamera.org/api/1.1/projects/1/?format=api",
        "name": "libcamera",
        "link_name": "libcamera",
        "list_id": "libcamera_core",
        "list_email": "libcamera-devel@lists.libcamera.org",
        "web_url": "",
        "scm_url": "",
        "webscm_url": ""
    },
    "msgid": "<20250206161607.50738-7-mzamazal@redhat.com>",
    "date": "2025-02-06T16:15:57",
    "name": "[v7,06/15] config: Look up log color configuration in configuration file",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": false,
    "hash": "c3869248d69c79e9124c2f6636df1d2319220dd9",
    "submitter": {
        "id": 177,
        "url": "https://patchwork.libcamera.org/api/1.1/people/177/?format=api",
        "name": "Milan Zamazal",
        "email": "mzamazal@redhat.com"
    },
    "delegate": null,
    "mbox": "https://patchwork.libcamera.org/patch/22752/mbox/",
    "series": [
        {
            "id": 4993,
            "url": "https://patchwork.libcamera.org/api/1.1/series/4993/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=4993",
            "date": "2025-02-06T16:15:51",
            "name": "Add global configuration file",
            "version": 7,
            "mbox": "https://patchwork.libcamera.org/series/4993/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/patches/22752/comments/",
    "check": "pending",
    "checks": "https://patchwork.libcamera.org/api/patches/22752/checks/",
    "tags": {},
    "headers": {
        "Return-Path": "<libcamera-devel-bounces@lists.libcamera.org>",
        "X-Original-To": "parsemail@patchwork.libcamera.org",
        "Delivered-To": "parsemail@patchwork.libcamera.org",
        "Received": [
            "from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id B6978C32EF\n\tfor <parsemail@patchwork.libcamera.org>;\n\tThu,  6 Feb 2025 16:16:39 +0000 (UTC)",
            "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 70DD668604;\n\tThu,  6 Feb 2025 17:16:39 +0100 (CET)",
            "from us-smtp-delivery-124.mimecast.com\n\t(us-smtp-delivery-124.mimecast.com [170.10.129.124])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 6F6F068601\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tThu,  6 Feb 2025 17:16:36 +0100 (CET)",
            "from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com\n\t(ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97])\n\tby relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3,\n\tcipher=TLS_AES_256_GCM_SHA384) id us-mta-45-Dbv_sSFqMOOdpDVReLYizQ-1;\n\tThu, 06 Feb 2025 11:16:32 -0500",
            "from mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com\n\t(mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com\n\t[10.30.177.111])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\tkey-exchange X25519 server-signature RSA-PSS (2048 bits)\n\tserver-digest SHA256) (No client certificate requested)\n\tby mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix)\n\twith ESMTPS id B7E9C180087C; Thu,  6 Feb 2025 16:16:30 +0000 (UTC)",
            "from mzamazal-thinkpadp1gen3.tpbc.com (unknown [10.43.17.31])\n\tby mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix)\n\twith ESMTP id C9537180035E; Thu,  6 Feb 2025 16:16:28 +0000 (UTC)"
        ],
        "Authentication-Results": "lancelot.ideasonboard.com; dkim=pass (1024-bit key;\n\tunprotected) header.d=redhat.com header.i=@redhat.com\n\theader.b=\"W3JYOWJX\"; dkim-atps=neutral",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;\n\ts=mimecast20190719; t=1738858595;\n\th=from:from:reply-to:subject:subject:date:date:message-id:message-id:\n\tto:to:cc:cc:mime-version:mime-version:content-type:content-type:\n\tcontent-transfer-encoding:content-transfer-encoding:\n\tin-reply-to:in-reply-to:references:references;\n\tbh=IamKR6qNQ0HDTd0P4l5oY3buSEv3W8F2sXxtMq3EJLY=;\n\tb=W3JYOWJXsGBqntMoZNYjhAuV0fRfuzuL7lCvDXjUiBCU0kp23td20VbTySw+Is/NZmBKTU\n\tGjjMGpyc5F+rIADwECdNfotr/S6MQhqP2IDzY2GnhpgIMdcwV+4UBWipm9b9W5CJAK+djp\n\tVG+z4Fe0riq/6jSScaEzx5cxJtPCvKw=",
        "X-MC-Unique": "Dbv_sSFqMOOdpDVReLYizQ-1",
        "X-Mimecast-MFC-AGG-ID": "Dbv_sSFqMOOdpDVReLYizQ",
        "From": "Milan Zamazal <mzamazal@redhat.com>",
        "To": "libcamera-devel@lists.libcamera.org",
        "Cc": "Milan Zamazal <mzamazal@redhat.com>, Kieran Bingham\n\t<kieran.bingham@ideasonboard.com>, Naushir Patuck\n\t<naush@raspberrypi.com>, =?utf-8?q?Barnab=C3=A1s_P=C5=91cze?=\n\t<pobrn@protonmail.com>, Laurent Pinchart\n\t<laurent.pinchart@ideasonboard.com>",
        "Subject": "[PATCH v7 06/15] config: Look up log color configuration in\n\tconfiguration file",
        "Date": "Thu,  6 Feb 2025 17:15:57 +0100",
        "Message-ID": "<20250206161607.50738-7-mzamazal@redhat.com>",
        "In-Reply-To": "<20250206161607.50738-1-mzamazal@redhat.com>",
        "References": "<20250206161607.50738-1-mzamazal@redhat.com>",
        "MIME-Version": "1.0",
        "X-Scanned-By": "MIMEDefang 3.4.1 on 10.30.177.111",
        "X-Mimecast-Spam-Score": "0",
        "X-Mimecast-MFC-PROC-ID": "TRqvP1a591HQ3wDKl7j1bpbTbbGZ2fKF2_7q2-U_uOw_1738858591",
        "X-Mimecast-Originator": "redhat.com",
        "Content-Transfer-Encoding": "8bit",
        "content-type": "text/plain; charset=\"US-ASCII\"; x-default=true",
        "X-BeenThere": "libcamera-devel@lists.libcamera.org",
        "X-Mailman-Version": "2.1.29",
        "Precedence": "list",
        "List-Id": "<libcamera-devel.lists.libcamera.org>",
        "List-Unsubscribe": "<https://lists.libcamera.org/options/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=unsubscribe>",
        "List-Archive": "<https://lists.libcamera.org/pipermail/libcamera-devel/>",
        "List-Post": "<mailto:libcamera-devel@lists.libcamera.org>",
        "List-Help": "<mailto:libcamera-devel-request@lists.libcamera.org?subject=help>",
        "List-Subscribe": "<https://lists.libcamera.org/listinfo/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=subscribe>",
        "Errors-To": "libcamera-devel-bounces@lists.libcamera.org",
        "Sender": "\"libcamera-devel\" <libcamera-devel-bounces@lists.libcamera.org>"
    },
    "content": "Let's add a configuration file item for logging in color.\n\nThe configuration snippet:\n\n  configuration:\n    log:\n      color: BOOL\n\nIn order to use the global configuration access helper for a boolean\nvalue, we must make a template from it.  To make the template visible,\nwe must implement it in the header file, otherwise undefined reference\nerror would be reported when linking.\n\nWe don't implement envOption helper for boolean here, because we would\nhave to deal with a specific value interpretation in this particular\ncase.\n\nSigned-off-by: Milan Zamazal <mzamazal@redhat.com>\n---\n .../libcamera/internal/global_configuration.h | 27 ++++++++++++++++++-\n src/libcamera/base/global_configuration.cpp   | 19 ++++---------\n src/libcamera/base/log.cpp                    |  2 ++\n 3 files changed, 33 insertions(+), 15 deletions(-)",
    "diff": "diff --git a/include/libcamera/internal/global_configuration.h b/include/libcamera/internal/global_configuration.h\nindex 07062145..a6e21a2d 100644\n--- a/include/libcamera/internal/global_configuration.h\n+++ b/include/libcamera/internal/global_configuration.h\n@@ -10,6 +10,8 @@\n #include <optional>\n #include <string>\n \n+#include <libcamera/base/utils.h>\n+\n #include \"libcamera/internal/yaml_parser.h\"\n \n namespace libcamera {\n@@ -22,7 +24,30 @@ void initialize();\n \n unsigned int version();\n Configuration configuration();\n-std::optional<std::string> option(const std::string &confPath);\n+\n+template<typename T,\n+\t std::enable_if_t<\n+\t\t std::is_same_v<bool, T> ||\n+\t\t std::is_same_v<double, T> ||\n+\t\t std::is_same_v<int8_t, T> ||\n+\t\t std::is_same_v<uint8_t, T> ||\n+\t\t std::is_same_v<int16_t, T> ||\n+\t\t std::is_same_v<uint16_t, T> ||\n+\t\t std::is_same_v<int32_t, T> ||\n+\t\t std::is_same_v<uint32_t, T> ||\n+\t\t std::is_same_v<std::string, T> ||\n+\t\t std::is_same_v<Size, T>> * = nullptr>\n+std::optional<T> option(const std::string &confPath)\n+{\n+\tconst YamlObject *c = &configuration();\n+\tfor (auto part : utils::split(confPath, \".\")) {\n+\t\tc = &(*c)[part];\n+\t\tif (!*c)\n+\t\t\treturn {};\n+\t}\n+\treturn c->get<T>();\n+}\n+\n std::optional<std::string> envOption(const char *const envVariable,\n \t\t\t\t     const std::string &confPath);\n \ndiff --git a/src/libcamera/base/global_configuration.cpp b/src/libcamera/base/global_configuration.cpp\nindex 073096b5..3dc31c48 100644\n--- a/src/libcamera/base/global_configuration.cpp\n+++ b/src/libcamera/base/global_configuration.cpp\n@@ -14,7 +14,6 @@\n \n #include <libcamera/base/file.h>\n #include <libcamera/base/log.h>\n-#include <libcamera/base/utils.h>\n \n #include \"libcamera/internal/yaml_parser.h\"\n \n@@ -144,22 +143,14 @@ void initialize()\n  */\n \n /**\n+ * \\fn std::optional<T> GlobalConfiguration::option(const char *const confPath)\n  * \\brief Return value of the configuration option identified by \\a confPath\n+ * \\tparam T The type of the retrieved configuration value\n  * \\param[in] confPath Sequence of the YAML section names (excluding\n  * `configuration') leading to the requested option separated by dots\n- * \\return A value if an item corresponding to \\a confPath exists in the\n- * configuration file, no value otherwise\n+ * \\return A value of type \\a T if an item corresponding to \\a confPath exists\n+ * in the configuration file and matches type \\a T, no value otherwise\n  */\n-std::optional<std::string> option(const std::string &confPath)\n-{\n-\tconst YamlObject *c = &configuration();\n-\tfor (auto part : utils::split(confPath, \".\")) {\n-\t\tc = &(*c)[part];\n-\t\tif (!*c)\n-\t\t\treturn {};\n-\t}\n-\treturn c->get<std::string>();\n-}\n \n /**\n  * \\brief Return value of the configuration option from a file or environment\n@@ -185,7 +176,7 @@ std::optional<std::string> envOption(\n \tconst char *envValue = utils::secure_getenv(envVariable);\n \tif (envValue)\n \t\treturn std::optional{ std::string{ envValue } };\n-\treturn option(confPath);\n+\treturn option<std::string>(confPath);\n }\n \n /**\ndiff --git a/src/libcamera/base/log.cpp b/src/libcamera/base/log.cpp\nindex 07352f6c..d522e895 100644\n--- a/src/libcamera/base/log.cpp\n+++ b/src/libcamera/base/log.cpp\n@@ -590,6 +590,8 @@ void Logger::logSetLevel(const char *category, const char *level)\n Logger::Logger()\n {\n \tbool color = !utils::secure_getenv(\"LIBCAMERA_LOG_NO_COLOR\");\n+\tif (color)\n+\t\tcolor = GlobalConfiguration::option<bool>(\"log.color\").value_or(true);\n \tlogSetStream(&std::cerr, color);\n \n \tparseLogFile();\n",
    "prefixes": [
        "v7",
        "06/15"
    ]
}