blob: 317d069303c882f68f3d7f4b92968e38810087c7 (
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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
=========================
Command line list display
=========================
A system administrator can display all the mailing lists via the command
line. When there are no mailing lists, a helpful message is displayed.
::
>>> command = cli('mailman.commands.cli_lists.lists')
>>> command('mailman lists')
No matching mailing lists found
When there are a few mailing lists, they are shown in alphabetical order by
their fully qualified list names, with a description.
::
>>> from mailman.interfaces.domain import IDomainManager
>>> from zope.component import getUtility
>>> getUtility(IDomainManager).add('example.net')
<Domain example.net...>
>>> mlist_1 = create_list('list-one@example.com')
>>> mlist_1.description = 'List One'
>>> mlist_2 = create_list('list-two@example.com')
>>> mlist_2.description = 'List Two'
>>> mlist_3 = create_list('list-one@example.net')
>>> mlist_3.description = 'List One in Example.Net'
>>> command('mailman lists')
3 matching mailing lists found:
list-one@example.com
list-one@example.net
list-two@example.com
Names
=====
You can display the mailing list names with their posting addresses, using the
``--names/-n`` switch.
>>> command('mailman lists --names')
3 matching mailing lists found:
list-one@example.com [List-one]
list-one@example.net [List-one]
list-two@example.com [List-two]
Descriptions
============
You can also display the mailing list descriptions, using the
``--descriptions/-d`` option.
>>> command('mailman lists --descriptions --names')
3 matching mailing lists found:
list-one@example.com [List-one] - List One
list-one@example.net [List-one] - List One in Example.Net
list-two@example.com [List-two] - List Two
Maybe you want the descriptions but not the names.
>>> command('mailman lists --descriptions --no-names')
3 matching mailing lists found:
list-one@example.com - List One
list-one@example.net - List One in Example.Net
list-two@example.com - List Two
Less verbosity
==============
There's also a ``--quiet/-q`` switch which reduces the verbosity a bit.
>>> command('mailman lists --quiet')
list-one@example.com
list-one@example.net
list-two@example.com
Specific domain
===============
You can narrow the search down to a specific domain with the --domain option.
A helpful message is displayed if no matching domains are given.
>>> command('mailman lists --domain example.org')
No matching mailing lists found
But if a matching domain is given, only mailing lists in that domain are
shown.
>>> command('mailman lists --domain example.net')
1 matching mailing lists found:
list-one@example.net
More than one ``--domain`` argument can be given; then all mailing lists in
matching domains are shown.
>>> command('mailman lists --domain example.com --domain example.net')
3 matching mailing lists found:
list-one@example.com
list-one@example.net
list-two@example.com
Advertised lists
================
Mailing lists can be "advertised" meaning their existence is public knowledge.
Non-advertised lists are considered private. Display through the command line
can select on this attribute.
::
>>> mlist_1.advertised = False
>>> command('mailman lists --advertised')
2 matching mailing lists found:
list-one@example.net
list-two@example.com
|
