git.notmuchmail.org Git - notmuch/blob - notmuch

   1 #!/usr/bin/env python
   2 """This is a notmuch implementation in python. It's goal is to allow running the test suite on the cnotmuch python bindings."""
   3 import sys, os, re, logging
   4 from cnotmuch.notmuch import Database, Query
   5 PREFIX=re.compile('(\w+):(.*$)')
   6 #TODO Handle variable: NOTMUCH-CONFIG
   7
   8 #-------------------------------------------------------------------------
   9 HELPTEXT="""The notmuch mail system.
  10
  11 Usage: notmuch <command> [args...]
  12
  13 Where <command> and [args...] are as follows:
  14
  15         setup   Interactively setup notmuch for first use.
  16
  17         new     [--verbose]
  18
  19                 Find and import new messages to the notmuch database.
  20
  21         search  [options...] <search-terms> [...]
  22
  23                 Search for messages matching the given search terms.
  24
  25         show    <search-terms> [...]
  26
  27                 Show all messages matching the search terms.
  28
  29         count   <search-terms> [...]
  30
  31                 Count messages matching the search terms.
  32
  33         reply   [options...] <search-terms> [...]
  34
  35                 Construct a reply template for a set of messages.
  36
  37         tag     +<tag>|-<tag> [...] [--] <search-terms> [...]
  38
  39                 Add/remove tags for all messages matching the search terms.
  40
  41         dump    [<filename>]
  42
  43                 Create a plain-text dump of the tags for each message.
  44
  45         restore <filename>
  46
  47                 Restore the tags from the given dump file (see 'dump').
  48
  49         search-tags     [<search-terms> [...] ]
  50
  51                 List all tags found in the database or matching messages.
  52
  53         help    [<command>]
  54
  55                 This message, or more detailed help for the named command.
  56
  57 Use "notmuch help <command>" for more details on each command.
  58 And "notmuch help search-terms" for the common search-terms syntax.
  59 """
  60 #-------------------------------------------------------------------------
  61 #TODO: replace the dynamic pieces
  62 USAGE="""Notmuch is configured and appears to have a database. Excellent!
  63
  64 At this point you can start exploring the functionality of notmuch by
  65 using commands such as:
  66
  67         notmuch search tag:inbox
  68
  69         notmuch search to:"Sebastian Spaeth"
  70
  71         notmuch search from:"Sebastian@SSpaeth.de"
  72
  73         notmuch search subject:"my favorite things"
  74
  75 See "notmuch help search" for more details.
  76
  77 You can also use "notmuch show" with any of the thread IDs resulting
  78 from a search. Finally, you may want to explore using a more sophisticated
  79 interface to notmuch such as the emacs interface implemented in notmuch.el
  80 or any other interface described at http://notmuchmail.org
  81
  82 And don't forget to run "notmuch new" whenever new mail arrives.
  83
  84 Have fun, and may your inbox never have much mail.
  85 """
  86 #-------------------------------------------------------------------------
  87 def quote_query_line(argv):
  88    #mangle arguments wrapping terms with spaces in quotes
  89    for i in xrange(0,len(argv)):
  90       if argv[i].find(' ') >= 0:
  91          #if we use prefix:termWithSpaces, put quotes around term
  92          m = PREFIX.match(argv[i])
  93          if m:
  94             argv[i] = '%s:"%s"' % (m.group(1), m.group(2))
  95          else:
  96             argv[i] = '"'+argv[i]+'"'
  97    return ' '.join(argv)
  98
  99 if __name__ == '__main__':
 100
 101    # Handle command line options
 102    # No option
 103    if len(sys.argv) == 1:
 104       print USAGE
 105
 106    elif sys.argv[1] == 'setup':
 107        """ Interactively setup notmuch for first use. """
 108        print "Not implemented."
 109
 110    elif sys.argv[1] == 'help':
 111        if len(sys.argv) == 2: print HELPTEXT
 112        else: print "Not implemented"
 113
 114    elif sys.argv[1] == 'new':
 115        #TODO: handle --verbose
 116        print "Not implemented."
 117
 118    elif sys.argv[1] == 'count':
 119       db = Database()
 120       if len(sys.argv) == 2:
 121          #no further search term
 122          querystr=''
 123       else:
 124          #mangle arguments wrapping terms with spaces in quotes
 125          querystr = quote_query_line(sys.argv[2:])
 126       logging.debug("count "+querystr)
 127       print(len(Query(db,querystr).search_messages()))
 128
 129    elif sys.argv[1] == 'search-tags':
 130       if len(sys.argv) == 2:
 131          #no further search term
 132          print("\n".join(Database().get_all_tags()))
 133       else:
 134          #mangle arguments wrapping terms with spaces in quotes
 135          querystr = quote_query_line(sys.argv[2:])
 136          logging.debug("search-term "+querystr)
 137          db = Database()
 138          m  = Query(db,querystr).search_messages()
 139          print("\n".join([t for t in m.collect_tags()]))
 140
 141    else:
 142        # unknown command
 143        print "Error: Unknown command '%s' (see \"notmuch help\")" % sys.argv[1]
 144
 145
 146    #TODO: implement
 147    """
 148 search  [options...] <search-terms> [...]
 149
 150         Search for messages matching the given search terms.
 151
 152 show    <search-terms> [...]
 153
 154         Show all messages matching the search terms.
 155
 156 count   <search-terms> [...]
 157
 158         Count messages matching the search terms.
 159
 160 reply   [options...] <search-terms> [...]
 161
 162         Construct a reply template for a set of messages.
 163
 164 tag     +<tag>|-<tag> [...] [--] <search-terms> [...]
 165
 166         Add/remove tags for all messages matching the search terms.
 167
 168 dump    [<filename>]
 169
 170         Create a plain-text dump of the tags for each message.
 171
 172 restore <filename>
 173         search-tags     [<search-terms> [...] ]
 174
 175                 List all tags found in the database or matching messages.
 176    """