[PATCH 3/3] test: implement and document NOTMUCH_TEST_QUIET variable usage
authorTomi Ollila <tomi.ollila@iki.fi>
Mon, 25 Nov 2013 17:08:19 +0000 (19:08 +0200)
committerW. Trevor King <wking@tremily.us>
Fri, 7 Nov 2014 17:58:28 +0000 (09:58 -0800)
45/b7d09b7249163db09b4006dfb7322e495a0258 [new file with mode: 0644]

diff --git a/45/b7d09b7249163db09b4006dfb7322e495a0258 b/45/b7d09b7249163db09b4006dfb7322e495a0258
new file mode 100644 (file)
index 0000000..97a91f6
--- /dev/null
@@ -0,0 +1,151 @@
+Return-Path: <too@guru-group.fi>\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 7CCE0431E64\r
+       for <notmuch@notmuchmail.org>; Mon, 25 Nov 2013 09:08:42 -0800 (PST)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: 0\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]\r
+       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 4+pHY-WdKAxv for <notmuch@notmuchmail.org>;\r
+       Mon, 25 Nov 2013 09:08:36 -0800 (PST)\r
+Received: from guru.guru-group.fi (guru.guru-group.fi [46.183.73.34])\r
+       by olra.theworths.org (Postfix) with ESMTP id 9FE7D431FDC\r
+       for <notmuch@notmuchmail.org>; Mon, 25 Nov 2013 09:08:35 -0800 (PST)\r
+Received: by guru.guru-group.fi (Postfix, from userid 501)\r
+       id A6B2610008F; Mon, 25 Nov 2013 19:08:28 +0200 (EET)\r
+From: Tomi Ollila <tomi.ollila@iki.fi>\r
+To: notmuch@notmuchmail.org\r
+Subject: [PATCH 3/3] test: implement and document NOTMUCH_TEST_QUIET variable\r
+       usage\r
+Date: Mon, 25 Nov 2013 19:08:19 +0200\r
+Message-Id: <1385399299-12936-3-git-send-email-tomi.ollila@iki.fi>\r
+X-Mailer: git-send-email 1.8.0\r
+In-Reply-To: <1385399299-12936-1-git-send-email-tomi.ollila@iki.fi>\r
+References: <1384288868-23903-1-git-send-email-tomi.ollila@iki.fi>\r
+       <1385399299-12936-1-git-send-email-tomi.ollila@iki.fi>\r
+Cc: tomi.ollila@iki.fi\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: Mon, 25 Nov 2013 17:08:42 -0000\r
+\r
+When NOTMUCH_TEST_QUIET environment variable is set to non-null value\r
+messages when new test script starts and when test PASSes are disabled.\r
+This eases picking the cases when tests FAIL (as those are still printed).\r
+---\r
+ test/README      |  8 ++++++++\r
+ test/basic       |  4 ++--\r
+ test/test-lib.sh | 11 ++++++++++-\r
+ 3 files changed, 20 insertions(+), 3 deletions(-)\r
+\r
+diff --git a/test/README b/test/README\r
+index d12cff2..79a9b1b 100644\r
+--- a/test/README\r
++++ b/test/README\r
+@@ -74,10 +74,18 @@ the tests in one of the following ways.\r
\r
+       TEST_EMACS=my-special-emacs TEST_EMACSCLIENT=my-emacsclient make test\r
+       TEST_EMACS=my-special-emacs TEST_EMACSCLIENT=my-emacsclient ./emacs\r
+       make test TEST_EMACS=my-special-emacs TEST_EMACSCLIENT=my-emacsclient\r
\r
++Quiet Execution\r
++---------------\r
++\r
++Normally, when new script starts and when test PASSes you get a message\r
++printed on screen. This printing can be disabled by setting the\r
++NOTMUCH_TEST_QUIET variable to a non-null value. Message on test\r
++failures and skips are still printed.\r
++\r
+ Skipping Tests\r
+ --------------\r
+ If, for any reason, you need to skip one or more tests, you can do so\r
+ by setting the NOTMUCH_SKIP_TESTS variable to the name of one or more\r
+ sections of tests.\r
+diff --git a/test/basic b/test/basic\r
+index 64eb7d7..f7eed32 100755\r
+--- a/test/basic\r
++++ b/test/basic\r
+@@ -72,16 +72,16 @@ suppress_diff_date() {\r
+     sed -e 's/\(.*\-\-\- test-verbose\.4\.\expected\).*/\1/' \\r
+       -e 's/\(.*\+\+\+ test-verbose\.4\.\output\).*/\1/'\r
+ }\r
\r
+ test_begin_subtest "Ensure that test output is suppressed unless the test fails"\r
+-output=$(cd $TEST_DIRECTORY; ./test-verbose 2>&1 | suppress_diff_date)\r
++output=$(cd $TEST_DIRECTORY; NOTMUCH_TEST_QUIET= ./test-verbose 2>&1 | suppress_diff_date)\r
+ expected=$(cat $EXPECTED/test-verbose-no | suppress_diff_date)\r
+ test_expect_equal "$output" "$expected"\r
\r
+ test_begin_subtest "Ensure that -v does not suppress test output"\r
+-output=$(cd $TEST_DIRECTORY; ./test-verbose -v 2>&1 | suppress_diff_date)\r
++output=$(cd $TEST_DIRECTORY; NOTMUCH_TEST_QUIET= ./test-verbose -v 2>&1 | suppress_diff_date)\r
+ expected=$(cat $EXPECTED/test-verbose-yes | suppress_diff_date)\r
+ # Do not include the results of test-verbose in totals\r
+ rm $TEST_DIRECTORY/test-results/test-verbose\r
+ rm -r $TEST_DIRECTORY/tmp.test-verbose\r
+ test_expect_equal "$output" "$expected"\r
+diff --git a/test/test-lib.sh b/test/test-lib.sh\r
+index 34e0db6..9d4a807 100644\r
+--- a/test/test-lib.sh\r
++++ b/test/test-lib.sh\r
+@@ -196,11 +196,14 @@ print_test_description ()\r
+       test -z "$test_description_printed" || return 0\r
+       echo\r
+       echo $this_test: "Testing ${test_description}"\r
+       test_description_printed=1\r
+ }\r
+-print_test_description\r
++if [ -z "$NOTMUCH_TEST_QUIET" ]\r
++then\r
++      print_test_description\r
++fi\r
\r
+ exec 5>&1\r
\r
+ test_failure=0\r
+ test_count=0\r
+@@ -715,20 +718,26 @@ test_ok_ () {\r
+       if test "$test_subtest_known_broken_" = "t"; then\r
+               test_known_broken_ok_\r
+               return\r
+       fi\r
+       test_success=$(($test_success + 1))\r
++      if test -n "$NOTMUCH_TEST_QUIET"; then\r
++              return 0\r
++      fi\r
+       say_color pass "%-6s" "PASS"\r
+       echo " $test_subtest_name"\r
+ }\r
\r
+ test_failure_ () {\r
+       if test "$test_subtest_known_broken_" = "t"; then\r
+               test_known_broken_failure_ "$@"\r
+               return\r
+       fi\r
+       test_failure=$(($test_failure + 1))\r
++      if test -n "$NOTMUCH_TEST_QUIET"; then\r
++              print_test_description\r
++      fi\r
+       test_failure_message_ "FAIL" "$test_subtest_name" "$@"\r
+       test "$immediate" = "" || { GIT_EXIT_OK=t; exit 1; }\r
+       return 1\r
+ }\r
\r
+-- \r
+1.8.4.2\r
+\r