Diagnostics

- Added new 'diagnostics' command to assist with bug reporting,
  testing.  It answers questions such as "did you compile it yourself?",
  and more.
- Specifically, it runs a UUID generation test to prove that the UUIDs
  are really unique.

src/diag.cpp

@@ -0,0 +1,221 @@
+////////////////////////////////////////////////////////////////////////////////
+// taskwarrior - a command line task list manager.
+//
+// Copyright 2006 - 2010, Paul Beckingham, Federico Hernandez.
+// All rights reserved.
+//
+// This program is free software; you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free Software
+// Foundation; either version 2 of the License, or (at your option) any later
+// version.
+//
+// This program is distributed in the hope that it will be useful, but WITHOUT
+// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+// FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
+// details.
+//
+// You should have received a copy of the GNU General Public License along with
+// this program; if not, write to the
+//
+//     Free Software Foundation, Inc.,
+//     51 Franklin Street, Fifth Floor,
+//     Boston, MA
+//     02110-1301
+//     USA
+//
+////////////////////////////////////////////////////////////////////////////////
+
+#include <iostream>
+#include <iomanip>
+#include <sstream>
+#include <algorithm>
+#include <string>
+#include <unistd.h>
+#include <stdlib.h>
+
+#include <File.h>
+#include <main.h>
+#include <util.h>
+#include "../auto.h"
+
+#ifdef HAVE_LIBLUA
+extern "C"
+{
+  #include <lua.h>
+}
+#endif
+
+#ifdef HAVE_LIBNCURSES
+#include <ncurses.h>
+#endif
+
+extern Context context;
+
+////////////////////////////////////////////////////////////////////////////////
+// This command will generate output that is intended to help diagnose problems.
+//
+// Although this will change over time, initially this command will answer the
+// kind of questions we always have to ask whenever something is wrong.
+void handleDiagnostics (std::string& outs)
+{
+  std::cout << "\n" << PACKAGE_STRING << "\n";
+
+  std::cout << "  Platform: "
+            <<
+#if defined (DARWIN)
+               "Darwin"
+#elif defined (SOLARIS)
+               "Solaris"
+#elif defined (CYGWIN)
+               "Cygwin"
+#elif defined (OPENBSD)
+               "OpenBSD"
+#elif defined (HAIKU)
+               "Haiku"
+#elif defined (FREEBSD)
+               "FreeBSD"
+#elif defined (LINUX)
+               "Linux"
+#else
+               "<unknown>"
+#endif
+            << "\n\n";
+
+  // Compiler.
+  std::cout << "Compiler\n"
+#ifdef __VERSION__
+            << "   Version: " << __VERSION__ << "\n"
+#endif
+            << "      Caps:"
+#ifdef __STDC__
+            << " +stdc"
+#endif
+#ifdef __STDC_HOSTED__
+            << " +stdc_hosted"
+#endif
+#ifdef __STDC_VERSION__
+            << " +" << __STDC_VERSION__
+#endif
+#ifdef _POSIX_VERSION
+            << " +" << _POSIX_VERSION
+#endif
+#ifdef _POSIX2_C_VERSION
+            << " +" << _POSIX2_C_VERSION
+#endif
+#ifdef _ILP32
+            << " +ILP32"
+#endif
+#ifdef _LP64
+            << " +LP64"
+#endif
+            << " +c" << sizeof (char)
+            << " +i" << sizeof (int)
+            << " +l" << sizeof (long)
+            << " +vp" << sizeof (void*)
+            << "\n\n";
+
+  std::cout << "Libraries\n";
+
+  // NCurses.
+  std::cout << "   NCurses: "
+#ifdef HAVE_LIBNCURSES
+            << NCURSES_VERSION
+            << " ("
+            << NCURSES_VERSION_PATCH
+            << ")"
+#else
+            << "n/a"
+#endif
+            << "\n";
+
+  std::cout << "  Readline: "
+#ifdef HAVE_LIBREADLINE
+            << std::setbase (16) << RL_READLINE_VERSION
+#else
+            << "n/a"
+#endif
+            << "\n";
+
+  std::cout << "       Lua: "
+#ifdef HAVE_LIBLUA
+            << LUA_RELEASE
+#else
+            << "n/a"
+#endif
+            << "\n\n";
+
+  std::cout << "Build Features\n"
+  // Build date.
+            << "     Built: " << __DATE__ << " " << __TIME__ << "\n"
+            << "      Caps:"
+#ifdef HAVE_LIBPTHREAD
+            << " +pthreads"
+#else
+            << " -pthreads"
+#endif
+
+#ifdef HAVE_SRANDOM
+            << " +srandom"
+#else
+            << " -srandom"
+#endif
+
+#ifdef HAVE_RANDOM
+            << " +random"
+#else
+            << " -random"
+#endif
+
+#ifdef HAVE_UUID
+            << " +uuid"
+#else
+            << " -uuid"
+#endif
+            << "\n\n";
+
+  // Config: .taskrc found, readable, writable
+  std::cout << "Configuration\n"
+            << "      File: " << context.config.original_file.data
+            << (context.config.original_file.exists () ? " (found)" : " (missing)")
+            << ", " << context.config.original_file.size () << " bytes"
+            << ", mode "
+            << std::setbase (8)
+            << context.config.original_file.mode ()
+            << "\n";
+
+  // Config: data.location found, readable, writable
+  File location (context.config.get ("data.location"));
+  std::cout << "      Data: " << location.data
+            << (location.exists () ? " (found)" : " (missing)")
+            << ", " << (location.is_directory () ? "dir" : "?")
+            << ", mode "
+            << std::setbase (8)
+            << location.mode ()
+            << "\n\n";
+
+  // Generate 1000 UUIDs and verify they are all unique.
+  std::cout << "Tests\n";
+  {
+    std::cout << "  UUID gen: ";
+    std::vector <std::string> uuids;
+    std::string id;
+    for (int i = 0; i < 1000; i++)
+    {
+      id = uuid ();
+      if (std::find (uuids.begin (), uuids.end (), id) != uuids.end ())
+      {
+        std::cout << "Failed - duplicate UUID at iteration " << i << "\n";
+        break;
+      }
+      else
+        uuids.push_back (id);
+    }
+
+    if (uuids.size () >= 1000)
+      std::cout << "1000 unique UUIDs generated.\n";
+  }
+  std::cout << "\n";
+}
+
+////////////////////////////////////////////////////////////////////////////////
+