[PATCH v5 3/4] show: indicate length, encoding of omitted body content
authorPeter Wang <novalazy@gmail.com>
Sat, 15 Dec 2012 03:06:44 +0000 (14:06 +1100)
committerW. Trevor King <wking@tremily.us>
Fri, 7 Nov 2014 17:52:11 +0000 (09:52 -0800)
53/8018c5e39cba7f0f584f5bb6abf15b02906797 [new file with mode: 0644]

diff --git a/53/8018c5e39cba7f0f584f5bb6abf15b02906797 b/53/8018c5e39cba7f0f584f5bb6abf15b02906797
new file mode 100644 (file)
index 0000000..0579e13
--- /dev/null
@@ -0,0 +1,140 @@
+Return-Path: <novalazy@gmail.com>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id 06D8B431FC2\r
+       for <notmuch@notmuchmail.org>; Fri, 14 Dec 2012 19:08:01 -0800 (PST)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.799\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.799 tagged_above=-999 required=5\r
+       tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,\r
+       FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id m9afstYt2Abe for <notmuch@notmuchmail.org>;\r
+       Fri, 14 Dec 2012 19:07:59 -0800 (PST)\r
+Received: from mail-pb0-f53.google.com (mail-pb0-f53.google.com\r
+       [209.85.160.53]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
+       (No client certificate requested)\r
+       by olra.theworths.org (Postfix) with ESMTPS id 4A48D431FBF\r
+       for <notmuch@notmuchmail.org>; Fri, 14 Dec 2012 19:07:58 -0800 (PST)\r
+Received: by mail-pb0-f53.google.com with SMTP id jt11so2595004pbb.26\r
+       for <notmuch@notmuchmail.org>; Fri, 14 Dec 2012 19:07:57 -0800 (PST)\r
+DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;\r
+       h=from:to:cc:subject:date:message-id:x-mailer:in-reply-to:references;\r
+       bh=mC8lb4V6GNgTAWFt4bV8opLQVwYteG0VKnP3u8LaWvE=;\r
+       b=OfwvKiIesBXaNAlvGy/uNK5bkX+7thxOo7pEnOJN/JlIeMH+Sjsj/YtFh4lP55uDMa\r
+       vKqeg5+CLJIQMndSXw7hsXUf8Sf60a3+aqOYwLcaCfZKXe91ZhupnitmLFMdmdrTn02B\r
+       xXgMGdp/aqNSMH/0rrTNKrXZ6d+ziLp3LWR7k3jl5YLjLb8FS3x2C5hIDviZVrbxB8c0\r
+       c8s63rLfZ1RUlAznEx5yaMppfZbMjw3378/0T45ckLfnOZBtf3j8YLmGySLUzZQWK6Lw\r
+       puC/GX8+qjQnrt7KU++TF0IQEF6pPZbhTaNqc0P1kxqHEUjqRpmRHzA+qLQl3ymrAUjE\r
+       iHoQ==\r
+Received: by 10.66.74.98 with SMTP id s2mr21069553pav.64.1355540877564;\r
+       Fri, 14 Dec 2012 19:07:57 -0800 (PST)\r
+Received: from localhost (215.42.233.220.static.exetel.com.au.\r
+       [220.233.42.215])\r
+       by mx.google.com with ESMTPS id zv10sm3928874pbc.76.2012.12.14.19.07.52\r
+       (version=TLSv1/SSLv3 cipher=OTHER);\r
+       Fri, 14 Dec 2012 19:07:56 -0800 (PST)\r
+From: Peter Wang <novalazy@gmail.com>\r
+To: notmuch@notmuchmail.org\r
+Subject: [PATCH v5 3/4] show: indicate length, encoding of omitted body\r
+ content\r
+Date: Sat, 15 Dec 2012 14:06:44 +1100\r
+Message-Id: <1355540805-24937-4-git-send-email-novalazy@gmail.com>\r
+X-Mailer: git-send-email 1.7.12.1\r
+In-Reply-To: <1355540805-24937-1-git-send-email-novalazy@gmail.com>\r
+References: <1355540805-24937-1-git-send-email-novalazy@gmail.com>\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+       <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Sat, 15 Dec 2012 03:08:01 -0000\r
+\r
+If a leaf part's body content is omitted, return the encoded length and\r
+transfer encoding in --format=json output.  This information may be used\r
+by the consumer, e.g. to decide whether to download a large attachment\r
+over a slow link.\r
+\r
+Returning the _encoded_ content length is more efficient than returning\r
+the _decoded_ content length.  Returning the transfer encoding allows\r
+the consumer to estimate the decoded content length.\r
+---\r
+ devel/schemata |  9 ++++++++-\r
+ notmuch-show.c | 16 ++++++++++++++--\r
+ 2 files changed, 22 insertions(+), 3 deletions(-)\r
+\r
+diff --git a/devel/schemata b/devel/schemata\r
+index d1ab983..7d167be 100644\r
+--- a/devel/schemata\r
++++ b/devel/schemata\r
+@@ -75,7 +75,14 @@ part = {\r
+     # A leaf part's body content is optional, but may be included if\r
+     # it can be correctly encoded as a string.  Consumers should use\r
+     # this in preference to fetching the part content separately.\r
+-    content?:       string\r
++    content?:       string,\r
++    # If a leaf part's body content is not included, the length of\r
++    # the encoded content (in bytes) may be given instead.\r
++    content-length?: int,\r
++    # If a leaf part's body content is not included, its transfer encoding\r
++    # may be given.  Using this and the encoded content length, it is\r
++    # possible for the consumer to estimate the decoded content length.\r
++    content-transfer-encoding?: string\r
+ }\r
\r
+ # The headers of a message or part (format_headers_sprinter with reply = FALSE)\r
+diff --git a/notmuch-show.c b/notmuch-show.c\r
+index a781a49..a8a348d 100644\r
+--- a/notmuch-show.c\r
++++ b/notmuch-show.c\r
+@@ -600,14 +600,26 @@ format_part_text (const void *ctx, sprinter_t *sp, mime_node_t *node,\r
+ }\r
\r
+ static void\r
+-format_omitted_part_meta (sprinter_t *sp, GMimeObject *meta)\r
++format_omitted_part_meta (sprinter_t *sp, GMimeObject *meta, GMimePart *part)\r
+ {\r
+     const char *content_charset = g_mime_object_get_content_type_parameter (meta, "charset");\r
++    const char *cte = g_mime_object_get_header (meta, "content-transfer-encoding");\r
++    GMimeDataWrapper *wrapper = g_mime_part_get_content_object (part);\r
++    GMimeStream *stream = g_mime_data_wrapper_get_stream (wrapper);\r
++    ssize_t content_length = g_mime_stream_length (stream);\r
\r
+     if (content_charset != NULL) {\r
+       sp->map_key (sp, "content-charset");\r
+       sp->string (sp, content_charset);\r
+     }\r
++    if (cte != NULL) {\r
++      sp->map_key (sp, "content-transfer-encoding");\r
++      sp->string (sp, cte);\r
++    }\r
++    if (content_length >= 0) {\r
++      sp->map_key (sp, "content-length");\r
++      sp->integer (sp, content_length);\r
++    }\r
+ }\r
\r
+ void\r
+@@ -699,7 +711,7 @@ format_part_sprinter (const void *ctx, sprinter_t *sp, mime_node_t *node,\r
+           sp->string_len (sp, (char *) part_content->data, part_content->len);\r
+           g_object_unref (stream_memory);\r
+       } else {\r
+-          format_omitted_part_meta (sp, meta);\r
++          format_omitted_part_meta (sp, meta, GMIME_PART (node->part));\r
+       }\r
+     } else if (GMIME_IS_MULTIPART (node->part)) {\r
+       sp->map_key (sp, "content");\r
+-- \r
+1.7.12.1\r
+\r