aboutsummaryrefslogtreecommitdiff
path: root/bindings/python/docs/source/notmuch.rst
blob: 32e17833a2d26bbf5ae33edb0309d87693653e3e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
The notmuch 'binary'
====================

The cnotmuch module provides *notmuch*, a python reimplementation of the standard notmuch binary for two purposes: first, to allow running the standard notmuch testsuite over the cnotmuch bindings (for correctness and performance testing) and second, to give some examples as to how to use cnotmuch. 'Notmuch' provides a command line interface to your mail database.

A standard install via `easy_install cnotmuch` will not install the notmuch binary, however it is available in the `cnotmuch source code repository <http://bitbucket.org/spaetz/cnotmuch/src/>`_.


It is invoked with the following pattern: `notmuch <command> [args...]`.

Where <command> and [args...] are as follows:

  **setup**	Interactively setup notmuch for first use.
                This has not yet been implemented, and will probably not be
		implemented unless someone puts in the effort.

  **new**	[--verbose]
		Find and import new messages to the notmuch database.

		This has not been implemented yet. We cheat by calling
		the regular "notmuch" binary (which must be in your path
		somewhere).

  **search** [options...] <search-terms> [...]  Search for messages matching the given search terms.

		This has been implemented but for the `--format` and
		`--sort` options.

  **show**	<search-terms> [...]
		Show all messages matching the search terms.

		This has been partially implemented, we show a stub for each 
		found message, but do not output the full message body yet.

  **count**	<search-terms> [...]
		Count messages matching the search terms.

		This has been fully implemented.

  **reply**	[options...] <search-terms> [...]
		Construct a reply template for a set of messages.

		This has not been implemented yet.

  **tag**	+<tag>|-<tag> [...] [--] <search-terms> [...]
		Add/remove tags for all messages matching the search terms.

		This has been fully implemented.

  **dump**	[<filename>]
		Create a plain-text dump of the tags for each message.

		This has been fully implemented.
  **restore**	<filename>
		Restore the tags from the given dump file (see 'dump').

		This has been fully implemented.

  **search-tags**	[<search-terms> [...] ]
		List all tags found in the database or matching messages.

		This has been fully implemented.

  **help**	[<command>]
		This message, or more detailed help for the named command.

		The 'help' page has been implemented, help for single
		commands are missing though. Patches are welcome.