Show a cover letter.

GET /api/covers/574/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 574,
    "url": "http://patchwork.dpdk.org/api/covers/574/?format=api",
    "web_url": "http://patchwork.dpdk.org/project/dpdk/cover/20240122182611.1904974-1-luca.vizzarro@arm.com/",
    "project": {
        "id": 1,
        "url": "http://patchwork.dpdk.org/api/projects/1/?format=api",
        "name": "DPDK",
        "link_name": "dpdk",
        "list_id": "dev.dpdk.org",
        "list_email": "dev@dpdk.org",
        "web_url": "http://core.dpdk.org",
        "scm_url": "git://dpdk.org/dpdk",
        "webscm_url": "http://git.dpdk.org/dpdk",
        "list_archive_url": "https://inbox.dpdk.org/dev",
        "list_archive_url_format": "https://inbox.dpdk.org/dev/{}",
        "commit_url_format": ""
    },
    "msgid": "<20240122182611.1904974-1-luca.vizzarro@arm.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20240122182611.1904974-1-luca.vizzarro@arm.com",
    "date": "2024-01-22T18:26:07",
    "name": "[0/4] dts: error and usage improvements",
    "submitter": {
        "id": 3197,
        "url": "http://patchwork.dpdk.org/api/people/3197/?format=api",
        "name": "Luca Vizzarro",
        "email": "luca.vizzarro@arm.com"
    },
    "mbox": "http://patchwork.dpdk.org/project/dpdk/cover/20240122182611.1904974-1-luca.vizzarro@arm.com/mbox/",
    "series": [
        {
            "id": 30879,
            "url": "http://patchwork.dpdk.org/api/series/30879/?format=api",
            "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=30879",
            "date": "2024-01-22T18:26:07",
            "name": "dts: error and usage improvements",
            "version": 1,
            "mbox": "http://patchwork.dpdk.org/series/30879/mbox/"
        }
    ],
    "comments": "http://patchwork.dpdk.org/api/covers/574/comments/",
    "headers": {
        "Return-Path": "<dev-bounces@dpdk.org>",
        "X-Original-To": "patchwork@inbox.dpdk.org",
        "Delivered-To": "patchwork@inbox.dpdk.org",
        "Received": [
            "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 7BE514399C;\n\tMon, 22 Jan 2024 19:26:35 +0100 (CET)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 48EB2402C3;\n\tMon, 22 Jan 2024 19:26:35 +0100 (CET)",
            "from foss.arm.com (foss.arm.com [217.140.110.172])\n by mails.dpdk.org (Postfix) with ESMTP id F2ECD40298\n for <dev@dpdk.org>; Mon, 22 Jan 2024 19:26:33 +0100 (CET)",
            "from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14])\n by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 781561FB;\n Mon, 22 Jan 2024 10:27:19 -0800 (PST)",
            "from localhost.localdomain (unknown [10.57.90.210])\n by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPA id AF5753F762;\n Mon, 22 Jan 2024 10:26:32 -0800 (PST)"
        ],
        "From": "Luca Vizzarro <luca.vizzarro@arm.com>",
        "To": "dev@dpdk.org",
        "Cc": "Luca Vizzarro <luca.vizzarro@arm.com>,\n =?utf-8?q?Juraj_Linke=C5=A1?= <juraj.linkes@pantheon.tech>,\n Paul Szczepanek <paul.szczepanek@arm.com>",
        "Subject": "[PATCH 0/4] dts: error and usage improvements",
        "Date": "Mon, 22 Jan 2024 18:26:07 +0000",
        "Message-Id": "<20240122182611.1904974-1-luca.vizzarro@arm.com>",
        "X-Mailer": "git-send-email 2.34.1",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain; charset=UTF-8",
        "Content-Transfer-Encoding": "8bit",
        "X-BeenThere": "dev@dpdk.org",
        "X-Mailman-Version": "2.1.29",
        "Precedence": "list",
        "List-Id": "DPDK patches and discussions <dev.dpdk.org>",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>",
        "List-Archive": "<http://mails.dpdk.org/archives/dev/>",
        "List-Post": "<mailto:dev@dpdk.org>",
        "List-Help": "<mailto:dev-request@dpdk.org?subject=help>",
        "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>",
        "Errors-To": "dev-bounces@dpdk.org"
    },
    "content": "As mentioned in my previous DTS docs improvement patch series, here are\nsome usage improvements to DTS. The main purpose is to give the\nfirst-time user of DTS some more meaningful messages of its usage.\n\nSecondly, report back stderr to the user when remote commands fail. For\nexample, if DTS tries to run any program which is not installed on the\ntarget node, it will just say that it failed with its return code. The\nonly way to see the actual error message is through the DEBUG level of\nverbosity. Rightfully though, errors should be logged as ERROR.\n\nBest,\nLuca\n\nLuca Vizzarro (4):\n  dts: constrain DPDK source flag\n  dts: customise argparse error message\n  dts: show help when DTS is ran without args\n  dts: log stderr with failed remote commands\n\n doc/guides/tools/dts.rst                      |  8 +-\n dts/framework/exception.py                    | 10 ++-\n .../remote_session/remote_session.py          |  2 +-\n dts/framework/settings.py                     | 83 ++++++++++++++-----\n dts/framework/utils.py                        | 43 ++++++----\n 5 files changed, 104 insertions(+), 42 deletions(-)"
}