Show a cover letter.

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

{
    "id": 442,
    "url": "http://patches.dpdk.org/api/covers/442/?format=api",
    "web_url": "http://patches.dpdk.org/project/ci/cover/20231128210155.1388785-1-aconole@redhat.com/",
    "project": {
        "id": 5,
        "url": "http://patches.dpdk.org/api/projects/5/?format=api",
        "name": "CI",
        "link_name": "ci",
        "list_id": "ci.dpdk.org",
        "list_email": "ci@dpdk.org",
        "web_url": "",
        "scm_url": "git://dpdk.org/tools/dpdk-ci",
        "webscm_url": "https://git.dpdk.org/tools/dpdk-ci/",
        "list_archive_url": "https://inbox.dpdk.org/ci",
        "list_archive_url_format": "https://inbox.dpdk.org/ci/{}",
        "commit_url_format": ""
    },
    "msgid": "<20231128210155.1388785-1-aconole@redhat.com>",
    "list_archive_url": "https://inbox.dpdk.org/ci/20231128210155.1388785-1-aconole@redhat.com",
    "date": "2023-11-28T21:01:51",
    "name": "[v3,0/3] Add a recheck framework to pw-ci",
    "submitter": {
        "id": 332,
        "url": "http://patches.dpdk.org/api/people/332/?format=api",
        "name": "Aaron Conole",
        "email": "aconole@redhat.com"
    },
    "mbox": "http://patches.dpdk.org/project/ci/cover/20231128210155.1388785-1-aconole@redhat.com/mbox/",
    "series": [
        {
            "id": 30408,
            "url": "http://patches.dpdk.org/api/series/30408/?format=api",
            "web_url": "http://patches.dpdk.org/project/ci/list/?series=30408",
            "date": "2023-11-28T21:01:52",
            "name": "Add a recheck framework to pw-ci",
            "version": 3,
            "mbox": "http://patches.dpdk.org/series/30408/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/442/comments/",
    "headers": {
        "Return-Path": "<ci-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 28136433F8;\n\tTue, 28 Nov 2023 22:02:03 +0100 (CET)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 1DC9942E16;\n\tTue, 28 Nov 2023 22:02:03 +0100 (CET)",
            "from us-smtp-delivery-124.mimecast.com\n (us-smtp-delivery-124.mimecast.com [170.10.129.124])\n by mails.dpdk.org (Postfix) with ESMTP id DB84C410FD\n for <ci@dpdk.org>; Tue, 28 Nov 2023 22:02:00 +0100 (CET)",
            "from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com\n [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS\n (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id\n us-mta-27-Md5p89KEOr-i7X_4G_fQDQ-1; Tue, 28 Nov 2023 16:01:57 -0500",
            "from smtp.corp.redhat.com (int-mx02.intmail.prod.int.rdu2.redhat.com\n [10.11.54.2])\n (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest\n SHA256)\n (No client certificate requested)\n by mimecast-mx02.redhat.com (Postfix) with ESMTPS id B303A101AA42;\n Tue, 28 Nov 2023 21:01:56 +0000 (UTC)",
            "from RHTPC1VM0NT.lan (unknown [10.22.32.221])\n by smtp.corp.redhat.com (Postfix) with ESMTP id 4AB0640C6E83;\n Tue, 28 Nov 2023 21:01:56 +0000 (UTC)"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;\n s=mimecast20190719; t=1701205320;\n h=from:from:reply-to:subject:subject:date:date:message-id:message-id:\n to:to:cc:cc:mime-version:mime-version:content-type:content-type:\n content-transfer-encoding:content-transfer-encoding;\n bh=9EEZVTlrH4aD+HdHn8uR5qm19tqs5hWxDIyKA+jjwT8=;\n b=WEfQt7uLsqVEVOdkf3whib9xmzPShcpopTtUlGxhzBCV1j1q79ZwmGfewdn3VvDtWYT3FG\n PelAwJdpVW7jjfcxJcbrUN+PLleB+M/Naz48tpOtlEPfL2S9sF5ehEfuABn80DweyOc/Ou\n gUfQKkqxIoBXFkcm3q5LL/Y4i1aSgUo=",
        "X-MC-Unique": "Md5p89KEOr-i7X_4G_fQDQ-1",
        "From": "Aaron Conole <aconole@redhat.com>",
        "To": "ci@dpdk.org",
        "Cc": "Michael Santana <msantana@redhat.com>,\n David Marchand <dmarchan@redhat.com>,\n Thomas Monjalon <thomas@monjalon.net>, Patrick Robb <probb@iol.unh.edu>,\n Dumitru Ceara <dceara@redhat.com>",
        "Subject": "[PATCH v3 0/3] Add a recheck framework to pw-ci",
        "Date": "Tue, 28 Nov 2023 16:01:51 -0500",
        "Message-ID": "<20231128210155.1388785-1-aconole@redhat.com>",
        "MIME-Version": "1.0",
        "X-Scanned-By": "MIMEDefang 3.4.1 on 10.11.54.2",
        "X-Mimecast-Spam-Score": "0",
        "X-Mimecast-Originator": "redhat.com",
        "Content-Transfer-Encoding": "8bit",
        "Content-Type": "text/plain; charset=\"US-ASCII\"; x-default=true",
        "X-BeenThere": "ci@dpdk.org",
        "X-Mailman-Version": "2.1.29",
        "Precedence": "list",
        "List-Id": "DPDK CI discussions <ci.dpdk.org>",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/ci>,\n <mailto:ci-request@dpdk.org?subject=unsubscribe>",
        "List-Archive": "<http://mails.dpdk.org/archives/ci/>",
        "List-Post": "<mailto:ci@dpdk.org>",
        "List-Help": "<mailto:ci-request@dpdk.org?subject=help>",
        "List-Subscribe": "<https://mails.dpdk.org/listinfo/ci>,\n <mailto:ci-request@dpdk.org?subject=subscribe>",
        "Errors-To": "ci-bounces@dpdk.org"
    },
    "content": "This allows users to send repsonse emails to patches and force\nrebuilds of the workflow in github actions.\n\nThis has been tested with the following:\n\nfor recheck in $(./recheck_tool --pw-project=dpdk \\\n                                --pw-instance=patches.dpdk.org \\\n                                --filter=github-robot --state=1 | \\\n                                jq -rc '.rechecks[]'); do\n    ./github_restart --pw-project=dpdk --pw-instance=patches.dpdk.org \\\n                     --series-id=$(echo \"$recheck\" | \\\n                                  jq -rc '.series_id') \\\n                     --repository=ovsrobot/dpdk \\\n                     --sha=$(echo \"$recheck\" | jq -rc '.sha') \\\n                     --github-token=XXXXXXXX\ndone\n\nAnd succesffully rebuilt 6457922075 from series 29774 which does have\na recheck-request (we used the iol-unit-amd64-testing filter to do\nthe test).\n\nTo be added is a way to filter on specific workflows so we don't\nrestart all workflows associated with the run for those projects which\nhave more than one workflow.\n\nThis can be combined with a second call of the recheck tool to advance\nthe state.  When the series id is provided, the tool will update the\ngap_sync column for the specific row and future calls to\ngithub_monitor script will then scan the new run.\n\nRFCv2 -> v3:\n\n  - Added RECHECK.rst to cover the basic worfklow.  Project specific details\n    are expected to be posted to the individual projects documentation.\n\n  - Moved a function for series-db-lib.sh from 3/3 to 2/3, since it was needed\n    for the recheck_tool\n\n  - Moved some help text from 1/3 to 2/3\n\nAaron Conole (3):\n  pw_mon: improve command line options\n  recheck: Add a recheck parser for patchwork comments\n  github: add a tool for restarting checks\n\n RECHECK.rst      |  81 ++++++++++++++++++++++++++\n github_restart   | 145 +++++++++++++++++++++++++++++++++++++++++++++++\n pw_mon           | 123 +++++++++++++++++++++++++++++++++++-----\n recheck_tool     | 100 ++++++++++++++++++++++++++++++++\n series_db_lib.sh |  80 +++++++++++++++++++++++++-\n 5 files changed, 513 insertions(+), 16 deletions(-)\n create mode 100644 RECHECK.rst\n create mode 100755 github_restart\n create mode 100755 recheck_tool"
}