Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/1516034/?format=api
{ "id": 1516034, "url": "http://patchwork.ozlabs.org/api/patches/1516034/?format=api", "web_url": "http://patchwork.ozlabs.org/project/patchwork/patch/20210811213705.36293-5-stephen@that.guru/", "project": { "id": 16, "url": "http://patchwork.ozlabs.org/api/projects/16/?format=api", "name": "Patchwork", "link_name": "patchwork", "list_id": "patchwork.lists.ozlabs.org", "list_email": "patchwork@lists.ozlabs.org", "web_url": "http://jk.ozlabs.org/projects/patchwork/", "scm_url": "git://github.com/getpatchwork/patchwork", "webscm_url": "https://github.com/getpatchwork/patchwork", "list_archive_url": "", "list_archive_url_format": "", "commit_url_format": "" }, "msgid": "<20210811213705.36293-5-stephen@that.guru>", "list_archive_url": null, "date": "2021-08-11T21:36:50", "name": "[RFC,04/19] REST: Include 'first', 'last' refs in 'Link' header", "commit_ref": null, "pull_url": null, "state": "rfc", "archived": false, "hash": "a0e1c10229e3d3ec9dcecc0c1fc7c5e967c87bf2", "submitter": { "id": 69991, "url": "http://patchwork.ozlabs.org/api/people/69991/?format=api", "name": "Stephen Finucane", "email": "stephen@that.guru" }, "delegate": null, "mbox": "http://patchwork.ozlabs.org/project/patchwork/patch/20210811213705.36293-5-stephen@that.guru/mbox/", "series": [ { "id": 257699, "url": "http://patchwork.ozlabs.org/api/series/257699/?format=api", "web_url": "http://patchwork.ozlabs.org/project/patchwork/list/?series=257699", "date": "2021-08-11T21:36:49", "name": "Integrate Bulma", "version": 1, "mbox": "http://patchwork.ozlabs.org/series/257699/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/1516034/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/1516034/checks/", "tags": {}, "related": [ { "id": 1523323, "url": "http://patchwork.ozlabs.org/api/patches/1523323/?format=api", "web_url": "http://patchwork.ozlabs.org/project/patchwork/patch/20210901165756.181192-5-stephen@that.guru/", "msgid": "<20210901165756.181192-5-stephen@that.guru>", "list_archive_url": null, "date": "2021-09-01T16:57:41", "name": "[RFC,v2,04/19] REST: Include 'first', 'last' refs in 'Link' header", "mbox": "http://patchwork.ozlabs.org/project/patchwork/patch/20210901165756.181192-5-stephen@that.guru/mbox/" } ], "headers": { "Return-Path": "\n <patchwork-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org>", "X-Original-To": [ "incoming@patchwork.ozlabs.org", "patchwork@lists.ozlabs.org" ], "Delivered-To": [ "patchwork-incoming@bilbo.ozlabs.org", "patchwork@lists.ozlabs.org" ], "Authentication-Results": [ "ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=lists.ozlabs.org\n (client-ip=2404:9400:2:0:216:3eff:fee1:b9f1; helo=lists.ozlabs.org;\n envelope-from=patchwork-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org;\n receiver=<UNKNOWN>)", "ozlabs.org;\n\tdkim=fail reason=\"key not found in DNS\" header.d=that.guru\n header.i=@that.guru header.a=rsa-sha256 header.s=x header.b=D1B+yboI;\n\tdkim-atps=neutral", "lists.ozlabs.org;\n\tdkim=fail reason=\"key not found in DNS\" header.d=that.guru\n header.i=@that.guru header.a=rsa-sha256 header.s=x header.b=D1B+yboI;\n\tdkim-atps=neutral", "lists.ozlabs.org;\n spf=none (no SPF record) smtp.mailfrom=that.guru\n (client-ip=136.175.108.248; helo=mail-108-mta248.mxroute.com;\n envelope-from=stephen@that.guru; receiver=<UNKNOWN>)", "lists.ozlabs.org;\n dkim=fail reason=\"key not found in DNS\" header.d=that.guru\n header.i=@that.guru\n header.a=rsa-sha256 header.s=x header.b=D1B+yboI;\n dkim-atps=neutral" ], "Received": [ "from lists.ozlabs.org (lists.ozlabs.org\n [IPv6:2404:9400:2:0:216:3eff:fee1:b9f1])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange X25519 server-signature RSA-PSS (4096 bits))\n\t(No client certificate requested)\n\tby ozlabs.org (Postfix) with ESMTPS id 4GlNTH4Cm4z9sXS\n\tfor <incoming@patchwork.ozlabs.org>; Thu, 12 Aug 2021 07:37:39 +1000 (AEST)", "from boromir.ozlabs.org (localhost [IPv6:::1])\n\tby lists.ozlabs.org (Postfix) with ESMTP id 4GlNTH2zVfz3bYH\n\tfor <incoming@patchwork.ozlabs.org>; Thu, 12 Aug 2021 07:37:39 +1000 (AEST)", "from mail-108-mta248.mxroute.com (mail-108-mta248.mxroute.com\n [136.175.108.248])\n (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))\n (No client certificate requested)\n by lists.ozlabs.org (Postfix) with ESMTPS id 4GlNT25ggkz30DC\n for <patchwork@lists.ozlabs.org>; Thu, 12 Aug 2021 07:37:25 +1000 (AEST)", "from filter004.mxroute.com ([149.28.56.236] filter004.mxroute.com)\n (Authenticated sender: mN4UYu2MZsgR)\n by mail-108-mta248.mxroute.com (ZoneMTA) with ESMTPSA id\n 17b3725f83800074ba.002 for <patchwork@lists.ozlabs.org>\n (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES128-GCM-SHA256);\n Wed, 11 Aug 2021 21:37:20 +0000" ], "X-Zone-Loop": "b731cef79daa28aa1f253397f6defd07c5089c452668", "X-Originating-IP": "[149.28.56.236]", "DKIM-Signature": "v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=that.guru;\n s=x;\n h=Content-Transfer-Encoding:MIME-Version:References:In-Reply-To:\n Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type:Content-ID:\n Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc\n :Resent-Message-ID:List-Id:List-Help:List-Unsubscribe:List-Subscribe:\n List-Post:List-Owner:List-Archive;\n bh=+56nzWVvndVYMOHLIxOIV0MDdcNXopOtm/vScZ44d3w=; b=D1B+yboISK+sdPEIAzbSj1uozt\n +fDCgLQUQ06ZgzXrZkFMhGKsByDy3w2NqmfLPAbg9BJkbmnLEdSi1j73ybd97tchp6jw+821NuDDs\n DWSoCLXQQvE7iJir4osGqMHPsg7y1nioi/u78W20pyPqikDHnu/OgH+0ZEUmJR0OxOTV7t/PrvdRu\n ush7XyWK3EdbCPs5TJl5va5LGgTMg+XkGGkrn5Qk4h5hfs1xfIi5GBgvzAljTCAdJxZWABwAYqpd0\n rbaIJI+NpIiJ753F0veY5zxcamBLG/IwMBqwcqYGzAxXpswUt/9qGglW8yAH7IupG/LXuKmAzSHAJ\n 72HVsrzg==;", "From": "Stephen Finucane <stephen@that.guru>", "To": "patchwork@lists.ozlabs.org", "Subject": "[RFC PATCH 04/19] REST: Include 'first', 'last' refs in 'Link' header", "Date": "Wed, 11 Aug 2021 22:36:50 +0100", "Message-Id": "<20210811213705.36293-5-stephen@that.guru>", "X-Mailer": "git-send-email 2.31.1", "In-Reply-To": "<20210811213705.36293-1-stephen@that.guru>", "References": "<20210811213705.36293-1-stephen@that.guru>", "MIME-Version": "1.0", "X-AuthUser": "stephen@that.guru", "X-Zone-Spam-Resolution": "no action", "X-Zone-Spam-Status": "No, score=5, required=15, tests=[ARC_NA=0,\n MID_CONTAINS_FROM=1, FROM_HAS_DN=0, RCPT_COUNT_THREE=0, TO_DN_SOME=0,\n R_MISSING_CHARSET=2.5, RCVD_COUNT_ZERO=0, FROM_EQ_ENVFROM=0, MIME_TRACE=0,\n BROKEN_CONTENT_TYPE=1.5, NEURAL_SPAM=0]", "X-BeenThere": "patchwork@lists.ozlabs.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "Patchwork development <patchwork.lists.ozlabs.org>", "List-Unsubscribe": "<https://lists.ozlabs.org/options/patchwork>,\n <mailto:patchwork-request@lists.ozlabs.org?subject=unsubscribe>", "List-Archive": "<http://lists.ozlabs.org/pipermail/patchwork/>", "List-Post": "<mailto:patchwork@lists.ozlabs.org>", "List-Help": "<mailto:patchwork-request@lists.ozlabs.org?subject=help>", "List-Subscribe": "<https://lists.ozlabs.org/listinfo/patchwork>,\n <mailto:patchwork-request@lists.ozlabs.org?subject=subscribe>", "Content-Type": "text/plain; charset=\"us-ascii\"", "Content-Transfer-Encoding": "7bit", "Errors-To": "patchwork-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org", "Sender": "\"Patchwork\"\n <patchwork-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org>" }, "content": "I've no idea why this wasn't done from day one, but it's a huge\nusability win for anyone attempting to do pagination with this header.\nNote that this change is not versioned as I haven't figured out how to\ndo that at this layer.\n\nSigned-off-by: Stephen Finucane <stephen@that.guru>\n---\n patchwork/api/base.py | 33 ++++++++++++++++++++++++---------\n 1 file changed, 24 insertions(+), 9 deletions(-)", "diff": "diff --git patchwork/api/base.py patchwork/api/base.py\nindex 89a43114..4d546eae 100644\n--- patchwork/api/base.py\n+++ patchwork/api/base.py\n@@ -11,6 +11,7 @@ from rest_framework.pagination import PageNumberPagination\n from rest_framework.response import Response\n from rest_framework.serializers import HyperlinkedIdentityField\n from rest_framework.serializers import HyperlinkedModelSerializer\n+from rest_framework.utils.urls import replace_query_param\n \n from patchwork.api import utils\n \n@@ -27,19 +28,33 @@ class LinkHeaderPagination(PageNumberPagination):\n max_page_size = settings.MAX_REST_RESULTS_PER_PAGE\n page_size_query_param = 'per_page'\n \n+ def get_first_link(self):\n+ url = self.request.build_absolute_uri()\n+ return replace_query_param(url, self.page_query_param, 1)\n+\n+ def get_last_link(self):\n+ url = self.request.build_absolute_uri()\n+ page_number = self.page.paginator.num_pages\n+ return replace_query_param(url, self.page_query_param, page_number)\n+\n def get_paginated_response(self, data):\n next_url = self.get_next_link()\n previous_url = self.get_previous_link()\n+ first_url = self.get_first_link()\n+ last_url = self.get_last_link()\n+\n+ links = []\n+\n+ if next_url is not None:\n+ links.append(f'<{next_url}>; rel=\"next\"')\n+\n+ if previous_url is not None:\n+ links.append(f'<{previous_url}>; rel=\"prev\"')\n+\n+ links.append(f'<{first_url}>; rel=\"first\"')\n+ links.append(f'<{last_url}>; rel=\"last\"')\n \n- link = ''\n- if next_url is not None and previous_url is not None:\n- link = '<{next_url}>; rel=\"next\", <{previous_url}>; rel=\"prev\"'\n- elif next_url is not None:\n- link = '<{next_url}>; rel=\"next\"'\n- elif previous_url is not None:\n- link = '<{previous_url}>; rel=\"prev\"'\n- link = link.format(next_url=next_url, previous_url=previous_url)\n- headers = {'Link': link} if link else {}\n+ headers = {'Link': ', '.join(links)} if links else {}\n return Response(data, headers=headers)\n \n \n", "prefixes": [ "RFC", "04/19" ] }