Re: [PATCH] cli: Support --include-html and --body=false for --format=text

Subject: Re: [PATCH] cli: Support --include-html and --body=false for --format=text

Date: Fri, 26 Oct 2018 13:12:33 +1100

To: notmuch@notmuchmail.org

Cc:

From: mawww@kakoune.org


On 2018-10-26 05:55, Jani Nikula wrote:
> It's debatable whether parsing the --format=text output correctly is
> convenient or not. Particularly for notmuch show I think the text 
> format
> output is basically legacy, and I don't think we're all that fond of
> adding new features to it.

I would argue that it is easier to work with with shell tools than
sexpression or json, but even if it was not, this change is pretty 
trivial
and does not add a brand new feature to the text format, it just makes
it possible to use existing features (include-html and body=false) with 
it.

> In any case, this patch has two independent changes in one, and should
> be split.

Following are the splitted commits.

 From afd74f5a7506704d4459d01a4d347d8b57293cc5 Mon Sep 17 00:00:00 2001
 From: Maxime Coste <mawww@kakoune.org>
Date: Fri, 26 Oct 2018 13:01:24 +1100
Subject: [PATCH 1/2] cli: notmuch show support for --body=false with
  --format=text

---
  NEWS                      |  8 ++++++++
  doc/man1/notmuch-show.rst |  4 ++--
  notmuch-show.c            | 11 +++++++++--
  test/T190-multipart.sh    | 15 +++++++++++++++
  4 files changed, 34 insertions(+), 4 deletions(-)

diff --git a/NEWS b/NEWS
index ca3ba99e..64de9999 100644
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,11 @@
+Notmuch 0.29 (UNRELEASED)
+=========================
+
+Command Line Interface
+----------------------
+
+`notmuch show` now supports --body=false with --format=text
+
  Notmuch 0.28 (2018-10-12)
  =========================

diff --git a/doc/man1/notmuch-show.rst b/doc/man1/notmuch-show.rst
index 8bfa87c6..f3c32fd2 100644
--- a/doc/man1/notmuch-show.rst
+++ b/doc/man1/notmuch-show.rst
@@ -176,8 +176,8 @@ Supported options for **show** include
  ``--body=(true|false)``
      If true (the default) **notmuch show** includes the bodies of the
      messages in the output; if false, bodies are omitted.
-    ``--body=false`` is only implemented for the json and sexp formats
-    and it is incompatible with ``--part > 0.``
+    ``--body=false`` is only implemented for the text, json and sexp
+    formats and it is incompatible with ``--part > 0.``

      This is useful if the caller only needs the headers as body-less
      output is much faster and substantially smaller.
diff --git a/notmuch-show.c b/notmuch-show.c
index c3a3783a..42fe27cc 100644
--- a/notmuch-show.c
+++ b/notmuch-show.c
@@ -574,6 +574,11 @@ format_part_text (const void *ctx, sprinter_t *sp, 
mime_node_t *node,
  	g_mime_stream_printf (stream, "Date: %s\n", date_string);
  	g_mime_stream_printf (stream, "\fheader}\n");

+	if (!params->output_body)
+	{
+	    g_mime_stream_printf (stream, "\f%s}\n", part_type);
+	    return NOTMUCH_STATUS_SUCCESS;
+	}
  	g_mime_stream_printf (stream, "\fbody{\n");
      }

@@ -1204,9 +1209,11 @@ notmuch_show_command (notmuch_config_t *config, 
int argc, char *argv[])
  	    fprintf (stderr, "Warning: --body=false is incompatible with 
--part > 0. Disabling.\n");
  	    params.output_body = true;
  	} else {
-	    if (format != NOTMUCH_FORMAT_JSON && format != 
NOTMUCH_FORMAT_SEXP)
+	    if (format != NOTMUCH_FORMAT_TEXT &&
+		format != NOTMUCH_FORMAT_JSON &&
+		format != NOTMUCH_FORMAT_SEXP)
  		fprintf (stderr,
-			 "Warning: --body=false only implemented for format=json and 
format=sexp\n");
+			 "Warning: --body=false only implemented for format=text, 
format=json and format=sexp\n");
  	}
      }

diff --git a/test/T190-multipart.sh b/test/T190-multipart.sh
index 3eeac1db..81c4d772 100755
--- a/test/T190-multipart.sh
+++ b/test/T190-multipart.sh
@@ -190,6 +190,21 @@ Non-text part: application/pgp-signature
  EOF
  test_expect_equal_file EXPECTED OUTPUT

+test_begin_subtest "--format=text --part=0 --body=false, message 
header"
+notmuch show --format=text --part=0  --body=false 
'id:87liy5ap00.fsf@yoom.home.cworth.org' >OUTPUT
+cat <<EOF >EXPECTED
+message{ id:87liy5ap00.fsf@yoom.home.cworth.org depth:0 match:1 
excluded:0 filename:${MAIL_DIR}/multipart
+header{
+Carl Worth <cworth@cworth.org> (2001-01-05) (attachment inbox signed 
unread)
+Subject: Multipart message
+From: Carl Worth <cworth@cworth.org>
+To: cworth@cworth.org
+Date: Fri, 05 Jan 2001 15:43:57 +0000
+header}
+message}
+EOF
+test_expect_equal_file EXPECTED OUTPUT
+
  test_begin_subtest "--format=text --part=1, message body"
  notmuch show --format=text --part=1 
'id:87liy5ap00.fsf@yoom.home.cworth.org' >OUTPUT
  cat <<EOF >EXPECTED
-- 
2.14.5


 From af20160c28e26426825a959911c4f0c4d5950048 Mon Sep 17 00:00:00 2001
 From: Maxime Coste <mawww@kakoune.org>
Date: Fri, 26 Oct 2018 13:02:11 +1100
Subject: [PATCH 2/2] cli: notmuch show support for --include-html with
  --format=text

---
  NEWS                      |  3 ++-
  doc/man1/notmuch-show.rst | 11 ++++++-----
  notmuch-show.c            |  9 ++++++---
  test/T190-multipart.sh    |  9 +++++++++
  4 files changed, 23 insertions(+), 9 deletions(-)

diff --git a/NEWS b/NEWS
index 64de9999..434f920a 100644
--- a/NEWS
+++ b/NEWS
@@ -4,7 +4,8 @@ Notmuch 0.29 (UNRELEASED)
  Command Line Interface
  ----------------------

-`notmuch show` now supports --body=false with --format=text
+`notmuch show` now supports --body=false and --include-html with
+--format=text

  Notmuch 0.28 (2018-10-12)
  =========================
diff --git a/doc/man1/notmuch-show.rst b/doc/man1/notmuch-show.rst
index f3c32fd2..a2708a04 100644
--- a/doc/man1/notmuch-show.rst
+++ b/doc/man1/notmuch-show.rst
@@ -183,11 +183,12 @@ Supported options for **show** include
      output is much faster and substantially smaller.

  ``--include-html``
-    Include "text/html" parts as part of the output (currently only
-    supported with ``--format=json`` and ``--format=sexp``). By 
default,
-    unless ``--part=N`` is used to select a specific part or
-    ``--include-html`` is used to include all "text/html" parts, no
-    part with content type "text/html" is included in the output.
+    Include "text/html" parts as part of the output (currently
+    only supported with ``--format=text``, ``--format=json`` and
+    ``--format=sexp``). By default, unless ``--part=N`` is used to
+    select a specific part or ``--include-html`` is used to include all
+    "text/html" parts, no part with content type "text/html" is 
included
+    in the output.

  A common use of **notmuch show** is to display a single thread of email
  messages. For this, use a search term of "thread:<thread-id>" as can be
diff --git a/notmuch-show.c b/notmuch-show.c
index 42fe27cc..07e9a5db 100644
--- a/notmuch-show.c
+++ b/notmuch-show.c
@@ -584,7 +584,8 @@ format_part_text (const void *ctx, sprinter_t *sp, 
mime_node_t *node,

      if (leaf) {
  	if (g_mime_content_type_is_type (content_type, "text", "*") &&
-	    !g_mime_content_type_is_type (content_type, "text", "html"))
+	    (params->include_html ||
+	     ! g_mime_content_type_is_type (content_type, "text", "html")))
  	{
  	    show_text_part_content (node->part, stream, 0);
  	} else {
@@ -1218,8 +1219,10 @@ notmuch_show_command (notmuch_config_t *config, 
int argc, char *argv[])
      }

      if (params.include_html &&
-        (format != NOTMUCH_FORMAT_JSON && format != 
NOTMUCH_FORMAT_SEXP)) {
-	fprintf (stderr, "Warning: --include-html only implemented for 
format=json and format=sexp\n");
+        (format != NOTMUCH_FORMAT_TEXT &&
+	 format != NOTMUCH_FORMAT_JSON &&
+	 format != NOTMUCH_FORMAT_SEXP)) {
+	fprintf (stderr, "Warning: --include-html only implemented for 
format=text, format=json and format=sexp\n");
      }

      query_string = query_string_from_args (config, argc-opt_index, 
argv+opt_index);
diff --git a/test/T190-multipart.sh b/test/T190-multipart.sh
index 81c4d772..9ad141cb 100755
--- a/test/T190-multipart.sh
+++ b/test/T190-multipart.sh
@@ -325,6 +325,15 @@ Non-text part: text/html
  EOF
  test_expect_equal_file EXPECTED OUTPUT

+test_begin_subtest "--format=text --include-html --part=5, rfc822's 
html part"
+notmuch show --format=text --include-html --part=5 
'id:87liy5ap00.fsf@yoom.home.cworth.org' >OUTPUT
+cat <<EOF >EXPECTED
+part{ ID: 5, Content-type: text/html
+<p>This is an embedded message, with a multipart/alternative part.</p>
+part}
+EOF
+test_expect_equal_file EXPECTED OUTPUT
+
  test_begin_subtest "--format=text --part=6, rfc822's text part"
  notmuch show --format=text --part=6 
'id:87liy5ap00.fsf@yoom.home.cworth.org' >OUTPUT
  cat <<EOF >EXPECTED
-- 
2.14.5
_______________________________________________
notmuch mailing list
notmuch@notmuchmail.org
https://notmuchmail.org/mailman/listinfo/notmuch

Thread: