Re: [PATCH v2 06/10] cli: Introduce "notmuch address" command

diff --git a/9a/8c142e126e5d5a62067ee63eb004a47c8f2a7a b/9a/8c142e126e5d5a62067ee63eb004a47c8f2a7a
new file mode 100644 (file)
index 0000000..e6155d3
--- /dev/null
+++ b/9a/8c142e126e5d5a62067ee63eb004a47c8f2a7a
@@ -0,0 +1,136 @@
+Return-Path: <sojka@merica.cz>\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 D9EDC431E82\r
+       for <notmuch@notmuchmail.org>; Tue,  4 Nov 2014 14:00:08 -0800 (PST)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -2.3\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-2.3 tagged_above=-999 required=5\r
+       tests=[RCVD_IN_DNSWL_MED=-2.3] 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 47myDmS1cY+x for <notmuch@notmuchmail.org>;\r
+       Tue,  4 Nov 2014 14:00:01 -0800 (PST)\r
+Received: from max.feld.cvut.cz (max.feld.cvut.cz [147.32.192.36])\r
+       by olra.theworths.org (Postfix) with ESMTP id 80FF6431FAE\r
+       for <notmuch@notmuchmail.org>; Tue,  4 Nov 2014 14:00:01 -0800 (PST)\r
+Received: from localhost (unknown [192.168.200.7])\r
+       by max.feld.cvut.cz (Postfix) with ESMTP id 0C1E15CD17F;\r
+       Tue,  4 Nov 2014 22:59:58 +0100 (CET)\r
+X-Virus-Scanned: IMAP STYX AMAVIS\r
+Received: from max.feld.cvut.cz ([192.168.200.1])\r
+       by localhost (styx.feld.cvut.cz [192.168.200.7]) (amavisd-new,\r
+       port 10044)\r
+       with ESMTP id n5ATZ5kLYTw6; Tue,  4 Nov 2014 22:59:53 +0100 (CET)\r
+Received: from imap.feld.cvut.cz (imap.feld.cvut.cz [147.32.192.34])\r
+       by max.feld.cvut.cz (Postfix) with ESMTP id 986285CD170;\r
+       Tue,  4 Nov 2014 22:59:53 +0100 (CET)\r
+Received: from wsh by steelpick.2x.cz with local (Exim 4.84)\r
+       (envelope-from <sojka@merica.cz>)\r
+       id 1Xlm8h-0006bO-Vg; Tue, 04 Nov 2014 22:59:47 +0100\r
+From: Michal Sojka <sojkam1@fel.cvut.cz>\r
+To: David Bremner <david@tethera.net>, notmuch@notmuchmail.org\r
+Subject: Re: [PATCH v2 06/10] cli: Introduce "notmuch address" command\r
+In-Reply-To: <87d293mp9c.fsf@maritornes.cs.unb.ca>\r
+References: <1415058622-21162-1-git-send-email-sojkam1@fel.cvut.cz>\r
+       <1415058622-21162-7-git-send-email-sojkam1@fel.cvut.cz>\r
+       <87d293mp9c.fsf@maritornes.cs.unb.ca>\r
+User-Agent: Notmuch/0.18.2+157~ga00d359 (http://notmuchmail.org) Emacs/24.3.1\r
+       (x86_64-pc-linux-gnu)\r
+Date: Tue, 04 Nov 2014 22:59:47 +0100\r
+Message-ID: <871tpimxt8.fsf@steelpick.2x.cz>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain\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: Tue, 04 Nov 2014 22:00:09 -0000\r
+\r
+On Tue, Nov 04 2014, David Bremner wrote:\r
+> Michal Sojka <sojkam1@fel.cvut.cz> writes:\r
+>\r
+>> +{\r
+>> +    local cur prev words cword split\r
+>> +    _init_completion -s || return\r
+>> +\r
+>> +    $split &&\r
+>> +    case "${prev}" in\r
+>> +   --format)\r
+>> +       COMPREPLY=( $( compgen -W "json sexp text text0" -- "${cur}" ) )\r
+>> +       return\r
+>> +       ;;\r
+>> +   --output)\r
+>> +       COMPREPLY=( $( compgen -W "sender recipients" -- "${cur}" ) )\r
+>> +       return\r
+>> +       ;;\r
+>> +   --sort)\r
+>> +       COMPREPLY=( $( compgen -W "newest-first oldest-first" -- "${cur}" ) )\r
+>> +       return\r
+>> +       ;;\r
+>> +   --exclude)\r
+>> +       COMPREPLY=( $( compgen -W "true false flag all" -- "${cur}" ) )\r
+>> +       return\r
+>> +       ;;\r
+>> +    esac\r
+>> +\r
+>> +    ! $split &&\r
+>> +    case "${cur}" in\r
+>> +   -*)\r
+>> +       local options="--format= --output= --sort= --exclude="\r
+>> +       compopt -o nospace\r
+>> +       COMPREPLY=( $(compgen -W "$options" -- ${cur}) )\r
+>> +       ;;\r
+>> +   *)\r
+>> +       _notmuch_search_terms\r
+>> +       ;;\r
+>> +    esac\r
+>> +}\r
+>> +\r
+>\r
+> I am reminded that we have no tests for shell completion stuff, which\r
+> seems pretty fragile.\r
+>\r
+>> +\r
+>> +    ``--format=``\ (**json**\ \|\ **sexp**\ \|\ **text**\ \|\ **text0**)\r
+>> +        Presents the results in either JSON, S-Expressions, newline\r
+>> +        character separated plain-text (default), or null character\r
+>> +        separated plain-text (compatible with **xargs(1)** -0 option\r
+>> +        where available).\r
+>> +\r
+>> +    ``--format-version=N``\r
+>> +        Use the specified structured output format version. This is\r
+>> +        intended for programs that invoke **notmuch(1)** internally. If\r
+>> +        omitted, the latest supported version will be used.\r
+>> +\r
+>\r
+>\r
+> I wonder if at some point we should have a notmuch-output-formats.7 page.\r
+>\r
+>\r
+>> +    ``--exclude=(true|false|all|flag)``\r
+>> +        A message is called "excluded" if it matches at least one tag in\r
+>> +        search.tag\_exclude that does not appear explicitly in the\r
+>> +        search terms. This option specifies whether to omit excluded\r
+>> +        messages in the search process.\r
+>\r
+> Similarly for excludes.  I'm ok with the duplication for now, and I can\r
+> see an argument for not making the user chase references.\r
+\r
+What about using RST include directive [1] to include shared parts into\r
+more documents?\r
+\r
+[1] http://docutils.sourceforge.net/docs/ref/rst/directives.html#including-an-external-document-fragment\r
+\r
+-Michal\r