Merge lp:~rajeevs1992/mailman.client/mailmancli into lp:mailman.client

[Rajeev S]

Adds Command line tools and command line shell for mailman.client

GSoC project "Mailman CLI"

The branch contains the Mailman CLI shell as well as the command line tools built as a part of the GSoC 2014, Under the mentors Stephen J Turnbull, Abhilash Raj and Barry Warsaw.

Unmerged revisions

75. By Rajeev S on 2015-03-17

- fixed bug in update global preference, which is readonly
- fixed/improved a few test cases

Global preferences are readonly, which is mentioned in the mmclient docs.
Option to edit the global preferences, which were previously allowed in
CLI are removed.

74. By Rajeev S on 2015-03-15

merged with base

73. By Rajeev S on 2015-03-15

Ported CLI to Py3

72. By Rajeev S on 2014-08-17

- made the docs sphinx compatiable
- added more docs

71. By Rajeev S on 2014-08-13

- added more tests, for the preferences methods
- added a check for HTTPErrors to make sure that
  correct errors are displayed
- scrubbed more code to enhance readability
- added readme for parsers

70. By Rajeev S on 2014-08-09

- modifed the setup.py to use scripts instead of entry_points
- added acks to Google and Mentors in file headers
- improved code for connection verification
- improved the `get_listing` function; moved to utils
- added colors as a seperate file, as per Steve's suggestion

69. By Rajeev S on 2014-08-04

- adds backup and restore tool
- fixed up installation routines
- refactored code to make it installable
- modified `in list` filter to support regular
  expressions
- updated docs and existing tests

68. By Rajeev S on 2014-07-30

- added expoort to csv function for domains, users
  and lists
- updated shell to support object names with whitespaces

67. By Rajeev S on 2014-07-26

- switched command parsing to YACC and LEX
  using python PLY module

66. By Rajeev S on 2014-07-20

- added update preference command
- introduced regex based validation for all commands
- regex stored in config.ini
- added docstrings aka help for all commands
- help stings printed upon error

=== modified file 'README.rst'
--- README.rst	2015-01-01 19:34:58 +0000
+++ README.rst	2015-03-17 19:08:34 +0000
@@ -1,4 +1,9 @@
-Python bindings for the Mailman 3 REST API.
+===========================================================
+mailman.client - Python bindings for the Mailman 3 REST API
+===========================================================
+
+This package is called ``mailman.client``. 
+
 
 ..
     This file is part of mailman.client.
@@ -48,6 +53,15 @@
 See the Launchpad project page for access to the Bazaar branch, bug report,
 etc.
 
+Documentation
+=============
+
+A `simple guide`_ to using the library is available within this package, in
+the form of doctests.   The manual is also available online in the Cheeseshop
+at:
+
+    http://package.python.org/mailman.client
+
 
 Acknowledgements
 ================
@@ -57,3 +71,17 @@
 
 .. _`Cheese Shop`: http://pypi.python.org/mailman.client
 .. _Launchpad: https://launchpad.net/mailman.client
+
+Table of Contents
+=================
+
+.. toctree::
+
+    src/mailmanclient/docs/using.txt
+    src/mailmanclient/cli/docs/using_cli_shell.txt
+    src/mailmanclient/cli/docs/using_cli_tools.txt
+    src/mailmanclient/cli/docs/writing_a_new_command.txt
+    src/mailmanclient/cli/client/parsers/README.txt
+    src/mailmanclient/NEWS.txt
+
+.. _`simple guide`: docs/using.html

=== added file 'conf.py'
--- conf.py	1970-01-01 00:00:00 +0000
+++ conf.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,330 @@
+# -*- coding: utf-8 -*-
+#
+# Mailman CLI documentation build configuration file, created by
+# sphinx-quickstart on Sun Aug 17 13:11:12 2014.
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#sys.path.insert(0, os.path.abspath('.'))
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+#needs_sphinx = '1.0'
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    'sphinx.ext.autodoc',
+]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The suffix of source filenames.
+source_suffix = '.txt'
+
+# The encoding of source files.
+#source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = 'README'
+
+# General information about the project.
+project = u'Mailman CLI'
+copyright = u'2014, Rajeev S'
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The short X.Y version.
+version = '1'
+# The full version, including alpha/beta/rc tags.
+release = '1'
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+#today = ''
+# Else, today_fmt is used as the format for a strftime call.
+#today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ['_build']
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+#default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+#add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+#add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+#show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+# A list of ignored prefixes for module index sorting.
+#modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+#keep_warnings = False
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = 'default'
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+#html_theme_options = {}
+
+# Add any paths that contain custom themes here, relative to this directory.
+#html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+#html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+#html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+#html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+#html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+#html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+#html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+#html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+#html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+#html_additional_pages = {}
+
+# If false, no module index is generated.
+#html_domain_indices = True
+
+# If false, no index is generated.
+#html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+#html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+#html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+#html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+#html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+#html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+#html_file_suffix = None
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'MailmanCLIdoc'
+
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+# The paper size ('letterpaper' or 'a4paper').
+#'papersize': 'letterpaper',
+
+# The font size ('10pt', '11pt' or '12pt').
+#'pointsize': '10pt',
+
+# Additional stuff for the LaTeX preamble.
+#'preamble': '',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+  ('README', 'MailmanCLI.tex', u'Mailman CLI Documentation',
+   u'Rajeev S', 'manual'),
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+#latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+#latex_use_parts = False
+
+# If true, show page references after internal links.
+#latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+#latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+#latex_appendices = []
+
+# If false, no module index is generated.
+#latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    ('README', 'mailmancli', u'Mailman CLI Documentation',
+     [u'Rajeev S'], 1)
+]
+
+# If true, show URL addresses after external links.
+#man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+  ('README', 'MailmanCLI', u'Mailman CLI Documentation',
+   u'Rajeev S', 'MailmanCLI', 'One line description of project.',
+   'Miscellaneous'),
+]
+
+# Documents to append as an appendix to all manuals.
+#texinfo_appendices = []
+
+# If false, no module index is generated.
+#texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+#texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+#texinfo_no_detailmenu = False
+
+
+# -- Options for Epub output ----------------------------------------------
+
+# Bibliographic Dublin Core info.
+epub_title = u'Mailman CLI'
+epub_author = u'Rajeev S'
+epub_publisher = u'Rajeev S'
+epub_copyright = u'2014, Rajeev S'
+
+# The basename for the epub file. It defaults to the project name.
+#epub_basename = u'Mailman CLI'
+
+# The HTML theme for the epub output. Since the default themes are not optimized
+# for small screen space, using the same theme for HTML and epub output is
+# usually not wise. This defaults to 'epub', a theme designed to save visual
+# space.
+#epub_theme = 'epub'
+
+# The language of the text. It defaults to the language option
+# or en if the language is not set.
+#epub_language = ''
+
+# The scheme of the identifier. Typical schemes are ISBN or URL.
+#epub_scheme = ''
+
+# The unique identifier of the text. This can be a ISBN number
+# or the project homepage.
+#epub_identifier = ''
+
+# A unique identification for the text.
+#epub_uid = ''
+
+# A tuple containing the cover image and cover page html template filenames.
+#epub_cover = ()
+
+# A sequence of (type, uri, title) tuples for the guide element of content.opf.
+#epub_guide = ()
+
+# HTML files that should be inserted before the pages created by sphinx.
+# The format is a list of tuples containing the path and title.
+#epub_pre_files = []
+
+# HTML files shat should be inserted after the pages created by sphinx.
+# The format is a list of tuples containing the path and title.
+#epub_post_files = []
+
+# A list of files that should not be packed into the epub file.
+epub_exclude_files = ['search.html']
+
+# The depth of the table of contents in toc.ncx.
+#epub_tocdepth = 3
+
+# Allow duplicate toc entries.
+#epub_tocdup = True
+
+# Choose between 'default' and 'includehidden'.
+#epub_tocscope = 'default'
+
+# Fix unsupported image types using the PIL.
+#epub_fix_images = False
+
+# Scale large images.
+#epub_max_image_width = 0
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+#epub_show_urls = 'inline'
+
+# If false, no index is generated.
+#epub_use_index = True

=== modified file 'setup.py'
--- setup.py	2015-01-01 21:26:10 +0000
+++ setup.py	2015-03-17 19:08:34 +0000
@@ -30,6 +30,7 @@
     packages=find_packages('src'),
     package_dir = {'': 'src'},
     include_package_data=True,
+    scripts=['src/mailmanclient/cli/mmclient'],
     maintainer='Barry Warsaw',
     maintainer_email='[e-mail]',
     description=description('README.rst'),
@@ -42,5 +43,8 @@
     install_requires=[
         'httplib2',
         'six',
+        'mock',
+        'tabulate',
+        'ply',
         ],
     )

=== added directory 'src/mailmanclient.egg-info'
=== added file 'src/mailmanclient.egg-info/PKG-INFO'
--- src/mailmanclient.egg-info/PKG-INFO	1970-01-01 00:00:00 +0000
+++ src/mailmanclient.egg-info/PKG-INFO	2015-03-17 19:08:34 +0000
@@ -0,0 +1,14 @@
+Metadata-Version: 1.1
+Name: mailmanclient
+Version: 1.0.0
+Summary: Python bindings for the Mailman 3 REST API.
+Home-page: http://launchpad.net/mailman.client
+Author: Barry Warsaw
+Author-email: [e-mail]
+License: LGPLv3
+Download-URL: https://launchpad.net/mailman.client/+download
+Description: src/mailmanclient/README.rst
+        
+        src/mailmanclient/NEWS.rst
+        
+Platform: UNKNOWN

=== added file 'src/mailmanclient.egg-info/SOURCES.txt'
--- src/mailmanclient.egg-info/SOURCES.txt	1970-01-01 00:00:00 +0000
+++ src/mailmanclient.egg-info/SOURCES.txt	2015-03-17 19:08:34 +0000
@@ -0,0 +1,59 @@
+MANIFEST.in
+Makefile
+README.rst
+README.txt
+conf.py
+distribute_setup.py
+setup.cfg
+setup.py
+setup_helpers.py
+template.py
+src/mailmanclient/NEWS.txt
+src/mailmanclient/__init__.py
+src/mailmanclient/_client.py
+src/mailmanclient.egg-info/PKG-INFO
+src/mailmanclient.egg-info/SOURCES.txt
+src/mailmanclient.egg-info/dependency_links.txt
+src/mailmanclient.egg-info/requires.txt
+src/mailmanclient.egg-info/top_level.txt
+src/mailmanclient/cli/__init__.py
+src/mailmanclient/cli/mmclient
+src/mailmanclient/cli/client/__init__.py
+src/mailmanclient/cli/client/cmdparser.py
+src/mailmanclient/cli/client/shell.py
+src/mailmanclient/cli/client/parsers/README.txt
+src/mailmanclient/cli/client/parsers/__init__.py
+src/mailmanclient/cli/client/parsers/_set.py
+src/mailmanclient/cli/client/parsers/base.py
+src/mailmanclient/cli/client/parsers/create.py
+src/mailmanclient/cli/client/parsers/delete.py
+src/mailmanclient/cli/client/parsers/disable.py
+src/mailmanclient/cli/client/parsers/enable.py
+src/mailmanclient/cli/client/parsers/show.py
+src/mailmanclient/cli/client/parsers/show_var.py
+src/mailmanclient/cli/client/parsers/subscribe.py
+src/mailmanclient/cli/client/parsers/unset.py
+src/mailmanclient/cli/client/parsers/unsubscribe.py
+src/mailmanclient/cli/client/parsers/update.py
+src/mailmanclient/cli/core/__init__.py
+src/mailmanclient/cli/core/domains.py
+src/mailmanclient/cli/core/lists.py
+src/mailmanclient/cli/core/misc.py
+src/mailmanclient/cli/core/preferences.py
+src/mailmanclient/cli/core/users.py
+src/mailmanclient/cli/docs/using_cli_shell.txt
+src/mailmanclient/cli/docs/using_cli_tools.txt
+src/mailmanclient/cli/docs/writing_a_new_command.txt
+src/mailmanclient/cli/lib/__init__.py
+src/mailmanclient/cli/lib/colors.py
+src/mailmanclient/cli/lib/mailman_utils.py
+src/mailmanclient/cli/lib/utils.py
+src/mailmanclient/cli/tests/__init__.py
+src/mailmanclient/cli/tests/test_domain.py
+src/mailmanclient/cli/tests/test_list.py
+src/mailmanclient/cli/tests/test_preference.py
+src/mailmanclient/cli/tests/test_user.py
+src/mailmanclient/docs/__init__.py
+src/mailmanclient/docs/using.txt
+src/mailmanclient/tests/__init__.py
+src/mailmanclient/tests/test_docs.py
\ No newline at end of file

=== added file 'src/mailmanclient.egg-info/dependency_links.txt'
--- src/mailmanclient.egg-info/dependency_links.txt	1970-01-01 00:00:00 +0000
+++ src/mailmanclient.egg-info/dependency_links.txt	2015-03-17 19:08:34 +0000
@@ -0,0 +1,1 @@
+

=== added file 'src/mailmanclient.egg-info/requires.txt'
--- src/mailmanclient.egg-info/requires.txt	1970-01-01 00:00:00 +0000
+++ src/mailmanclient.egg-info/requires.txt	2015-03-17 19:08:34 +0000
@@ -0,0 +1,5 @@
+httplib2
+six
+mock
+tabulate
+ply

=== added file 'src/mailmanclient.egg-info/top_level.txt'
--- src/mailmanclient.egg-info/top_level.txt	1970-01-01 00:00:00 +0000
+++ src/mailmanclient.egg-info/top_level.txt	2015-03-17 19:08:34 +0000
@@ -0,0 +1,1 @@
+mailmanclient

=== added directory 'src/mailmanclient/cli'
=== added file 'src/mailmanclient/cli/__init__.py'
=== added directory 'src/mailmanclient/cli/client'
=== added file 'src/mailmanclient/cli/client/__init__.py'
=== added file 'src/mailmanclient/cli/client/cmdparser.py'
--- src/mailmanclient/cli/client/cmdparser.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/client/cmdparser.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,365 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+from argparse import ArgumentParser
+from mailmanclient.cli.core.misc import Misc
+from mailmanclient.cli.core.users import Users
+from mailmanclient.cli.core.lists import Lists
+from mailmanclient.cli.core.domains import Domains
+from mailmanclient.cli.core.preferences import Preferences
+from mailmanclient.cli.lib.mailman_utils import MailmanUtils
+
+utils = MailmanUtils()
+
+
+class CmdParser():
+    def __init__(self, command):
+        parser = ArgumentParser(description='Mailman Command Tools')
+        self.initialize_options(parser)
+        self.arguments = vars(parser.parse_args())
+
+    def initialize_options(self, parser):
+        action = parser.add_subparsers(dest='action')
+
+        # Parser for the action `show`
+        action_show = action.add_parser('show')
+        scope = action_show.add_subparsers(dest='scope')
+
+        # Show lists
+        show_list = scope.add_parser('list')
+        show_list.add_argument('list',
+                               help='List details about LIST',
+                               nargs='?')
+        show_list.add_argument('-d',
+                               '--domain',
+                               help='Filter by DOMAIN')
+        show_list.add_argument('-v',
+                               '--verbose',
+                               help='Detailed listing',
+                               action='store_true')
+        show_list.add_argument('--no-header',
+                               help='Omit headings in detailed listing',
+                               action='store_true')
+        show_list.add_argument('--csv',
+                               help='Output as CSV, Specify filename')
+
+        # Show domains
+        show_domain = scope.add_parser('domain')
+        show_domain.add_argument('domain',
+                                 help='List details about DOMAIN',
+                                 nargs='?')
+        show_domain.add_argument('-v',
+                                 '--verbose',
+                                 help='Detailed listing',
+                                 action='store_true')
+        show_domain.add_argument('--no-header',
+                                 help='Omit headings in detailed listing',
+                                 action='store_true')
+        show_domain.add_argument('--csv',
+                                 help='Output as CSV, Specify filename')
+
+        # Show users
+        show_user = scope.add_parser('user')
+        show_user.add_argument('user',
+                               help='List details about USER',
+                               nargs='?')
+        show_user.add_argument('-v',
+                               '--verbose',
+                               help='Detailed listing',
+                               action='store_true')
+        show_user.add_argument('--no-header',
+                               help='Omit headings in detailed listing',
+                               action='store_true')
+        show_user.add_argument('-l',
+                               '--list',
+                               help='Specify list name',
+                               dest='list_name')
+        show_user.add_argument('--csv',
+                               help='Output as CSV, Specify filename')
+
+        # Show preferences
+        preferences = ['receive_list_copy', 'hide_address',
+                       'preferred_language', 'acknowledge_posts',
+                       'delivery_mode', 'receive_own_postings',
+                       'http_etag', 'self_link', 'delivery_status']
+        show_preference = scope.add_parser('preference')
+        show_scope = show_preference.add_subparsers(dest='show_scope')
+
+        show_scope.add_parser('global')
+
+        user_show = show_scope.add_parser('user')
+        user_show.add_argument('--email',
+                               help='Email of user whose '
+                               'preference is to be shown',
+                               required=True)
+
+        address_show = show_scope.add_parser('address')
+        address_show.add_argument('--email',
+                                  help='Address whose preference'
+                                  ' is to be shown',
+                                  required=True)
+
+        member_show = show_scope.add_parser('member')
+        member_show.add_argument('--email',
+                                 help='Address whose preference'
+                                 ' is to be shown',
+                                 required=True)
+        member_show.add_argument('--list',
+                                 help='FQDN name of list',
+                                 required=True)
+
+        show_preference.add_argument('key',
+                                     help='Specify setting name',
+                                     choices=preferences)
+
+        # Parser for the action `create`
+        action_create = action.add_parser('create')
+        scope = action_create.add_subparsers(dest='scope')
+
+        # Create list
+        create_list = scope.add_parser('list')
+        create_list.add_argument('list',
+                                 help='List name. e.g., [e-mail]')
+        # Create domain
+        create_domain = scope.add_parser('domain')
+        create_domain.add_argument('domain',
+                                   help='Create domain DOMAIN')
+        create_domain.add_argument('--contact',
+                                   help='Contact address for domain')
+        # Create users
+        create_user = scope.add_parser('user')
+        create_user.add_argument('email',
+                                 help='Create user [e-mail]')
+        create_user.add_argument('--password',
+                                 help='User password',
+                                 required=True)
+        create_user.add_argument('--name',
+                                 help='Display name of the user',
+                                 required=True)
+
+        # Parser for the action `delete`
+        action_delete = action.add_parser('delete')
+        scope = action_delete.add_subparsers(dest='scope')
+
+        # Delete list
+        delete_list = scope.add_parser('list')
+        delete_list.add_argument('list',
+                                 help='List name. e.g., [e-mail]')
+        delete_list.add_argument('--yes',
+                                 help='Force delete',
+                                 action='store_true')
+        # Delete domain
+        delete_domain = scope.add_parser('domain')
+        delete_domain.add_argument('domain',
+                                   help='Domain name. e.g., domain.org')
+        delete_domain.add_argument('--yes',
+                                   help='Force delete',
+                                   action='store_true')
+        # Delete user
+        delete_user = scope.add_parser('user')
+        delete_user.add_argument('user',
+                                 help='User email e.g., [e-mail]')
+        delete_user.add_argument('--yes',
+                                 help='Force delete',
+                                 action='store_true')
+        # Show Members of a list
+        action_show_member = action.add_parser('show-members')
+        scope = action_show_member.add_subparsers(dest='scope')
+        show_member = scope.add_parser('list')
+        show_member.add_argument('list',
+                                 help='Show members of LIST')
+        show_member.add_argument('-v',
+                                 '--verbose',
+                                 help='Detailed listing',
+                                 action='store_true')
+        show_member.add_argument('--no-header',
+                                 help='Omit headings in detailed listing',
+                                 action='store_true')
+
+        # Parser for the action `subscribe`
+        action_subscribe = action.add_parser('subscribe')
+        scope = action_subscribe.add_subparsers(dest='scope')
+        subscribe_user = scope.add_parser('user')
+        subscribe_user.add_argument('users',
+                                    help='User email list',
+                                    nargs='+')
+        subscribe_user.add_argument('-l',
+                                    '--list',
+                                    help='Specify list name',
+                                    dest='list_name',
+                                    required=True)
+        subscribe_user.add_argument('--quiet',
+                                    help='Do not display feedback',
+                                    action='store_true')
+
+        # Parser for the action `unsubscribe`
+        action_subscribe = action.add_parser('unsubscribe')
+        scope = action_subscribe.add_subparsers(dest='scope')
+        subscribe_user = scope.add_parser('user')
+        subscribe_user.add_argument('users',
+                                    help='User email list',
+                                    nargs='+')
+        subscribe_user.add_argument('-l',
+                                    '--list',
+                                    help='Specify list name',
+                                    dest='list_name',
+                                    required=True)
+        subscribe_user.add_argument('--quiet',
+                                    help='Do not display feedback',
+                                    action='store_true')
+        # Moderation Tools
+
+        # Add Moderator
+        action_add_moderator = action.add_parser('add-moderator')
+        scope = action_add_moderator.add_subparsers(dest='scope')
+        add_moderator = scope.add_parser('list')
+        add_moderator.add_argument('list',
+                                   help='Specify list name')
+        add_moderator.add_argument('-u',
+                                   '--user',
+                                   help='User email list',
+                                   dest='users',
+                                   nargs='+',
+                                   required=True)
+        add_moderator.add_argument('--quiet',
+                                   help='Do not display feedback',
+                                   action='store_true')
+        # Add Owner
+        action_add_owner = action.add_parser('add-owner')
+        scope = action_add_owner.add_subparsers(dest='scope')
+        add_owner = scope.add_parser('list')
+        add_owner.add_argument('list',
+                               help='Specify list name')
+        add_owner.add_argument('-u',
+                               '--user',
+                               help='User email list',
+                               dest='users',
+                               nargs='+')
+        add_owner.add_argument('--quiet',
+                               help='Do not display feedback',
+                               action='store_true')
+        # Remove Moderator
+        action_remove_moderator = action.add_parser('remove-moderator')
+        scope = action_remove_moderator.add_subparsers(dest='scope')
+        remove_moderator = scope.add_parser('list')
+        remove_moderator.add_argument('list',
+                                      help='Specify list name')
+        remove_moderator.add_argument('-u',
+                                      '--user',
+                                      dest='users',
+                                      help='User email list',
+                                      nargs='+')
+        remove_moderator.add_argument('--quiet',
+                                      help='Do not display feedback',
+                                      action='store_true')
+        # Remove Owner
+        action_remove_owner = action.add_parser('remove-owner')
+        scope = action_remove_owner.add_subparsers(dest='scope')
+        remove_owner = scope.add_parser('list')
+        remove_owner.add_argument('list',
+                                  help='Specify list name')
+        remove_owner.add_argument('-u',
+                                  '--user',
+                                  help='User email list',
+                                  dest='users',
+                                  nargs='+')
+        remove_owner.add_argument('--quiet',
+                                  help='Do not display feedback',
+                                  action='store_true')
+        # Edit preferences
+        action_update = action.add_parser('update')
+        scope = action_update.add_subparsers(dest='scope')
+        update_preference = scope.add_parser('preference')
+        update_scope = update_preference.add_subparsers(dest='update_scope')
+
+        user_update = update_scope.add_parser('user')
+        user_update.add_argument('--email',
+                                 help='Email of user whose '
+                                 'preference is to be changed',
+                                 required=True)
+
+        address_update = update_scope.add_parser('address')
+        address_update.add_argument('--email',
+                                    help='Address whose preference'
+                                    ' is to be changed',
+                                    required=True)
+
+        member_update = update_scope.add_parser('member')
+        member_update.add_argument('--email',
+                                   help='Address whose preference'
+                                   ' is to be changed',
+                                   required=True)
+        member_update.add_argument('--list',
+                                   help='FQDN name of list',
+                                   required=True)
+
+        update_preference.add_argument('key',
+                                       help='Specify setting name',
+                                       choices=preferences)
+        update_preference.add_argument('value',
+                                       help='Specify setting value')
+        # Backup Tool
+        action_backup = action.add_parser('backup')
+        action_backup.add_argument('output',
+                                   help='Specify file to write backup')
+
+        # Restore Tool
+        action_backup = action.add_parser('restore')
+        action_backup.add_argument('backup',
+                                   help='Specify backup file location')
+        # Global options
+        parser.add_argument('--host', help='REST API host address')
+        parser.add_argument('--port', help='REST API host port')
+        parser.add_argument('--restuser', help='REST API username')
+        parser.add_argument('--restpass', help='REST API password')
+
+    def run(self):
+        host = self.arguments['host']
+        port = self.arguments['port']
+        username = self.arguments['restuser']
+        password = self.arguments['restpass']
+        client = utils.connect(host=host, port=port,
+                               username=username, password=password)
+        if 'scope' not in self.arguments:
+            self.run_misc_actions()
+            return
+        scopes = {}
+        scopes['user'] = Users
+        scopes['list'] = Lists
+        scopes['domain'] = Domains
+        scopes['preference'] = Preferences
+        self.arguments['action'] = self.arguments['action'].replace('-', '_')
+        try:
+            scope_object = scopes[self.arguments['scope']](client)
+            action_name = self.arguments['action']
+            action = getattr(scope_object, action_name)
+            action(self.arguments)
+        except Exception as e:
+            utils.error(e)
+            exit(1)
+
+    def run_misc_actions(self):
+        action_name = self.arguments['action']
+        misc = Misc()
+        action = getattr(misc, action_name)
+        action(self.arguments)

=== added directory 'src/mailmanclient/cli/client/parsers'
=== added file 'src/mailmanclient/cli/client/parsers/README.txt'
--- src/mailmanclient/cli/client/parsers/README.txt	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/client/parsers/README.txt	2015-03-17 19:08:34 +0000
@@ -0,0 +1,190 @@
+Mailman Shell Parsers
+**********************
+
+This directory consists of the various parsers that
+have been built for use with the mailman shell. The shell
+parser has been built in such a way that each command has
+a different and independent parser, so that adding new commands
+can be done flexibly and easily, without worrying about the
+existing code.
+
+The `show` command
+=================
+
+The command to display the mailman objects
+
+Tokens
+------
+::
+
+    SHOW   : 'show'
+    SCOPE  : '(user|domain|list)s?'
+    WHERE  : 'where'
+    OP     : '=|in|like'
+    AND    : 'and'
+    STRING : '`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+
+Grammar
+-------
+::
+
+    S : SHOW SCOPE FILTER ;
+    FILTER : WHERE EXP | ;
+    EXP : STRING OP STRING CONJ ;
+    CONJ : AND EXP | ;
+
+The `create` command
+====================
+
+The commands to create mailman objects
+
+Tokens
+------
+::
+
+    CREATE : 'create'
+    SCOPE  : 'user|domain|list'
+    WITH   : 'with'
+    AND    : 'and'
+    STRING : '`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+
+Grammar
+-------
+::
+
+    S : CREATE SCOPE WITH EXP ;
+    EXP : STRING "=" STRING CONJ ;
+    CONJ : AND EXP | ;
+
+The `delete` command
+====================
+
+The commands to delete mailman objects
+
+Tokens
+------
+::
+
+    DELETE : 'delete'
+    SCOPE  : '(user|domain|list)s?'
+    WHERE  : 'where'
+    OP     : '=|in|like'
+    AND    : 'and'
+    STRING : '`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+
+Grammar
+-------
+::
+
+    S : DELETE SCOPE FILTER ;
+    FILTER : WHERE EXP | ;
+    EXP : STRING OP STRING CONJ ;
+    CONJ : AND EXP | ;
+
+The `subscribe` Command
+=====================
+
+The commands to subscribe a list of users to a mailing lists
+
+Tokens
+------
+::
+
+    SUBSCRIBE  : 'subscribe'
+    USER       : '(user)?'
+    TO         : 'to'
+    STRING : '`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+
+Grammar
+-------
+::
+
+    S : SUBSCRIBE USER USERLIST TO STRING ;
+    USERLIST : STRING NEXT ;
+    NEXT : USERLIST | ;
+
+The `unsubscribe` Command
+=========================
+
+The commands to unsubscribe a list of users from a mailing lists
+
+Tokens
+------
+::
+
+    UNSUBSCRIBE : 'unsubscribe'
+    USER        : '(user)?'
+    FROM        : 'from'
+    STRING      : '`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+
+Grammar
+-------
+::
+
+    S : UNSUBSCRIBE USER USERLIST TO STRING ;
+    USERLIST : STRING NEXT ;
+    NEXT : USERLIST | ;
+
+The `unset` command
+===================
+
+Command to unset a shell variable
+
+Tokens
+------
+::
+
+    UNSET : 'unset'
+    STRING      : '`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+
+Grammar
+-------
+::
+
+    S : UNSET STRING ;
+
+The `set` Command
+=================
+
+Command to set a shell variable
+
+Tokens
+------
+::
+
+    SET : 'set'
+    STRING      : '`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+
+Grammar
+-------
+::
+
+    S : SET STRING "=" STRING ;
+
+The `update` command
+====================
+
+Command to update a preference
+
+Tokens
+------
+::
+
+    UPDATE      : 'update'
+    PREFERENCE  : 'preference'
+    STRING      : '`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+    TO          : 'to'
+    WITH        : 'with'
+    AND         : 'and'
+    FOR         : 'for'
+    GLOBALLY    : 'globally'
+    DOMAIN      : 'user|address|member'
+
+Grammar
+-------
+::
+
+    S : UPDATE PREFERENCE STRING TO STRING E ;
+    E : GLOBALLY | FOR DOMAIN WITH EXP ;
+    EXP : STRING "=" STRING CONJ ;
+    CONJ : AND EXP | ;

=== added file 'src/mailmanclient/cli/client/parsers/__init__.py'
=== added file 'src/mailmanclient/cli/client/parsers/_set.py'
--- src/mailmanclient/cli/client/parsers/_set.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/client/parsers/_set.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,64 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import ply.yacc as yacc
+from mailmanclient.cli.client.parsers.base import Parser
+
+
+class Set(Parser):
+    tokens = ('SET', 'STRING')
+    literals = ['=', '`']
+    t_ignore = " \t"
+
+    def t_SET(self, t):
+        r'set'
+        return t
+
+    def t_STRING(self, t):
+        r'`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+        t.value = t.value.replace('`', '')
+        return t
+
+    def t_newline(self, t):
+        r'\n+'
+        t.lexer.lineno += t.value.count("\n")
+        return
+
+    def t_error(self, t):
+        raise Exception("Illegal character '%s'" % t.value[0])
+        t.lexer.skip(1)
+
+    def p_statement_scope(self, p):
+        '''S : SET STRING "=" STRING'''
+        self.arguments['key'] = p[2]
+        self.arguments['value'] = p[4]
+
+    def p_error(self, p):
+        if p:
+            raise Exception("Syntax error at '%s'" % p.value)
+        else:
+            raise Exception("Syntax error : Incomplete Command")
+
+    def parse(self, shell):
+        yacc.parse(shell.line)
+        return self.arguments

=== added file 'src/mailmanclient/cli/client/parsers/base.py'
--- src/mailmanclient/cli/client/parsers/base.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/client/parsers/base.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,62 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import os
+import ply.lex as lex
+import ply.yacc as yacc
+
+
+class Parser:
+    """
+    Base class for a lexer/parser that has the rules defined as methods
+    """
+    tokens = ()
+    precedence = ()
+    arguments = {}
+
+    def __init__(self, **kw):
+        self.debug = kw.get('debug', 0)
+        self.names = {}
+        self.arguments = {}
+        try:
+            modname = os.path.split(os.path.splitext(__file__)[0])[1] + "_"
+            modname += self.__class__.__name__
+        except:
+            modname = "parser"+"_"+self.__class__.__name__
+        self.debugfile = modname + ".dbg"
+        self.tabmodule = modname + "_" + "parsetab"
+
+        if not os.path.exists('/tmp/parser_files'):
+            os.mkdir('/tmp/parser_files')
+
+        lex.lex(module=self, debug=self.debug)
+        yacc.yacc(module=self,
+                  debug=self.debug,
+                  debugfile=self.debugfile,
+                  tabmodule=self.tabmodule,
+                  outputdir='/tmp/parser_files')
+
+    def stem(self, token):
+        if token.value[-1] == 's':
+            token.value = token.value[:-1]
+        return token

=== added file 'src/mailmanclient/cli/client/parsers/create.py'
--- src/mailmanclient/cli/client/parsers/create.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/client/parsers/create.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,86 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import ply.yacc as yacc
+from mailmanclient.cli.client.parsers.base import Parser
+
+
+class Create(Parser):
+    tokens = ('CREATE', 'SCOPE', 'STRING', 'WITH', 'AND')
+    literals = ['+', '`', '=']
+    t_ignore = " \t"
+
+    def t_CREATE(self, t):
+        r'create'
+        return t
+
+    def t_SCOPE(self, t):
+        'user|domain|list'
+        return t
+
+    def t_WITH(self, t):
+        'with'
+        return t
+
+    def t_AND(self, t):
+        'and'
+        return t
+
+    def t_STRING(self, t):
+        r'`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+        t.value = t.value.replace('`', '')
+        return t
+
+    def t_newline(self, t):
+        r'\n+'
+        t.lexer.lineno += t.value.count("\n")
+        return
+
+    def t_error(self, t):
+        raise Exception("Illegal character '%s'" % t.value[0])
+        t.lexer.skip(1)
+
+    def p_start_statement(self, p):
+        '''S : CREATE SCOPE WITH EXP'''
+        self.arguments['scope'] = p[2]
+
+    def p_exp_condition(self, p):
+        '''EXP : STRING "=" STRING CONJ'''
+        if 'properties' not in self.arguments:
+            self.arguments['properties'] = {}
+        self.arguments['properties'][p[1]] = p[3]
+
+    def p_conj_exp(self, p):
+        ''' CONJ : AND EXP
+             |'''
+        pass
+
+    def p_error(self, p):
+        if p:
+            raise Exception("Syntax error at '%s'" % p.value)
+        else:
+            raise Exception("Syntax error : Incomplete Command")
+
+    def parse(self, shell):
+        yacc.parse(shell.line)
+        return self.arguments

=== added file 'src/mailmanclient/cli/client/parsers/delete.py'
--- src/mailmanclient/cli/client/parsers/delete.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/client/parsers/delete.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,101 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import ply.yacc as yacc
+from mailmanclient.cli.client.parsers.base import Parser
+from mailmanclient.cli.lib.mailman_utils import MailmanUtils
+
+
+class Delete(Parser):
+    tokens = ('DELETE', 'SCOPE', 'STRING', 'WHERE', 'OP', 'AND')
+    literals = ['+', '`']
+    t_ignore = " \t"
+
+    def t_DELETE(self, t):
+        r'delete'
+        return t
+
+    def t_SCOPE(self, t):
+        '(user|domain|list)s?'
+        return self.stem(t)
+
+    def t_WHERE(self, t):
+        'where'
+        return t
+
+    def t_OP(self, t):
+        '=|in|like'
+        return t
+
+    def t_AND(self, t):
+        'and'
+        return t
+
+    def t_STRING(self, t):
+        r'`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+        t.value = t.value.replace('`', '')
+        return t
+
+    def t_newline(self, t):
+        r'\n+'
+        t.lexer.lineno += t.value.count("\n")
+        return
+
+    def t_error(self, t):
+        raise Exception("Illegal character '%s'" % t.value[0])
+        t.lexer.skip(1)
+
+    def p_statement_scope(self, p):
+        '''S : DELETE SCOPE FILTER'''
+        self.arguments['scope'] = p[2]
+
+    def p_filter(self, p):
+        '''FILTER : WHERE EXP
+                  |'''
+        pass
+
+    def p_exp_condition(self, p):
+        '''EXP : STRING OP STRING CONJ'''
+        if 'filters' not in self.arguments:
+            self.arguments['filters'] = []
+        if p[2] == 'in':
+            self.arguments['filters'].append((p[3], p[2], p[1]))
+        else:
+            self.arguments['filters'].append((p[1], p[2], p[3]))
+
+    def p_conj_exp(self, p):
+        ''' CONJ : AND EXP
+             |'''
+        pass
+
+    def p_error(self, p):
+        if p:
+            raise Exception("Syntax error at '%s'" % p.value)
+        else:
+            raise Exception("Syntax error : Incomplete Command")
+
+    def parse(self, shell):
+        yacc.parse(shell.line)
+        utils = MailmanUtils()
+        self.arguments = utils.add_reserved_vars(self.arguments, shell)
+        return self.arguments

=== added file 'src/mailmanclient/cli/client/parsers/disable.py'
--- src/mailmanclient/cli/client/parsers/disable.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/client/parsers/disable.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,63 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import ply.yacc as yacc
+from mailmanclient.cli.client.parsers.base import Parser
+
+
+class Disable(Parser):
+    tokens = ('DISABLE', 'WHAT')
+    literals = ['=', '`']
+    t_ignore = " \t"
+
+    def t_DISABLE(self, t):
+        r'disable'
+        return t
+
+    def t_WHAT(self, t):
+        r'env'
+        t.value = t.value.replace('`', '')
+        return t
+
+    def t_newline(self, t):
+        r'\n+'
+        t.lexer.lineno += t.value.count("\n")
+        return
+
+    def t_error(self, t):
+        raise Exception("Illegal character '%s'" % t.value[0])
+        t.lexer.skip(1)
+
+    def p_statment(self, p):
+        '''S : DISABLE WHAT'''
+        self.arguments['what'] = p[2]
+
+    def p_error(self, p):
+        if p:
+            raise Exception("Syntax error at '%s'" % p.value)
+        else:
+            raise Exception("Syntax error : Incomplete Command")
+
+    def parse(self, shell):
+        yacc.parse(shell.line)
+        return self.arguments

=== added file 'src/mailmanclient/cli/client/parsers/enable.py'
--- src/mailmanclient/cli/client/parsers/enable.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/client/parsers/enable.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,63 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import ply.yacc as yacc
+from mailmanclient.cli.client.parsers.base import Parser
+
+
+class Enable(Parser):
+    tokens = ('ENABLE', 'WHAT')
+    literals = ['=', '`']
+    t_ignore = " \t"
+
+    def t_ENABLE(self, t):
+        r'enable'
+        return t
+
+    def t_WHAT(self, t):
+        r'env'
+        t.value = t.value.replace('`', '')
+        return t
+
+    def t_newline(self, t):
+        r'\n+'
+        t.lexer.lineno += t.value.count("\n")
+        return
+
+    def t_error(self, t):
+        raise Exception("Illegal character '%s'" % t.value[0])
+        t.lexer.skip(1)
+
+    def p_statment(self, p):
+        '''S : ENABLE WHAT'''
+        self.arguments['what'] = p[2]
+
+    def p_error(self, p):
+        if p:
+            raise Exception("Syntax error at '%s'" % p.value)
+        else:
+            raise Exception("Syntax error : Incomplete Command")
+
+    def parse(self, shell):
+        yacc.parse(shell.line)
+        return self.arguments

=== added file 'src/mailmanclient/cli/client/parsers/show.py'
--- src/mailmanclient/cli/client/parsers/show.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/client/parsers/show.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,101 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import ply.yacc as yacc
+from mailmanclient.cli.client.parsers.base import Parser
+from mailmanclient.cli.lib.mailman_utils import MailmanUtils
+
+
+class Show(Parser):
+    tokens = ('SHOW', 'SCOPE', 'STRING', 'WHERE', 'OP', 'AND')
+    literals = ['+', '`']
+    t_ignore = " \t"
+
+    def t_SHOW(self, t):
+        r'show'
+        return t
+
+    def t_SCOPE(self, t):
+        '(user|domain|list)s?'
+        return self.stem(t)
+
+    def t_WHERE(self, t):
+        'where'
+        return t
+
+    def t_OP(self, t):
+        '=|in|like'
+        return t
+
+    def t_AND(self, t):
+        'and'
+        return t
+
+    def t_STRING(self, t):
+        r'`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+        t.value = t.value.replace('`', '')
+        return t
+
+    def t_newline(self, t):
+        r'\n+'
+        t.lexer.lineno += t.value.count("\n")
+        return
+
+    def t_error(self, t):
+        raise Exception("Illegal character '%s'" % t.value[0])
+        t.lexer.skip(1)
+
+    def p_statement_scope(self, p):
+        '''S : SHOW SCOPE FILTER'''
+        self.arguments['scope'] = p[2]
+
+    def p_filter(self, p):
+        '''FILTER : WHERE EXP
+                  |'''
+        pass
+
+    def p_exp_condition(self, p):
+        '''EXP : STRING OP STRING CONJ'''
+        if 'filters' not in self.arguments:
+            self.arguments['filters'] = []
+        if p[2] == 'in':
+            self.arguments['filters'].append((p[3], p[2], p[1]))
+        else:
+            self.arguments['filters'].append((p[1], p[2], p[3]))
+
+    def p_conj_exp(self, p):
+        ''' CONJ : AND EXP
+             |'''
+        pass
+
+    def p_error(self, p):
+        if p:
+            raise Exception("Syntax error at '%s'" % p.value)
+        else:
+            raise Exception("Syntax error : Incomplete Command")
+
+    def parse(self, shell):
+        yacc.parse(shell.line)
+        utils = MailmanUtils()
+        self.arguments = utils.add_reserved_vars(self.arguments, shell)
+        return self.arguments

=== added file 'src/mailmanclient/cli/client/parsers/show_var.py'
--- src/mailmanclient/cli/client/parsers/show_var.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/client/parsers/show_var.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,63 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import ply.yacc as yacc
+from mailmanclient.cli.client.parsers.base import Parser
+
+
+class ShowVar(Parser):
+    tokens = ('SHOW', 'STRING')
+    literals = ['=', '`']
+    t_ignore = " \t"
+
+    def t_SHOW(self, t):
+        r'show_var'
+        return t
+
+    def t_STRING(self, t):
+        r'`([a-zA-Z0-9_@\.\*\-]*)`'
+        t.value = t.value.replace('`', '')
+        return t
+
+    def t_newline(self, t):
+        r'\n+'
+        t.lexer.lineno += t.value.count("\n")
+        return
+
+    def t_error(self, t):
+        raise Exception("Illegal character '%s'" % t.value[0])
+        t.lexer.skip(1)
+
+    def p_statement_scope(self, p):
+        '''S : SHOW STRING'''
+        self.arguments['key'] = p[2]
+
+    def p_error(self, p):
+        if p:
+            raise Exception("Syntax error at '%s'" % p.value)
+        else:
+            raise Exception("Syntax error : Incomplete Command")
+
+    def parse(self, shell):
+        yacc.parse(shell.line)
+        return self.arguments

=== added file 'src/mailmanclient/cli/client/parsers/subscribe.py'
--- src/mailmanclient/cli/client/parsers/subscribe.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/client/parsers/subscribe.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,84 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import ply.yacc as yacc
+from mailmanclient.cli.client.parsers.base import Parser
+
+
+class Subscribe(Parser):
+    tokens = ('SUBSCRIBE', 'USER', 'STRING', 'TO')
+    literals = ['+', '`', ',']
+    t_ignore = " \t"
+
+    def t_SUBSCRIBE(self, t):
+        r'subscribe'
+        return t
+
+    def t_USER(self, t):
+        '(user)s?'
+        return self.stem(t)
+        return t
+
+    def t_TO(self, t):
+        'to'
+        return t
+
+    def t_STRING(self, t):
+        r'`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+        t.value = t.value.replace('`', '')
+        return t
+
+    def t_newline(self, t):
+        r'\n+'
+        t.lexer.lineno += t.value.count("\n")
+        return
+
+    def t_error(self, t):
+        raise Exception("Illegal character '%s'" % t.value[0])
+        t.lexer.skip(1)
+
+    def p_statement_subscribe(self, p):
+        '''S : SUBSCRIBE USER USERLIST TO STRING'''
+        self.arguments['list'] = p[5]
+        self.arguments['scope'] = p[2]
+
+    def p_get_users(self, p):
+        '''USERLIST : STRING NEXT'''
+        if 'users' not in self.arguments:
+            self.arguments['users'] = []
+        self.arguments['users'].append(p[1])
+
+    def p_next(self, p):
+        '''NEXT : USERLIST
+                |'''
+        pass
+
+    def p_error(self, p):
+        if p:
+            raise Exception("Syntax error at '%s'" % p.value)
+        else:
+            raise Exception("Syntax error : Incomplete Command")
+
+    def parse(self, shell):
+        yacc.parse(shell.line)
+        return self.arguments

=== added file 'src/mailmanclient/cli/client/parsers/unset.py'
--- src/mailmanclient/cli/client/parsers/unset.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/client/parsers/unset.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,63 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import ply.yacc as yacc
+from mailmanclient.cli.client.parsers.base import Parser
+
+
+class Unset(Parser):
+    tokens = ('UNSET', 'STRING')
+    literals = ['=', '`']
+    t_ignore = " \t"
+
+    def t_UNSET(self, t):
+        r'unset'
+        return t
+
+    def t_STRING(self, t):
+        r'`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+        t.value = t.value.replace('`', '')
+        return t
+
+    def t_newline(self, t):
+        r'\n+'
+        t.lexer.lineno += t.value.count("\n")
+        return
+
+    def t_error(self, t):
+        raise Exception("Illegal character '%s'" % t.value[0])
+        t.lexer.skip(1)
+
+    def p_statement_scope(self, p):
+        '''S : UNSET STRING'''
+        self.arguments['key'] = p[2]
+
+    def p_error(self, p):
+        if p:
+            raise Exception("Syntax error at '%s'" % p.value)
+        else:
+            raise Exception("Syntax error : Incomplete Command")
+
+    def parse(self, shell):
+        yacc.parse(shell.line)
+        return self.arguments

=== added file 'src/mailmanclient/cli/client/parsers/unsubscribe.py'
--- src/mailmanclient/cli/client/parsers/unsubscribe.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/client/parsers/unsubscribe.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,83 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import ply.yacc as yacc
+from mailmanclient.cli.client.parsers.base import Parser
+
+
+class Unsubscribe(Parser):
+    tokens = ('UNSUBSCRIBE', 'USER', 'STRING', 'FROM')
+    literals = ['+', '`', ',']
+    t_ignore = " \t"
+
+    def t_UNSUBSCRIBE(self, t):
+        r'unsubscribe'
+        return t
+
+    def t_USER(self, t):
+        '(user)s?'
+        return self.stem(t)
+
+    def t_FROM(self, t):
+        'from'
+        return t
+
+    def t_STRING(self, t):
+        r'`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+        t.value = t.value.replace('`', '')
+        return t
+
+    def t_newline(self, t):
+        r'\n+'
+        t.lexer.lineno += t.value.count("\n")
+        return
+
+    def t_error(self, t):
+        raise Exception("Illegal character '%s'" % t.value[0])
+        t.lexer.skip(1)
+
+    def p_statement_unsubscribe(self, p):
+        '''S : UNSUBSCRIBE USER USERLIST FROM STRING'''
+        self.arguments['list'] = p[5]
+        self.arguments['scope'] = p[2]
+
+    def p_get_users(self, p):
+        '''USERLIST : STRING NEXT'''
+        if 'users' not in self.arguments:
+            self.arguments['users'] = []
+        self.arguments['users'].append(p[1])
+
+    def p_next(self, p):
+        '''NEXT : USERLIST
+                |'''
+        pass
+
+    def p_error(self, p):
+        if p:
+            raise Exception("Syntax error at '%s'" % p.value)
+        else:
+            raise Exception("Syntax error : Incomplete Command")
+
+    def parse(self, shell):
+        yacc.parse(shell.line)
+        return self.arguments

=== added file 'src/mailmanclient/cli/client/parsers/update.py'
--- src/mailmanclient/cli/client/parsers/update.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/client/parsers/update.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,114 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import ply.yacc as yacc
+from mailmanclient.cli.client.parsers.base import Parser
+
+
+class Update(Parser):
+    tokens = ('UPDATE', 'PREFERENCE', 'STRING', 'TO', 'WITH',
+              'AND', 'FOR', 'GLOBALLY', 'DOMAIN')
+    literals = ['=', '`']
+    t_ignore = " \t"
+
+    def t_UPDATE(self, t):
+        r'update'
+        return t
+
+    def t_PREFERENCE(self, t):
+        'preference'
+        return t
+
+    def t_WITH(self, t):
+        'with'
+        return t
+
+    def t_GLOBALLY(self, t):
+        'globally'
+        return t
+
+    def t_DOMAIN(self, t):
+        'user|address|member'
+        return t
+
+    def t_FOR(self, t):
+        'for'
+        return t
+
+    def t_TO(self, t):
+        'to'
+        return t
+
+    def t_AND(self, t):
+        'and'
+        return t
+
+    def t_STRING(self, t):
+        r'`([a-zA-Z0-9_@\.\*\-\$ ]*)`'
+        t.value = t.value.replace('`', '')
+        return t
+
+    def t_newline(self, t):
+        r'\n+'
+        t.lexer.lineno += t.value.count("\n")
+        return
+
+    def t_error(self, t):
+        raise Exception("Illegal character '%s'" % t.value[0])
+        t.lexer.skip(1)
+
+    def p_statement_update(self, p):
+        '''S : UPDATE PREFERENCE STRING TO STRING E'''
+        self.arguments['key'] = p[3]
+        self.arguments['value'] = p[5]
+
+    def p_domain(self, p):
+        '''E : GLOBALLY
+               | FOR DOMAIN WITH EXP'''
+        try:
+            self.arguments['scope'] = p[2]
+        except IndexError:
+            self.arguments['scope'] = p[1]
+
+    def p_exp_condition(self, p):
+        '''EXP : STRING "=" STRING CONJ'''
+        if 'filters' not in self.arguments:
+            self.arguments['filters'] = {}
+        self.arguments['filters'][p[1]] = p[3]
+
+    def p_conj_exp(self, p):
+        ''' CONJ : AND EXP
+                 |'''
+        pass
+
+    def p_error(self, p):
+        if p:
+            raise Exception("Syntax error at '%s'" % p.value)
+        else:
+            raise Exception("Syntax error : Incomplete Command")
+
+    def parse(self, shell):
+        yacc.parse(shell.line)
+        if 'filters' not in self.arguments:
+            self.arguments['filters'] = {}
+        return self.arguments

=== added file 'src/mailmanclient/cli/client/shell.py'
--- src/mailmanclient/cli/client/shell.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/client/shell.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,394 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+from cmd import Cmd
+from mailmanclient.cli.core.lists import Lists
+from mailmanclient.cli.core.domains import Domains
+from mailmanclient.cli.core.users import Users
+from mailmanclient.cli.core.preferences import Preferences
+from mailmanclient.cli.lib.mailman_utils import MailmanUtils
+from mailmanclient.cli.lib.utils import Filter
+
+utils = MailmanUtils()
+
+
+class Shell(Cmd):
+    intro = 'Mailman Command Line Interface'
+    prompt = '>>>'
+    env = {}
+    env_on = True
+    scope_classes = {}
+    scope_listing = {}
+    mmclient = None
+    scopes = ['list', 'user', 'domain']
+    line = None
+
+    def parseline(self, line):
+        """ This function sets the line attribute with the complete
+            command, which is used at the preprocessing stage"""
+        self.line = line
+        return Cmd.parseline(self, line)
+
+    def onecmd(self, s):
+        """ This method overides the Cmd.onecmd method, but eventully
+            calls the Cmd.onecmd function. The purpose of this function
+            is to catch the errors at a single point, rather than all
+            over the code.
+        """
+        try:
+            return Cmd.onecmd(self, s)
+        except Exception as e:
+            utils.error(e)
+            command = s.split()[0]
+            self.do_help(command)
+            return False
+
+    def emptyline(self):
+        """ Action on empty line entry. If not overridden, the shell executes last
+            command on encountering an empty line.
+        """
+        return False
+
+    def initialize(self):
+        """ Method to initialize the shell. Two hash tables are initialised, one
+            for storing the class signatures of the mailman Objects and the
+            other to store the lists of each object.
+        """
+        try:
+            self.mmclient = utils.connect()
+            self.scope_classes['list'] = Lists
+            self.scope_classes['domain'] = Domains
+            self.scope_classes['user'] = Users
+            self.scope_classes['preference'] = Preferences
+            self.refresh_lists()
+        except Exception as e:
+            utils.error(e)
+            exit(1)
+
+    def refresh_lists(self):
+        """ Refreshes the Mailman object list hash tables.
+            Invoke this method explicitly whenever the list contents might
+            get modified.
+        """
+        self.scope_listing['list'] = self.mmclient.lists
+        self.scope_listing['domain'] = self.mmclient.domains
+        self.scope_listing['user'] = self.mmclient.users
+
+    def do_EOF(self, args):
+        print()
+        print('Bye!')
+        exit(0)
+
+    def do_set(self, args):
+        """ Sets a variable in the environment
+ Usage:
+  set `<variable>` = `<value>`
+        """
+        from mailmanclient.cli.client.parsers._set import Set
+        parser = Set()
+        arguments = parser.parse(self)
+        key = arguments['key']
+        value = utils.add_shell_vars(arguments['value'], self)
+        self.env[key] = value
+        utils.warn('`%s` set to value `%s`' % (key, value))
+
+    def do_unset(self, args):
+        """ Delete a shell environment variable
+ Usage:
+  unset `<var_name>`"""
+        from mailmanclient.cli.client.parsers.unset import Unset
+        parser = Unset()
+        arguments = parser.parse(self)
+        key = arguments['key']
+        if key in self.env:
+            del self.env[key]
+            utils.warn('Shell Variable `%s` Deleted' % key)
+        else:
+            raise Exception('Invalid Argument `%s`' % key)
+
+    def do_show_var(self, args):
+        """ Show a shell environment variable
+ Usage:
+  show_var `<var_name>`"""
+        from mailmanclient.cli.client.parsers.show_var import ShowVar
+        parser = ShowVar()
+        arguments = parser.parse(self)
+        key = arguments['key']
+        if key in self.env:
+            utils.emphasize('Value of %s : %s' % (key, self.env[key]))
+        else:
+            raise Exception('Invalid Argument %s' % key)
+
+    def do_disable(self, args):
+        """ Disable the shell environment
+ Usage:
+  disable env"""
+        from mailmanclient.cli.client.parsers.disable import Disable
+        parser = Disable()
+        parser.parse(self)
+        self.env_on = False
+        utils.emphasize('Environment variables disabled')
+
+    def do_enable(self, args):
+        """ Enable the shell environment
+ Usage:
+  enable env"""
+        from mailmanclient.cli.client.parsers.enable import Enable
+        parser = Enable()
+        parser.parse(self)
+        self.env_on = True
+        utils.emphasize('Environment variables enabled')
+
+    def do_show(self, args):
+        """ Show requested mailman objects as a table
+ Usage:
+  show {domain|user|list} where `<object_attribute>` = `<value>`
+  show {domain|user|list} where `<object_attribute>` like `<regex>`
+  show {domain|user|list} where `<regex>` in `<list_attribute>`
+  show {domain|user|list} where <filter2> and <filter2> ..."""
+        from mailmanclient.cli.client.parsers.show import Show
+        parser = Show()
+        arguments = parser.parse(self)
+        scope = arguments['scope']
+        filtered_list = self.scope_listing[scope]
+        if 'filters' in arguments:
+            for i in arguments['filters']:
+                key, op, value = i
+                value = utils.add_shell_vars(value, self)
+                data_filter = Filter()
+                filtered_list = data_filter.get_results(key, value, op, filtered_list)
+                if not filtered_list:
+                    return False
+        scope_object = self.scope_classes[scope](self.mmclient)
+        cmd_arguments = {}
+        if scope == 'list':
+            cmd_arguments['list'] = None
+            cmd_arguments['csv'] = None
+            cmd_arguments['domain'] = None
+            cmd_arguments['verbose'] = True
+            cmd_arguments['no_header'] = False
+        elif scope == 'domain':
+            cmd_arguments['domain'] = None
+            cmd_arguments['csv'] = None
+            cmd_arguments['verbose'] = True
+            cmd_arguments['no_header'] = False
+        elif scope == 'user':
+            cmd_arguments['user'] = None
+            cmd_arguments['csv'] = None
+            cmd_arguments['list_name'] = None
+            cmd_arguments['verbose'] = True
+            cmd_arguments['no_header'] = False
+        scope_object.show(cmd_arguments, filtered_list)
+
+    def do_create(self, args):
+        """ Creates mailman Objects
+ Usage:
+  create user with `email`=`EMAIL` and `password`=`PASSWD` and `name`=`NAME`
+  create domain with `name`=`DOMAIN` and `contact`=`CONTACT`
+  create list with `fqdn_listname`=`LIST`"""
+        from mailmanclient.cli.client.parsers.create import Create
+        parser = Create()
+        arguments = parser.parse(self)
+        scope = arguments['scope']
+        properties = arguments['properties']
+        scope_object = self.scope_classes[scope](self.mmclient)
+        cmd_arguments = {}
+        req_args = []
+        try:
+            if scope == 'list':
+                req_args = ['fqdn_listname']
+                cmd_arguments['list'] = utils.add_shell_vars(properties['fqdn_listname'], self)
+            elif scope == 'domain':
+                req_args = ['name', 'contact']
+                cmd_arguments['domain'] = utils.add_shell_vars(properties['name'], self)
+                cmd_arguments['contact'] = utils.add_shell_vars(properties['contact'], self)
+            elif scope == 'user':
+                req_args = ['email', 'password', 'name']
+                cmd_arguments['email'] = utils.add_shell_vars(properties['email'], self)
+                cmd_arguments['password'] = utils.add_shell_vars(properties['password'], self)
+                cmd_arguments['name'] = utils.add_shell_vars(properties['name'], self)
+        except KeyError:
+            utils.error('Invalid arguments')
+            utils.warn('The required arguments are:')
+            for i in req_args:
+                utils.warn('\t' + i)
+            return False
+        scope_object.create(cmd_arguments)
+        self.refresh_lists()
+
+    def do_delete(self, args):
+        """ Delete specified mailman objects
+ Usage:
+  delete {domain|user|list} where `<object_attribute>` = `<value>`
+  delete {domain|user|list} where `<object_attribute>` like `<regex>`
+  delete {domain|user|list} where `<key>` in `<list_attribute>`
+  delete {domain|user|list} where <filter1> and <filter2> ..."""
+        from mailmanclient.cli.client.parsers.delete import Delete
+        parser = Delete()
+        arguments = parser.parse(self)
+        scope = arguments['scope']
+        filtered_list = self.scope_listing[scope]
+        if 'filters' in arguments:
+            for i in arguments['filters']:
+                key, op, value = i
+                value = utils.add_shell_vars(value, self)
+                data_filter = Filter()
+                filtered_list = data_filter.get_results(key, value, op, filtered_list)
+        if 'filters' in arguments and arguments['filters'] == []:
+            utils.confirm('Delete all %ss?[y/n]' % scope)
+            ans = input()
+            if ans == 'n':
+                return False
+        for i in filtered_list:
+            if scope == 'list':
+                utils.warn('Deleted ' + i.fqdn_listname)
+                i.delete()
+            elif scope == 'domain':
+                utils.warn('Deleted ' + i.base_url)
+                self.mmclient.delete_domain(i.mail_host)
+            elif scope == 'user':
+                utils.warn('Deleted ' + i.display_name)
+                i.delete()
+            self.refresh_lists()
+
+    def do_subscribe(self, args):
+        """ Subscribes users to a list
+ Usage:
+  subscribe users `<email1>` `<email2>` ... to `<list fqdn_name>`"""
+        from mailmanclient.cli.client.parsers.subscribe import Subscribe
+        parser = Subscribe()
+        arguments = parser.parse(self)
+        users = arguments['users']
+        cleaned_list = []
+        for i in users:
+            cleaned_list.append(utils.add_shell_vars(i, self))
+        users = cleaned_list
+        list_name = utils.add_shell_vars(arguments['list'], self)
+        user_object = self.scope_classes['user'](self.mmclient)
+        cmd_arguments = {}
+        cmd_arguments['users'] = users
+        cmd_arguments['list_name'] = list_name
+        cmd_arguments['quiet'] = False
+        user_object.subscribe(cmd_arguments)
+        self.refresh_lists()
+
+    def do_unsubscribe(self, args):
+        """ Unsubscribes users from a list
+ Usage:
+  unsubscribe users `<email1>` [`<email2>` ...] from `<list fqdn_name>`
+        """
+        from mailmanclient.cli.client.parsers.unsubscribe import Unsubscribe
+        parser = Unsubscribe()
+        arguments = parser.parse(self)
+        users = arguments['users']
+        cleaned_list = []
+        for i in users:
+            cleaned_list.append(utils.add_shell_vars(i, self))
+        users = cleaned_list
+        list_name = utils.add_shell_vars(arguments['list'], self)
+        user_object = self.scope_classes['user'](self.mmclient)
+        cmd_arguments = {}
+        cmd_arguments['users'] = users
+        cmd_arguments['list_name'] = list_name
+        cmd_arguments['quiet'] = False
+        user_object.unsubscribe(cmd_arguments)
+        self.refresh_lists()
+
+    def do_update(self, args):
+        """ Command to set preferences
+ Usage:
+
+   update preference `<preference_name>` to `<value>` for member with
+    `email` = `[e-mail]`
+    and `list` = `[e-mail]`
+
+   update preference `<preference_name>` to `<value>`
+    for user with `email` = `[e-mail]`
+
+   update preference `<preference_name>` to `<value>`
+    for address with `email` = `[e-mail]`"""
+        from mailmanclient.cli.client.parsers.update import Update
+        parser = Update()
+        arguments = parser.parse(self)
+        scope = arguments['scope']
+        preferences = self.scope_classes['preference'](self.mmclient)
+        cmd_arguments = {}
+        cmd_arguments['key'] = arguments['key']
+        cmd_arguments['value'] = arguments['value']
+        if scope == 'globally':
+            cmd_arguments['update_scope'] = 'global'
+        else:
+            cmd_arguments['update_scope'] = scope
+        for i in arguments['filters']:
+            cmd_arguments[i] = utils.add_shell_vars(arguments['filters'][i], self)
+        preferences.update(cmd_arguments)
+
+    def _complete(self, text, keys):
+        """ Method for computing the auto suggest suggestions
+        """
+        if not text:
+            completions = keys
+        else:
+            completions = [k
+                           for k in keys
+                           if k.startswith(text)
+                           ]
+        return completions
+
+    def complete_set(self, text, line, begidx, endidx):
+        keys = self.env.keys()
+        keys.extend(self.scopes)
+        return self._complete(text, keys)
+
+    def complete_unset(self, text, line, begidx, endidx):
+        return self._complete(text, self.env.keys())
+
+    def complete_show_var(self, text, line, begidx, endidx):
+        return self._complete(text, self.env.keys())
+
+    def complete_delete(self, text, line, begidx, endidx):
+        return self._complete(text, self.scopes)
+
+    def complete_create(self, text, line, begidx, endidx):
+        return self._complete(text, self.scopes)
+
+    def complete_show(self, text, line, begidx, endidx):
+        return self._complete(text, self.scopes)
+
+    def complete_subscribe(self, text, line, begidx, endidx):
+        return self._complete(text, ['user'])
+
+    def complete_unsubscribe(self, text, line, begidx, endidx):
+        return self._complete(text, ['user'])
+
+    def complete_disable(self, text, line, begidx, endidx):
+        disable_list = ['env']
+        return self._complete(text, disable_list)
+
+    def complete_enable(self, text, line, begidx, endidx):
+        enable_list = ['env']
+        return self._complete(text, enable_list)
+
+    def complete_update(self, text, line, begidx, endidx):
+        _list = ['preference']
+        return self._complete(text, _list)

=== added directory 'src/mailmanclient/cli/core'
=== added file 'src/mailmanclient/cli/core/__init__.py'
=== added file 'src/mailmanclient/cli/core/domains.py'
--- src/mailmanclient/cli/core/domains.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/core/domains.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,136 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+from tabulate import tabulate
+from six.moves.urllib_error import HTTPError
+from mailmanclient.cli.lib.utils import Utils
+
+
+utils = Utils()
+
+
+class DomainException(Exception):
+    """ Exception on invalid domain """
+    pass
+
+
+class Domains():
+    """Domain related actions."""
+
+    def __init__(self, client):
+        self.client = client
+
+    def create(self, args):
+        """Create a domain name with specified domain_name.
+           Optionally, the contact address can also be specified.
+
+           :param args: Commandline arguments
+           :type args: dictionary
+        """
+        domain_name = args['domain']
+        contact_address = args['contact']
+
+        try:
+            self.client.create_domain(domain_name,
+                                      contact_address=contact_address)
+        except HTTPError as e:
+            code = e.getcode()
+            if code == 400:
+                raise DomainException('Domain already exists')
+            else:
+                raise DomainException('An unknown HTTPError has occured')
+
+    def show(self, args, domains_ext=None):
+        """List the domains in the system.
+
+           :param args: Commandline arguments
+           :type args: dictionary
+        """
+        if args['domain'] is not None:
+            self.describe(args)
+            return
+
+        headers = []
+        fields = ['base_url']
+        domains = []
+
+        if domains_ext:
+            domains = domains_ext
+        else:
+            domains = self.client.domains
+
+        if not args['no_header'] and args['verbose']:
+            headers = ['Base URL', 'Contact address',
+                       'Mail host', 'URL host']
+
+        if args['verbose']:
+            fields = ['base_url', 'contact_address', 'mail_host', 'url_host']
+
+        table = utils.get_listing(domains, fields)
+
+        if args['csv']:
+            utils.write_csv(table, headers, args['csv'])
+        else:
+            print(tabulate(table, headers=headers, tablefmt='plain'))
+
+    def describe(self, args):
+        try:
+            domain = self.client.get_domain(args['domain'])
+        except HTTPError as e:
+            code = e.getcode()
+            if code == 404:
+                raise DomainException('Domain not found')
+            else:
+                raise DomainException('An unknown HTTPError has occured')
+        table = []
+        table.append(['Base URL', domain.base_url])
+        table.append(['Contact Address', domain.contact_address])
+        table.append(['Mail Host', domain.mail_host])
+        table.append(['URL Host', domain.url_host])
+        utils.set_table_section_heading(table, 'Description')
+        table.append([domain.description, ''])
+        utils.set_table_section_heading(table, 'Lists')
+        for _list in domain.lists:
+            table.append([_list.list_id, ''])
+        print(tabulate(table, tablefmt='plain'))
+
+    def delete(self, args):
+        try:
+            domain = self.client.get_domain(args['domain'])
+        except HTTPError as e:
+            code = e.getcode()
+            if code == 404:
+                raise DomainException('Domain not found')
+            else:
+                raise DomainException('An unknown HTTPError has occured')
+        if not args['yes']:
+            utils.confirm('Domain `%s` has %d lists.Delete?[y/n]'
+                          % (args['domain'], len(domain.lists)))
+            confirm = input()
+            if confirm == 'y':
+                args['yes'] = True
+            elif confirm == 'n':
+                return
+            else:
+                raise Exception('Invalid answer')
+        self.client.delete_domain(args['domain'])

=== added file 'src/mailmanclient/cli/core/lists.py'
--- src/mailmanclient/cli/core/lists.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/core/lists.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,227 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+from tabulate import tabulate
+from six.moves.urllib_error import HTTPError
+from mailmanclient.cli.lib.utils import Utils
+from mailmanclient.cli.core.domains import DomainException
+
+
+utils = Utils()
+
+
+class ListException(Exception):
+    """ List Exceptions """
+    pass
+
+
+class Lists():
+
+    """Mailing list related actions."""
+
+    def __init__(self, client):
+        self. client = client
+
+    def create(self, args):
+        """Create a mailing list with specified list_name
+           in the domain specified by domain_name.
+
+           :param args: Commandline arguments
+           :type args: dictionary
+        """
+        name = args['list'].split('@')
+
+        try:
+            list_name = name[0]
+            domain_name = name[1]
+        except IndexError:
+            raise ListException('Invalid FQDN list name')
+
+        if list_name.strip() == '' or domain_name.strip() == '':
+            raise ListException('Invalid FQDN list name')
+
+        domain = self.get_domain(domain_name)
+
+        try:
+            domain.create_list(list_name)
+        except HTTPError as e:
+            code = e.getcode()
+            if code == 400:
+                raise ListException('List already exists')
+            else:
+                raise Exception('An unknown HTTPError has occoured')
+
+    def show(self, args, lists_ext=None):
+        """List the mailing lists in the system or under a domain.
+
+           :param args: Commandline arguments
+           :type args: dictionary
+        """
+        if args['list'] is not None:
+            self.describe(args)
+            return
+
+        lists = []
+        fields = ['list_id']
+        headers = []
+
+        if args['domain']:
+            domain = self.get_domain(args['domain'])
+            lists = domain.lists
+        elif lists_ext:
+            lists = lists_ext
+        else:
+            lists = self.client.lists
+
+        if args['verbose']:
+            fields = ['list_id', 'list_name',
+                      'mail_host', 'display_name',
+                      'fqdn_listname']
+
+        if not args['no_header'] and args['verbose']:
+            headers = ['ID', 'Name', 'Mail host', 'Display Name', 'FQDN']
+
+        table = utils.get_listing(lists, fields)
+
+        if args['csv']:
+            utils.write_csv(table, headers, args['csv'])
+        else:
+            print(tabulate(table, headers=headers, tablefmt='plain'))
+
+    def describe(self, args):
+        _list = self.get_list(args['list'])
+        table = []
+        table.append(['List ID', _list.list_id])
+        table.append(['List name', _list.list_name])
+        table.append(['Mail host', _list.mail_host])
+        utils.set_table_section_heading(table, 'List Settings')
+        for i in _list.settings:
+            table.append([i, str(_list.settings[i])])
+        utils.set_table_section_heading(table, 'Owners')
+        for owner in _list.owners:
+            table.append([owner, ''])
+        utils.set_table_section_heading(table, 'Moderators')
+        for moderator in _list.moderators:
+            table.append([moderator, ''])
+        utils.set_table_section_heading(table, 'Members')
+        for member in _list.members:
+            email = member.address.split('/')[-1]
+            table.append([email, ''])
+        print(tabulate(table, tablefmt='plain'))
+
+    def add_moderator(self, args):
+        _list = self.get_list(args['list'])
+        users = args['users']
+        quiet = args['quiet']
+        for user in users:
+            try:
+                _list.add_moderator(user)
+                if not quiet:
+                    utils.warn('Added %s as moderator' % (user))
+            except Exception as e:
+                if not quiet:
+                    utils.error('Failed to add %s : %s ' %
+                                (user, e))
+
+    def add_owner(self, args):
+        _list = self.get_list(args['list'])
+        users = args['users']
+        quiet = args['quiet']
+        for user in users:
+            try:
+                _list.add_owner(user)
+                if not quiet:
+                    utils.warn('Added %s as owner' % (user))
+            except Exception as e:
+                if not quiet:
+                    utils.error('Failed to add %s : %s ' %
+                                (user, e))
+
+    def remove_moderator(self, args):
+        _list = self.get_list(args['list'])
+        users = args['users']
+        quiet = args['quiet']
+        for user in users:
+            try:
+                _list.remove_moderator(user)
+                if not quiet:
+                    utils.warn('Removed %s as moderator' % (user))
+            except Exception as e:
+                if not quiet:
+                    utils.error('Failed to remove %s : %s ' %
+                                (user, e))
+
+    def remove_owner(self, args):
+        _list = self.get_list(args['list'])
+        users = args['users']
+        quiet = args['quiet']
+        for user in users:
+            try:
+                _list.remove_owner(user)
+                if not quiet:
+                    utils.warn('Removed %s as owner' % (user))
+            except Exception as e:
+                if not quiet:
+                    utils.error('Failed to remove %s : %s ' %
+                                (user, e))
+
+    def show_members(self, args):
+        from core.users import Users
+        users = Users(self.client)
+        args['list_name'] = args['list']
+        args['user'] = None
+        users.show(args)
+
+    def delete(self, args):
+        _list = self.get_list(args['list'])
+        if not args['yes']:
+            utils.confirm('List %s has %d members.Delete?[y/n]'
+                          % (args['list'], len(_list.members)))
+            confirm = input()
+            if confirm == 'y':
+                args['yes'] = True
+            elif confirm == 'n':
+                return
+            else:
+                raise Exception('Invalid Answer')
+        _list.delete()
+
+    def get_list(self, listname):
+        try:
+            return self.client.get_list(listname)
+        except HTTPError as e:
+            code = e.getcode()
+            if code == 404:
+                raise ListException('List not found')
+            else:
+                raise Exception('An unknown HTTPError has occoured')
+
+    def get_domain(self, domainname):
+        try:
+            return self.client.get_domain(domainname)
+        except HTTPError as e:
+            code = e.getcode()
+            if code == 404:
+                raise DomainException('Domain not found')
+            else:
+                raise Exception('An unknown HTTPError has occoured')

=== added file 'src/mailmanclient/cli/core/misc.py'
--- src/mailmanclient/cli/core/misc.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/core/misc.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,69 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import os
+import zipfile
+from mailman.config import config
+from mailmanclient.cli.lib.utils import Utils
+
+
+utils = Utils()
+
+
+class MiscException(Exception):
+    """ Exceptions for miscellaneous actions """
+    pass
+
+
+class Misc():
+    """ Miscellaneous actions """
+
+    def backup(self, args):
+        config.load()
+        vardir = config.paths['VAR_DIR']
+        output = args['output']
+        if not output.endswith('.zip'):
+            output += '.zip'
+        relroot = os.path.abspath(os.path.join(vardir, os.pardir))
+        with zipfile.ZipFile(output, "w", zipfile.ZIP_DEFLATED) as z:
+            for root, dirs, files in os.walk(vardir):
+                z.write(root, os.path.relpath(root, relroot))
+                for f in files:
+                    filename = os.path.join(root, f)
+                    if os.path.isfile(filename):
+                        arcname = os.path.join(os.path.relpath(root, relroot),
+                                               f)
+                        z.write(filename, arcname)
+
+    def restore(self, args):
+        config.load()
+        vardir = config.paths['VAR_DIR']
+        backup = args['backup']
+        if os.path.exists(vardir):
+            utils.confirm('The existing var_dir will be replaced.Continue?[y/n]')
+            confirm = input()
+            if not confirm == 'y':
+                return
+        vardir += '/../'
+        with zipfile.ZipFile(backup) as zf:
+            zf.extractall(vardir)

=== added file 'src/mailmanclient/cli/core/preferences.py'
--- src/mailmanclient/cli/core/preferences.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/core/preferences.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,96 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+from mailmanclient.cli.lib.utils import Utils
+
+
+utils = Utils()
+
+
+class PreferenceException(Exception):
+    pass
+
+
+class Preferences():
+    """Preferences related actions."""
+
+    def __init__(self, client):
+        self.client = client
+
+    def get_scope_object(self, scope, args):
+        scope_object = None
+        try:
+            if scope == 'global':
+                scope_object = self.client
+            elif scope == 'user':
+                scope_object = self.client.get_user(args['email'])
+            elif scope == 'member':
+                scope_object = self.client.get_member(args['list'],
+                                                      args['email'])
+            else:
+                scope_object = self.client.get_address(args['email'])
+        except:
+            raise PreferenceException('%s not found' % scope.capitalize())
+        return scope_object
+
+    def update(self, args):
+        """Update a preference specified by the `key` to `value`
+           Preferences can be set at a global, user, address or at
+           a member level.
+        """
+        scope = args['update_scope']
+        if scope == 'global':
+            raise PreferenceException('Global preferences are readonly')
+        scope_object = self.get_scope_object(scope, args)
+        preferences = None
+        key = args['key']
+        value = args['value']
+        preferences = scope_object.preferences
+        try:
+            preferences[key]
+        except Exception:
+            raise PreferenceException('Saving Preference Failed')
+        if type(preferences[key]).__name__ in ('bool', 'NoneType'):
+            value = value.lower().strip()
+            if value == 'true':
+                value = True
+            elif value == 'false':
+                value = False
+            else:
+                raise PreferenceException('Invalid value for preference.'
+                                          'Expected values : True/False')
+        try:
+            preferences[key] = value
+            preferences.save()
+        except Exception:
+            raise PreferenceException('Saving Preference Failed')
+
+    def show(self, args):
+        """Given a preference key, and a specific object, print
+           the current value of the preference for that object."""
+        scope = args['show_scope']
+        scope_object = self.get_scope_object(scope, args)
+        preferences = None
+        key = args['key']
+        preferences = scope_object.preferences
+        print(str(preferences[key]))

=== added file 'src/mailmanclient/cli/core/users.py'
--- src/mailmanclient/cli/core/users.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/core/users.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,189 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+from tabulate import tabulate
+from six.moves.urllib_error import HTTPError
+from mailmanclient.cli.lib.utils import Utils
+from mailmanclient.cli.core.lists import ListException
+
+utils = Utils()
+
+
+class UserException(Exception):
+    """ User Exceptions """
+    pass
+
+
+class Users():
+
+    """User related actions."""
+
+    def __init__(self, client):
+        self.client = client
+
+    def create(self, args):
+        """Create a user with specified email,password and display name.
+
+           :param args: Commandline arguments
+           :type args: dictionary
+        """
+        email = args['email']
+        password = args['password']
+        display_name = args['name']
+
+        try:
+            self.client.create_user(email=email,
+                                    password=password,
+                                    display_name=display_name)
+        except HTTPError as e:
+            code = e.getcode()
+            if code == 400:
+                raise UserException('User already exists')
+            else:
+                raise UserException('An unknown HTTPError has occured')
+
+    def show(self, args, users_ext=None):
+        """List users in the system.
+
+
+           :param args: Commandline arguments
+           :type args: dictionary
+        """
+        if args['user'] is not None:
+            self.describe(args)
+            return
+
+        headers = []
+        fields = ['addresses']
+        users = []
+
+        if args['verbose']:
+            fields = ['display_name', 'addresses', 'created_on', 'user_id']
+
+        if not args['no_header'] and args['verbose']:
+            headers = ['Display Name', 'Address', 'Created on', 'User ID']
+
+        if args['list_name']:
+            users = self.get_users(args['list_name'])
+        elif users_ext:
+            users = users_ext
+        else:
+            users = self.client.users
+
+        table = utils.get_listing(users, fields)
+
+        if args['csv']:
+            utils.write_csv(table, headers, args['csv'])
+        else:
+            print(tabulate(table, headers=headers, tablefmt='plain'))
+
+    def get_users(self, listname):
+        users = []
+        _list = self.client.get_list(listname)
+        for member in _list.members:
+            users.append(member.user)
+        return users
+
+    def describe(self, args):
+        ''' Describes a user object '''
+        user = self.get_user(args['user'])
+        table = []
+        table.append(['User ID', user.user_id])
+        table.append(['Display Name', user.display_name])
+        table.append(['Created on', user.created_on])
+        table.append(['Self Link', user.self_link])
+        utils.set_table_section_heading(table, 'User Preferences')
+        preferences = user.preferences._preferences
+        for i in preferences:
+            table.append([i, str(preferences[i])])
+        utils.set_table_section_heading(table, 'Subscription List IDs')
+        for _list in user.subscription_list_ids:
+            table.append([_list, ''])
+        utils.set_table_section_heading(table, 'Subscriptions')
+        for subscription in user.subscriptions:
+            email = subscription.address.split('/')[-1]
+            table.append([email+' at '+str(subscription.list_id),
+                         str(subscription.role)])
+        print(tabulate(table, tablefmt='plain'))
+
+    def delete(self, args):
+        ''' Deletes a User object '''
+        user = self.client.get_user(args['user'])
+        if not args['yes']:
+            utils.confirm('Delete user %s?[y/n]' % args['user'])
+            confirm = input()
+            if confirm == 'y':
+                args['yes'] = True
+            elif confirm == 'n':
+                return
+            else:
+                raise Exception('Invalid answer')
+        user.delete()
+
+    def subscribe(self, args):
+        ''' Subsribes a user or a list of users to a list '''
+        list_name = args['list_name']
+        emails = args['users']
+        _list = self.client.get_list(list_name)
+        for i in emails:
+            try:
+                _list.subscribe(i)
+                if not args['quiet']:
+                    utils.warn('%s subscribed to %s' % (i, list_name))
+            except Exception as e:
+                if not args['quiet']:
+                    utils.error('Failed to subscribe %s : %s' % (i, e))
+
+    def unsubscribe(self, args):
+        ''' Unsubsribes a user or a list of users from a list '''
+        list_name = args['list_name']
+        emails = args['users']
+        _list = self.client.get_list(list_name)
+        for i in emails:
+            try:
+                _list.unsubscribe(i)
+                if not args['quiet']:
+                    utils.warn('%s unsubscribed from %s' % (i, list_name))
+            except Exception as e:
+                if not args['quiet']:
+                    utils.error('Failed to unsubscribe %s : %s' % (i, e))
+
+    def get_list(self, listname):
+        try:
+            return self.client.get_list(listname)
+        except HTTPError as e:
+            code = e.getcode()
+            if code == 404:
+                raise ListException('List not found')
+            else:
+                raise ListException('An unknown HTTPError has occured')
+
+    def get_user(self, username):
+        try:
+            return self.client.get_user(username)
+        except HTTPError as e:
+            code = e.getcode()
+            if code == 404:
+                raise UserException('User not found')
+            else:
+                raise UserException('An unknown HTTPError has occured')

=== added directory 'src/mailmanclient/cli/docs'
=== added file 'src/mailmanclient/cli/docs/using_cli_shell.txt'
--- src/mailmanclient/cli/docs/using_cli_shell.txt	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/docs/using_cli_shell.txt	2015-03-17 19:08:34 +0000
@@ -0,0 +1,150 @@
+The Mailman Command Line Shell
+******************************
+
+This document describes the usage of the Mailman Command line
+shell, using which you can query a mailman installation with ease.
+
+Firing and Exiting the Shell
+============================
+
+You can start the mailman shell by executing the mmclient command,
+without any arguments::
+
+    $ ./mmclient
+    Mailman Command Line Interface
+    >>>
+
+To exit the shell, use the ``EOF`` character, that is, ``Ctrl + d``.
+
+Displaying Mailman Objects
+==========================
+
+The shell can be used to display the mailman objects, using the show
+command.
+
+For example::
+
+    >>> show users
+    >>> show domains
+    >>> show lists
+
+Further, the CLI supports filtering of mailman objects based upon their
+attribute values or properties, using a `where` clause. For this, the CLI 
+employs 3 filters, which are::
+
+    =        Equality
+    like     Case insensitive regular exp mathcing
+    in       Search inside a property which list
+
+These filteres can be used in conjunction by using an ``and`` clause
+
+Examples: ::
+
+    >>> show users where `display_name` = `Foo`
+    >>> show users where `display_name` like `.*Foo*`
+    >>> show lists where `[e-mail]` in `moderators`
+    >>> show lists where `[e-mail]` in `moderators` and `[e-mail]` in `owners`
+
+The Shell Environment
+======================
+
+The shell provides a facility to create variables that can be used to
+make the querying easier.
+
+For using the shell, two commands, ``set`` and ``unset`` are used.
+
+Example::
+
+    >>> set `useremail` = `[e-mail]`
+
+The variables can be used in the queries as follows::
+
+    >>> show lists where `$useremail` in `moderators`
+
+The ``$username`` will be replaced with the value of ``useremail``
+
+The environment can be disabled using the `disable environemt`
+command, that prevents the CLI from replacing the query terms
+with environment variables, or appending of the specialised 
+variables.
+
+The disabled environment can be enabled using the `enable env`
+command.::
+
+    >>> disable env
+    >>> enable env
+
+The environment supports a set of special variables, which denote 
+the names of the scopes available in mailman. They are domain, list and
+user.
+
+The special environment variables are appended automatically with relevant commands
+
+For example, if the environment variable domain is set to a domain name, then the
+`show list ` command automatically applies a domain = <set domain> filter to
+the result list.::
+
+  >>> set `domain` = `domain.org`
+  >>> show lists            //Shows lists under domain.org
+  >>> disable env           
+  >>> show lists            //Shows all lists
+  >>> enable env
+
+The value of stored variables can be viewed using the show_var command::
+
+    >>> show_var `domain`
+
+Create Objects
+==============
+
+The Mailman objects can be created using the `create` command
+
+The create command accepts the object properties and creates 
+the object.
+
+If the supplied arguments are invalid or insufficient, the list
+of arguments that are required are displayed.
+
+The create command can be used as follows::
+
+    >>> create list where `fqdn_listname` = `[e-mail]`
+    >>> create domain where `domain` = `domain.org` and `contact` = `[e-mail]`
+    >>> create user where `email` = `[e-mail]` and `password` = `a` and `name` = `Foo`
+
+Delete Objects
+==============
+
+The Mailman objects can be deleted using the delete command. The
+delete command supports the same filters as those by the show command.
+
+For example::
+
+    >>> delete domain where `domain` like `test_.*`
+
+Subscription
+============
+
+The subscription commands include two commands, subscribe and
+unsubscribe users, which are respectively used to subscribe users to a
+list and unsubscribe users from a list. The commands allow applying 
+the action on a single user or multiple users at a time.::
+
+    >>> subscribe users `[e-mail]` `[e-mail]` to `[e-mail]`
+    >>> unsubscribe users `[e-mail]` `[e-mail]` from `[e-mail]`
+
+Update Preferences
+==================
+
+Preferences can be updated using the shell for the following domains
+ - Users
+ - Members
+ - Addresses
+
+The actions are performed using the update command which can be used as follows::
+
+    >>> update preference `<preference_name>` to `<value>` for member with `email` = `[e-mail]`
+        and `list` = `[e-mail]`
+    >>> update preference `<preference_name>` to `<value>` for user with `email` = `[e-mail]`
+    >>> update preference `<preference_name>` to `<value>` for address with `email` = `[e-mail]`
+
+Global preferences are readonly.

=== added file 'src/mailmanclient/cli/docs/using_cli_tools.txt'
--- src/mailmanclient/cli/docs/using_cli_tools.txt	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/docs/using_cli_tools.txt	2015-03-17 19:08:34 +0000
@@ -0,0 +1,311 @@
+The Mailman Command Line Tools
+******************************
+
+Initialization
+==============
+
+The CLI can be started by running mmclient [options|arguments]
+
+If the mmclient is run without any arguments, the shell
+is started, else the specified action is performed. Use EOF
+to exit the shell.::
+
+    $> mmclient 
+    Mailman Command Line Interface v1.0
+    >>>
+    Bye!
+
+    $> mmclient [options]
+
+If you have non-default login credentials, specify them with the
+following options::
+
+    --host HOSTNAME       [defaults to http://127.0.0.1]
+    --port PORTNUMBER     [defaults to 8001]
+    --restuser USERNAME   [defaults to restadmin]
+    --restpass PASSWORD   [defaults to restpass]
+
+Domains
+=======
+
+This section describes the domain related functions that can be performed
+with the CLI.
+
+Create a new domain
+-------------------
+
+To create a new domain::
+
+    $> mmclient create domain testdomain.org
+
+List Domains
+------------
+To list the domains in the system::
+    
+    $> mmclient show domain
+    http://domain.org
+
+To obtain a detailed listing, use the `-v`/`--verbose` switch.
+The detailed listing of domains displays the domains as a table::
+
+    $> mmclient show domain -v
+    Base URL           Contact address        Mail host    URL host
+    http://domain.org  [e-mail]  domain.org   domain.org
+
+In addition, the long listing has a `no-header` switch that can be used 
+to remove the header, making it more comfortable to pipe the output.::
+
+    $> mmclient show domain -v --no-header
+    http://domain.org  [e-mail]  domain.org   domain.org
+
+Delete a domain
+---------------
+
+To delete a domian ::
+    $> mmclient delete domain domain.org
+
+To supress the confirmation message::
+    
+    $> mmclient delete domain domain.org --yes
+
+To obtain a detailed description of a domain at one glance::
+
+    $> mmclient show domain domain.org
+
+Mailing List
+============
+
+This section describes the mailing list related function that can be 
+performed with the CLI.
+
+Create a mailing list
+---------------------
+
+To create a mailing list::
+
+    $> mmclient create list [e-mail]
+
+Show Mailing lists
+-------------------
+
+Show all mailing lists in the system::
+
+    $> mmclient show list
+    foo.domain.org
+    bar.example.org
+
+To display the lists under the domain `domain.org`::
+
+    $> mmclient show list -d domain.org
+    foo.domain.org
+
+Further, a switch -v/--verbose can also be used to print a detailed listing::
+
+    $> mmclient show list --verbose
+    ID               Name    Mail host    Display Name    FQDN
+    list.domain.org  list    domain.org   List            [e-mail]
+
+Again, the `show list` supports a `--no-header` switch that removes
+the header line of the long listing::
+
+    $> mmclient show list --verbose --no-header
+    list.domain.org  list    domain.org   List            [e-mail]
+
+Delete Mailing list
+-------------------
+
+To delete a list::
+
+    $> mmclient delete list [e-mail]
+
+To supress the confirmation message, do::
+    
+    $> mmclient delete list [e-mail] --yes
+
+To obtain a detailed description of a list at one glance::
+
+    $> mmclient show list [e-mail]
+
+Manage list owners, members and moderators::
+---------------------------------
+
+Adding and removing moderators can be performed using the CLI as follows
+
+To get a list of members of a mailing list::
+
+    $> mmclient show-members list [e-mail]
+
+The above command is equivalent to::
+    
+    $> mmclient show user --list [e-mail]
+
+The command also supports flags like:: 
+    
+    --verbose Show a detailed listing
+    --no-header Hide header in detailed listing
+
+Refer the `show user` command for more details
+
+Add or remove list owners and moderators
+-----------------------------------
+
+To add moderators or owners::
+
+    $> mmclient add-moderator list [e-mail] --user [e-mail] [e-mail]
+    $> mmclient add-owner list [e-mail] --user [e-mail] [e-mail]
+
+And to remove moderators or owners::
+
+    $> mmclient remove-moderator list [e-mail] --user [e-mail] [e-mail]
+    $> mmclient remove-owner list [e-mail] --user [e-mail] [e-mail]
+
+The add and remove commands support the action on a list of users 
+at once. Success or failure messages are provided upon completion or
+failure of an action. The messages can be supressed by using a quiet flag::
+
+    $> mmclient remove-moderator list [e-mail] --user [e-mail] [e-mail] --quiet
+
+If the action fails for a user, the user is ignored and the action continues
+without stalling.
+
+User
+====
+
+Craete User
+-----------
+
+To create a new user::
+
+    $> mmclient create user [e-mail] --name "Foo" --password "password"
+
+The `show user` command lists a single email ID of each user::
+
+    $> mmclient show user 
+    [e-mail]
+
+To list users who are members of a list::
+
+    $> mmclient show user --list [e-mail]
+    [e-mail]
+
+The show command also supports a `--verbose` switch ::
+
+    $> mmclient show user --verbose
+    Display Name    Address       Created on                                                  User ID
+    Foo             [e-mail]  2014-05-30T00:52:52.564634  220337223817757552725201672981303248133
+
+and a `--no-header` switch::
+
+    $> mmclient show user --verbose --no-header
+    Foo             [e-mail]  2014-05-30T00:52:52.564634  220337223817757552725201672981303248133
+
+Delete User
+-----------
+
+To delete a user::
+
+    $> mmclient delete user [e-mail]
+
+To supress the confirmation message, do::
+    
+    $> mmclient delete user [e-mail] --yes
+
+Describe user
+-------------
+
+To obtain a detailed description of a user at one glance::
+
+    $> mmclient show user [e-mail]
+
+Subscription and Unsubscription
+--------------------------------
+
+Users can be subscribed to a mailing list by using the subscribe 
+command::
+
+    $> mmclient subscribe user [e-mail] [e-mail] --list [e-mail]
+    [e-mail] subscribed to [e-mail]
+    Failed to subscribe [e-mail] : HTTP Error 409: Member already subscribed
+
+Multiple users can be subscribed to the list at the same time.
+
+Similarly, Users can be unsubscribed to a mailing list by using the unsubscribe 
+command::
+
+    $> mmclient unsubscribe user [e-mail] [e-mail] --list [e-mail]
+    [e-mail] unsubscribed from [e-mail]
+    [e-mail] unsubscribed from [e-mail]
+
+The feedback for the subscribe and unsubscribe actions can be supressed by
+using the --quiet flag::
+
+    $> mmclient subscribe user [e-mail] [e-mail] --list [e-mail] --quiet
+    $> mmclient unsubscribe user [e-mail] [e-mail] --list [e-mail] --quiet
+
+The subscribe and unsubscribe actions continue even if one the users 
+fail to subscribe/unsubscribe to a list. A relevant feedback message is
+provided if the --quiet flag is not enabled.
+
+Preferences
+===========
+
+
+Update Preference
+-----------------
+
+Preferences for user,address,member or globally can be updated and retrieved 
+by using the commands of preference scope.
+
+To update the value of a preference of an user::
+
+    $> mmclient update preference user --email [e-mail] [key] [value]
+
+To update the value of a preference of a member::
+
+    $> mmclient update preference member --email [e-mail] --list [e-mail] [key] [value]
+
+To update the value of a preference of an address::
+
+    $> mmclient update preference address --email [e-mail] [key] [value]
+
+To update the value of a preference globally::
+
+    $> mmclient update preference global [key] [value]
+
+View Setting
+------------
+To view the current value of a preference, use the `mmclient show preference` command
+in the same way above, obviously, without the `value` argument
+
+For eg, to view a setting of a member::
+
+    $> mmclient show preference member --email [e-mail] --list [e-mail] [key]
+
+Both the commands try to suggest the possible preference keys upon errors while typing the
+keys. The commands return `1` upon an invalid key.
+
+Backup and Restore
+==================
+
+The CLI tools can be used to create backups and restore the backups of the 
+Mailman data. The backup currently supports the backup for SQLite mode.
+
+Backup
+------
+
+The backup tools backs up the $var_dir specified by the Mailman configuration
+as a zip archive to a specified location::
+
+    $> mmclient backup ~/backup.zip
+
+Restore
+-------
+To restore the backup, specfiy the path to the backup file::
+
+    $> mmclient restore ~/backup.zip
+
+Please remember to stop the mailman runner before performing
+the backup and restore operations. 
+
+The paths for backup and restore are read from the Mailman configuration
+file.

=== added file 'src/mailmanclient/cli/docs/writing_a_new_command.txt'
--- src/mailmanclient/cli/docs/writing_a_new_command.txt	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/docs/writing_a_new_command.txt	2015-03-17 19:08:34 +0000
@@ -0,0 +1,57 @@
+Writing a new command
+*********************
+
+There are two types of commands in the CLI project, either add a new command
+to the CLI tools, that gives a normal terminal command, or build a command
+for the Mailman custom shell.
+
+Writing a new command for Command tools
+=======================================
+
+To write a new command for the command line tools, the following
+steps are to be followed.
+
+- Decide a command name and arguments expected
+- Decide whether the command comes under a scope. Currently
+the following scopes are supported
+
+    - users
+    - domains
+    - preferences
+    - lists
+
+The new command can either be under any of these scopes or
+can exist independently without a scope.
+
+- If the new command BAR is to be added to an existing scope ``FOO``,
+  the command would look like ``FOO BAR``, where ``FOO`` is the action and
+  BAR is the scope
+- Add a new parser to the `action` parser as::
+    
+   new_cmd = action.add_parser('FOO')
+
+  Add the scope as follows::
+
+   scope = new_cmd.add_subparser(dest='scope')
+   FOO_BAR = scope.add_parser('BAR')
+
+- Add the arguments as follows::
+
+   FOO_BAR.add_argument('-x','--xxxx',help='<help text>',[required=True/False])
+
+- Add the action method in the ``core/bar.py`` file, to the Bar class. In effect, the action
+  method would be ``core.bar.Bar.action``. Note that the function name must be same as the 
+  action name
+
+- If there is no specific scope, skip the scope parser and add the action the Misc class 
+  under ``core/misc.py``. The action would be ``core.misc.Misc.action``
+
+Writing a new command for the Shell
+===================================
+
+To write a new shell command, first add a new parser for the command to the ``client/parsers`` directory.
+
+Add the command method to the ``client/shell.py``
+
+Import the parser in the corresponding method and parse the user input, present in the ``self.line`` attribute
+to obtain the arguments. Perform the action.

=== added directory 'src/mailmanclient/cli/lib'
=== added file 'src/mailmanclient/cli/lib/__init__.py'
=== added file 'src/mailmanclient/cli/lib/colors.py'
--- src/mailmanclient/cli/lib/colors.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/lib/colors.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,32 @@
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+GREY = "\033[90m%s\033[0m"
+RED = "\033[91m%s\033[0m"
+GREEN = "\033[92m%s\033[0m"
+YELLOW = "\033[93m%s\033[0m"
+BLUE = "\033[94m%s\033[0m"
+PURPLE = "\033[95m%s\033[0m"
+CYAN = "\033[96m%s\033[0m"
+WHITE = "\033[97m%s\033[0m"
+BLACK = "\033[98m%s\033[0m"

=== added file 'src/mailmanclient/cli/lib/mailman_utils.py'
--- src/mailmanclient/cli/lib/mailman_utils.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/lib/mailman_utils.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,117 @@
+#!/usr/bin/python
+
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+from mailmanclient import Client, MailmanConnectionError
+from mailman.config import config
+from mailmanclient.cli.lib.utils import Utils
+
+
+class MailmanUtils(Utils):
+
+    """ Utilities relating to Mailman
+        Client or the REST API
+    """
+
+    def __init__(self):
+        config.load()
+
+    def connect(self, *args, **kwargs):
+        """ Connect to Mailman REST API using the arguments specified.
+            Missing arguments are decided from the mailman.cfg file
+            return a client object.
+        """
+        host, port, username, password = self.get_credentials_from_config()
+
+        if 'host' in kwargs and kwargs['host']:
+            host = kwargs['host']
+        if 'port' in kwargs and kwargs['port']:
+            port = kwargs['port']
+        if 'username' in kwargs and kwargs['username']:
+            username = kwargs['username']
+        if 'password' in kwargs and kwargs['password']:
+            password = kwargs['password']
+
+        client = Client('%s:%s/3.0' % (host, port),
+                        username,
+                        password)
+        try:
+            client.system
+        except MailmanConnectionError as e:
+            self.error(e)
+            exit(1)
+        return client
+
+    def get_credentials_from_config(self):
+        """ Returns the credentials required for logging on to
+            the Mailman REST API, that are read from the Mailman
+            configuration.
+        """
+        host = 'http://' + config.schema['webservice']['hostname']
+        port = config.schema['webservice']['port']
+        username = config.schema['webservice']['admin_user']
+        password = config.schema['webservice']['admin_pass']
+        return host, port, username, password
+
+    def get_new_domain_name(self):
+        """ Generates the name of a non existent domain """
+        client = self.connect()
+        while True:
+            domain_name = self.get_random_string(10) + '.com'
+            try:
+                client.get_domain(domain_name)
+                continue
+            except Exception:
+                return domain_name
+
+    def add_shell_vars(self, arg, shell):
+        """ Replaces the variables used in the command with thier respective
+            values if the values are present in the shell environment, else
+            use the variable as such.
+        """
+        if not shell.env_on or not arg:
+            return arg
+        if arg[0] == '$' and arg[1:] in shell.env:
+                arg = shell.env[arg[1:]]
+        return arg
+
+    def add_reserved_vars(self, args, shell):
+        """ Adds the reserved variables to a filter query. The reserved variables
+            are domain, list and user, which are added to respective scopes and
+            atrribute names.
+        """
+        scope = args['scope']
+        if 'filters' not in args:
+            args['filters'] = []
+        if not shell.env_on:
+            return args
+        filters = args['filters']
+        if scope == 'list':
+            if 'domain' in shell.env:
+                filters.append(('mail_host', '=', shell.env['domain']))
+        elif scope == 'user':
+            if 'list' in shell.env:
+                filters.append((shell.env['list'], 'in', 'subscriptions'))
+        args['filters'] = filters
+        return args

=== added file 'src/mailmanclient/cli/lib/utils.py'
--- src/mailmanclient/cli/lib/utils.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/lib/utils.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,216 @@
+#!/usr/bin/python
+
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import re
+import sys
+import csv
+from hashlib import sha1
+from datetime import datetime
+from mailmanclient.cli.lib import colors
+
+
+class Utils():
+    """ General utilities to be used across the CLI """
+
+    WARN = colors.CYAN
+    ERROR = colors.RED
+    CONFIRM = colors.GREEN
+    EMPHASIZE = colors.PURPLE
+
+    # Give colored output on the CLI"
+    def warn(self, message):
+        print(self.WARN % message)
+
+    def error(self, message):
+        sys.stderr.write((self.ERROR + '\n') % message)
+
+    def confirm(self, message):
+        print(self.CONFIRM % message)
+
+    def emphasize(self, message):
+        print(self.EMPHASIZE % message)
+
+    def return_emphasize(self, message):
+        return self.EMPHASIZE % message
+    # End Colors!
+
+    def get_random_string(self, length):
+        """ Returns short random strings, less than 40 bytes in length.
+
+        :param length: Length of the random string to be returned
+        :type length: int
+        """
+        if length > 40:
+            raise Exception('Specify length less than 40')
+        return sha1(str(datetime.now()).encode('utf-8')).hexdigest()[:length]
+
+    def set_table_section_heading(self, table, heading):
+        table.append(['', ''])
+        table.append([heading, ''])
+        table.append(['=============', ''])
+
+    def write_csv(self, table, headers, filename):
+        if table == []:
+            return
+
+        if 'csv' not in filename:
+            filename += '.csv'
+
+        f = open(filename, 'wb')
+        writer = csv.writer(f, quoting=csv.QUOTE_ALL)
+        if headers:
+            writer.writerow(headers)
+        for row in table:
+            writer.writerow(row)
+        f.close()
+
+        return
+
+    def stem(self, arguments):
+        """ Allows the scope to be in singular or plural
+
+        :param arguments: The sys.argv, passed from mmclient
+        :type arguments: list
+        """
+        scope = arguments[2]
+        if scope[-1] == 's':
+            scope = scope[:-1]
+        arguments[2] = scope
+        return arguments
+
+    def get_listing(self, objects, fields):
+        """ Tabulates the set of objects by using the values of each of the
+            fileds. """
+        table = []
+        for obj in objects:
+            row = []
+            for field in fields:
+                try:
+                    value = getattr(obj, field)
+                except:
+                    value = 'None'
+
+                _type = type(value).__name__
+                if _type == '_Addresses':
+                    row.append(str(value[0]))
+                else:
+                    row.append(str(value))
+
+            table.append(row)
+        return table
+
+
+class Filter():
+    """ This class manages the filtering tasks for the show and delete commands
+        The class supports three filters, equality, regular expression search
+        and list search.
+    """
+
+    def get_results(self, *args):
+        op = args[2]
+        if op == '=':
+            return self.equality(*args)
+        elif op == 'like':
+            return self.like(*args)
+        elif op == 'in':
+            return self.in_list(*args)
+        else:
+            raise Exception('Invalid operator: %s ' % (op))
+
+    def equality(self, key, value, op, data_set):
+        copy_set = data_set[:]
+        for i in data_set:
+            try:
+                obj_value = getattr(i, key)
+                if obj_value != value:
+                    copy_set.remove(i)
+            except AttributeError:
+                raise Exception('Invalid filter : %s' % key)
+        return copy_set
+
+    def in_list(self, key, value, op, data_set):
+        copy_set = data_set[:]
+        flag = False
+        for i in data_set:
+            try:
+                the_list = getattr(i, key)
+            except KeyError:
+                copy_set.remove(i)
+                continue
+            except AttributeError:
+                raise Exception('Invalid filter : %s' % key)
+
+            if key == 'members':
+                for j in the_list:
+                    if self.match_pattern(j.email, value):
+                        flag = True
+                        break
+            elif key == 'lists':
+                for j in the_list:
+                    if (self.match_pattern(j.list_id, value)
+                       or self.match_pattern(j.fqdn_listname, value)):
+                        flag = True
+                        break
+            elif key == 'subscriptions':
+                value = value.replace('@', '.')
+                for j in the_list:
+                    if self.match_pattern(j.list_id, value):
+                        flag = True
+                        break
+            else:
+                for j in the_list:
+                    if self.match_pattern(j, value):
+                        flag = True
+                        break
+            if not flag:
+                copy_set.remove(i)
+            flag = False
+        return copy_set
+
+    def like(self, key, value, op, data_set):
+        copy_set = data_set[:]
+        for i in data_set:
+            obj_value = None
+            try:
+                obj_value = getattr(i, key)
+            except KeyError:
+                copy_set.remove(i)
+            except AttributeError:
+                raise Exception('Invalid filter : %s' % key)
+            if not self.match_pattern(obj_value, value):
+                copy_set.remove(i)
+        return copy_set
+
+    def match_pattern(self, string, value):
+        """ Regular expression matcher, returns the match object
+            or None
+        """
+        pattern = None
+        try:
+            pattern = re.compile(value.lower())
+        except:
+            raise Exception('Invalid pattern : %s' % value)
+        string = str(string).lower()
+        return pattern.match(string)

=== added file 'src/mailmanclient/cli/mmclient'
--- src/mailmanclient/cli/mmclient	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/mmclient	2015-03-17 19:08:34 +0000
@@ -0,0 +1,46 @@
+#!/usr/bin/python
+
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#  
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import sys
+from mailmanclient.cli.lib.utils import Utils
+from mailmanclient.cli.client.shell import Shell
+from mailmanclient.cli.client.cmdparser import CmdParser
+try:
+    # If the mmclient is invoked with arguments, trigger the command
+    # line tools, else trigger the commandline shell
+    sys.argv[1]
+    utils = Utils()
+    arguments = None
+    try:
+        arguments = utils.stem(sys.argv)
+    except IndexError:
+        pass
+    c = CmdParser(arguments)
+    c.run()
+except IndexError:
+    # No arguments supplied.Start the shell.
+    s = Shell()
+    s.initialize()
+    s.cmdloop()

=== added directory 'src/mailmanclient/cli/tests'
=== added file 'src/mailmanclient/cli/tests/__init__.py'
=== added file 'src/mailmanclient/cli/tests/test_domain.py'
--- src/mailmanclient/cli/tests/test_domain.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/tests/test_domain.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,223 @@
+#!/usr/bin/python
+
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import random
+import unittest
+from mock import patch
+from six.moves.urllib_error import HTTPError
+from io import StringIO
+from mailmanclient.cli.core.domains import Domains, DomainException
+from mailmanclient.cli.lib.mailman_utils import MailmanUtils
+
+
+class TestCreateDomain(unittest.TestCase):
+
+    domain_names = []
+    utils = MailmanUtils()
+
+    def setUp(self):
+        self.client = self.utils.connect()
+        self.domain = Domains(self.client)
+        self.test_domain = self.utils.get_new_domain_name()
+        self.domain_names.append(self.test_domain)
+        self.client.create_domain(self.test_domain)
+
+    def test_normal_create(self):
+        self.new_domain = self.utils.get_new_domain_name()
+        self.domain_names.append(self.new_domain)
+        args = {}
+        args['domain'] = self.new_domain
+        args['contact'] = '[e-mail]'
+        self.domain.create(args)
+
+    def test_create_existent_domain(self):
+        args = {}
+        args['domain'] = self.test_domain
+        args['contact'] = '[e-mail]'
+        self.assertRaises(DomainException, self.domain.create, args)
+
+    def test_no_postmaster(self):
+        self.new_domain = self.utils.get_new_domain_name()
+        self.domain_names.append(self.new_domain)
+        args = {}
+        args['domain'] = self.new_domain
+        args['contact'] = None
+        self.domain.create(args)
+
+    def tearDown(self):
+        for domain in self.domain_names:
+            try:
+                self.client.delete_domain(domain)
+            except Exception:
+                pass
+
+
+class TestShowDomain(unittest.TestCase):
+
+    domain_names = []
+    utils = MailmanUtils()
+
+    def setUp(self):
+        self.client = self.utils.connect()
+        self.domain = Domains(self.client)
+
+    @patch('sys.stdout', new_callable=StringIO)
+    def test_normal_show(self, output):
+        ndomains = len(self.client.domains)
+        args = {}
+        args['no_header'] = False
+        args['verbose'] = False
+        args['csv'] = None
+        args['domain'] = None
+        self.domain.show(args)
+        domain_list = output.getvalue().split('\n')
+        count = len(domain_list) - 1
+        self.assertEqual(ndomains, count)
+
+    @patch('sys.stdout', new_callable=StringIO)
+    def test_verbose_show(self, output):
+        args = {}
+        args['no_header'] = False
+        args['verbose'] = True
+        args['csv'] = None
+        args['domain'] = None
+        test_domain = random.randint(0, len(self.client.domains) - 1)
+        test_domain = self.client.domains[test_domain]
+        self.domain.show(args)
+        domain_list = output.getvalue().split('\n')
+        domain = ''
+        for domain in domain_list:
+            if test_domain.base_url in domain:
+                break
+        domain = domain.split()
+        cleaned_domain = []
+        for attribute in domain:
+            if attribute:
+                cleaned_domain.append(attribute)
+        self.assertEqual(cleaned_domain[0], test_domain.base_url)
+        self.assertEqual(cleaned_domain[1], test_domain.contact_address)
+        self.assertEqual(cleaned_domain[2], test_domain.mail_host)
+        self.assertEqual(cleaned_domain[3], test_domain.url_host)
+
+    @patch('sys.stdout', new_callable=StringIO)
+    def test_no_header(self, output):
+        args = {}
+        args['no_header'] = True
+        args['csv'] = None
+        args['verbose'] = True
+        args['domain'] = None
+        test_domain = random.randint(0, len(self.client.domains) - 1)
+        test_domain = self.client.domains[test_domain]
+        self.domain.show(args)
+        domain_list = output.getvalue().split('\n')
+        line_one = domain_list[0].split()
+        self.assertNotEqual(line_one[0], 'Base')
+        domain = ''
+        for domain in domain_list:
+            if test_domain.base_url in domain:
+                break
+        domain = domain.split()
+        cleaned_domain = []
+        for attribute in domain:
+            if attribute:
+                cleaned_domain.append(attribute)
+        self.assertEqual(cleaned_domain[0], test_domain.base_url)
+        self.assertEqual(cleaned_domain[1], test_domain.contact_address)
+        self.assertEqual(cleaned_domain[2], test_domain.mail_host)
+        self.assertEqual(cleaned_domain[3], test_domain.url_host)
+
+    def tearDown(self):
+        for domain in self.domain_names:
+            try:
+                self.client.delete_domain(domain)
+            except Exception:
+                pass
+
+
+class TestDeleteDomain(unittest.TestCase):
+
+    domain_names = []
+    utils = MailmanUtils()
+
+    def setUp(self):
+        self.client = self.utils.connect()
+        self.domain = Domains(self.client)
+
+    def test_normal_delete(self):
+        new_domain = self.utils.get_new_domain_name()
+        self.domain_names.append(new_domain)
+        self.client.create_domain(new_domain)
+        args = {}
+        args['domain'] = new_domain
+        with patch('builtins.input', return_value='y'):
+            args['yes'] = True
+            self.domain.delete(args)
+        self.assertRaises(HTTPError, self.client.get_domain, new_domain)
+
+    def test_delete_cancel(self):
+        new_domain = self.utils.get_new_domain_name()
+        self.domain_names.append(new_domain)
+        self.client.create_domain(new_domain)
+        args = {}
+        args['domain'] = new_domain
+        with patch('builtins.input', return_value='n'):
+            args['yes'] = False
+            self.domain.delete(args)
+        self.assertRaises(HTTPError, self.client.create_domain, new_domain)
+
+    def test_delete_invalid_confirm(self):
+        new_domain = self.utils.get_new_domain_name()
+        self.domain_names.append(new_domain)
+        self.client.create_domain(new_domain)
+        args = {}
+        args['domain'] = new_domain
+        args['yes'] = False
+        with patch('builtins.input', return_value='no'):
+            self.assertRaises(Exception, self.domain.delete, args)
+
+    def test_delete_without_confirm(self):
+        new_domain = self.utils.get_new_domain_name()
+        self.domain_names.append(new_domain)
+        self.client.create_domain(new_domain)
+        args = {}
+        args['domain'] = new_domain
+        args['yes'] = True
+        self.domain.delete(args)
+        self.assertRaises(HTTPError, self.client.get_domain, new_domain)
+
+    def test_delete_invalid_domain(self):
+        new_domain = self.utils.get_new_domain_name()
+        self.domain_names.append(new_domain)
+        args = {}
+        args['domain'] = new_domain
+        args['yes'] = True
+        self.assertRaises(DomainException, self.domain.delete, args)
+
+    def tearDown(self):
+        for domain in self.domain_names:
+            try:
+                self.client.delete_domain(domain)
+            except Exception:
+                pass

=== added file 'src/mailmanclient/cli/tests/test_list.py'
--- src/mailmanclient/cli/tests/test_list.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/tests/test_list.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,285 @@
+#!/usr/bin/python
+
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import unittest
+from mock import patch
+from six.moves.urllib_error import HTTPError
+from io import StringIO
+from mailmanclient.cli.core.lists import Lists, ListException
+from mailmanclient.cli.core.domains import DomainException
+from mailmanclient.cli.lib.mailman_utils import MailmanUtils
+
+
+class TestCreateList(unittest.TestCase):
+
+    domain_names = []
+    utils = MailmanUtils()
+
+    def setUp(self):
+        self.client = self.utils.connect()
+        self._list = Lists(self.client)
+        self.test_domain = self.utils.get_new_domain_name()
+        self.domain_names.append(self.test_domain)
+        self.client.create_domain(self.test_domain)
+
+        # Raise exception if domain create falied.
+        self.domain = self.client.get_domain(self.test_domain)
+
+    def test_normal_create(self):
+        args = {}
+        list_name = self.utils.get_random_string(5)
+        list_name += '@' + self.test_domain
+        args['list'] = list_name
+        self._list.create(args)
+
+    def test_create_existent_list(self):
+        list_name = self.utils.get_random_string(5)
+        self.domain.create_list(list_name)
+        args = {}
+        list_name += '@' + self.test_domain
+        args['list'] = list_name
+        self.assertRaises(ListException, self._list.create, args)
+
+    def test_invalid_fqdn_create(self):
+        test_list = self.utils.get_random_string(5)
+        invalid_name_1 = test_list + '@'
+        invalid_name_2 = '@' + self.test_domain
+        invalid_name_3 = (test_list + '@' +
+                          self.utils.get_new_domain_name())
+        invalid_name_4 = self.test_domain
+        args = {}
+        args['list'] = invalid_name_1
+        self.assertRaises(ListException, self._list.create, args)
+        args['list'] = invalid_name_2
+        self.assertRaises(ListException, self._list.create, args)
+        args['list'] = invalid_name_3
+        self.assertRaises(DomainException, self._list.create, args)
+        args['list'] = invalid_name_4
+        self.assertRaises(ListException, self._list.create, args)
+
+    def tearDown(self):
+        for domain in self.domain_names:
+            try:
+                self.client.delete_domain(domain)
+            except Exception:
+                pass
+
+
+class TestShowList(unittest.TestCase):
+
+    domain_names = []
+    utils = MailmanUtils()
+
+    def setUp(self):
+        self.client = self.utils.connect()
+        self._list = Lists(self.client)
+        self.test_domain = self.utils.get_new_domain_name()
+        self.test_list = self.utils.get_random_string(5)
+        self.domain_names.append(self.test_domain)
+        self.client.create_domain(self.test_domain)
+
+        # Raise exception if domain create falied.
+        self.domain = self.client.get_domain(self.test_domain)
+        self.domain.create_list(self.test_list)
+
+    @patch('sys.stdout', new_callable=StringIO)
+    def test_normal_show(self, output):
+        nlists = len(self.client.lists)
+        args = {}
+        args['no_header'] = False
+        args['csv'] = None
+        args['verbose'] = False
+        args['domain'] = None
+        args['list'] = None
+        self._list.show(args)
+        mlist_list = output.getvalue().split('\n')
+        count = len(mlist_list) - 1
+        self.assertEqual(nlists, count)
+
+    @patch('sys.stdout', new_callable=StringIO)
+    def test_filter_show(self, output):
+        nlists = len(self.domain.lists)
+        args = {}
+        args['no_header'] = False
+        args['csv'] = None
+        args['verbose'] = False
+        args['domain'] = self.test_domain
+        args['list'] = None
+        self._list.show(args)
+        mlist_list = output.getvalue().split('\n')
+        count = len(mlist_list) - 1
+        self.assertEqual(nlists, count)
+
+    @patch('sys.stdout', new_callable=StringIO)
+    def test_verbose_show(self, output):
+        args = {}
+        args['no_header'] = False
+        args['csv'] = None
+        args['verbose'] = True
+        args['domain'] = None
+        args['list'] = None
+        self._list.show(args)
+        mlists = output.getvalue().split('\n')
+        test_list = '%s@%s' % (self.test_list, self.test_domain)
+        mlist = ''
+        for mlist in mlists:
+            if test_list in mlist:
+                break
+        mlist = mlist.split()
+        cleaned_list = []
+        for attribute in mlist:
+            if attribute:
+                cleaned_list.append(attribute)
+        mlist = self.client.get_list(test_list)
+        self.assertEqual(cleaned_list[0], mlist.list_id)
+        self.assertEqual(cleaned_list[1], mlist.list_name)
+        self.assertEqual(cleaned_list[2], mlist.mail_host)
+        self.assertEqual(cleaned_list[3], mlist.display_name)
+        self.assertEqual(cleaned_list[4], mlist.fqdn_listname)
+
+    @patch('sys.stdout', new_callable=StringIO)
+    def test_filter_verbose_show(self, output):
+        args = {}
+        args['no_header'] = False
+        args['csv'] = None
+        args['verbose'] = True
+        args['domain'] = self.test_domain
+        args['list'] = None
+        self._list.show(args)
+        mlists = output.getvalue().split('\n')
+        mlist = ''
+        test_list = '%s@%s' % (self.test_list, self.test_domain)
+        for mlist in mlists:
+            if test_list in mlist:
+                break
+        mlist = mlist.split()
+        cleaned_list = []
+        for attribute in mlist:
+            if attribute:
+                cleaned_list.append(attribute)
+        mlist = self.client.get_list(test_list)
+        self.assertEqual(cleaned_list[0], mlist.list_id)
+        self.assertEqual(cleaned_list[1], mlist.list_name)
+        self.assertEqual(cleaned_list[2], mlist.mail_host)
+        self.assertEqual(cleaned_list[3], mlist.display_name)
+        self.assertEqual(cleaned_list[4], mlist.fqdn_listname)
+
+    @patch('sys.stdout', new_callable=StringIO)
+    def test_no_header(self, output):
+        args = {}
+        args['no_header'] = False
+        args['csv'] = None
+        args['verbose'] = True
+        args['domain'] = None
+        args['list'] = None
+        self._list.show(args)
+        mlists = output.getvalue().split('\n')
+        line_one = mlists[0].split()
+        self.assertNotEqual(line_one[0], 'Base')
+        mlist = ''
+        for mlist in mlists:
+            if self.test_list in mlist:
+                break
+        mlist = mlist.split()
+        cleaned_list = []
+        for attribute in mlist:
+            if attribute:
+                cleaned_list.append(attribute)
+        mlist = self.client.get_list('%s@%s' % (self.test_list,
+                                                self.test_domain))
+        self.assertEqual(cleaned_list[0], mlist.list_id)
+        self.assertEqual(cleaned_list[1], mlist.list_name)
+        self.assertEqual(cleaned_list[2], mlist.mail_host)
+        self.assertEqual(cleaned_list[3], mlist.display_name)
+        self.assertEqual(cleaned_list[4], mlist.fqdn_listname)
+
+    def tearDown(self):
+        for domain in self.domain_names:
+            try:
+                self.client.delete_domain(domain)
+            except Exception:
+                pass
+
+
+class TestDeleteList(unittest.TestCase):
+
+    domain_names = []
+    utils = MailmanUtils()
+
+    def setUp(self):
+        self.client = self.utils.connect()
+        self._list = Lists(self.client)
+        self.test_domain = self.utils.get_new_domain_name()
+        self.test_list = self.utils.get_random_string(5)
+        self.domain_names.append(self.test_domain)
+        self.client.create_domain(self.test_domain)
+
+        # Raise exception if domain create falied.
+        self.domain = self.client.get_domain(self.test_domain)
+        self.domain.create_list(self.test_list)
+
+    def test_normal_delete(self):
+        new_list = self.utils.get_random_string(5)
+        self.domain.create_list(new_list)
+        args = {}
+        args['list'] = '%s@%s' % (new_list, self.test_domain)
+        with patch('builtins.input', return_value='y'):
+            args['yes'] = True
+            self._list.delete(args)
+        self.assertRaises(HTTPError, self.client.get_list, args['list'])
+
+    def test_delete_cancel(self):
+        new_list = self.utils.get_random_string(5)
+        self.domain.create_list(new_list)
+        args = {}
+        args['list'] = '%s@%s' % (new_list, self.test_domain)
+        with patch('builtins.input', return_value='n'):
+            args['yes'] = False
+            self._list.delete(args)
+        self.assertRaises(HTTPError, self.domain.create_list, args['list'])
+
+    def test_delete_invalid_confirm(self):
+        new_list = self.utils.get_random_string(5)
+        self.domain.create_list(new_list)
+        args = {}
+        args['list'] = '%s@%s' % (new_list, self.test_domain)
+        with patch('builtins.input', return_value='no'):
+            self.assertRaises(Exception, self._list.delete, args)
+
+    def test_delete_without_confirm(self):
+        new_list = self.utils.get_random_string(5)
+        self.domain.create_list(new_list)
+        args = {}
+        args['list'] = '%s@%s' % (new_list, self.test_domain)
+        args['yes'] = True
+        self._list.delete(args)
+        self.assertRaises(HTTPError, self.client.get_list, args['list'])
+
+    def tearDown(self):
+        for domain in self.domain_names:
+            try:
+                self.client.delete_domain(domain)
+            except Exception:
+                pass

=== added file 'src/mailmanclient/cli/tests/test_preference.py'
--- src/mailmanclient/cli/tests/test_preference.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/tests/test_preference.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,99 @@
+#!/usr/bin/python
+
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import unittest
+from mailmanclient.cli.core.preferences import Preferences
+from mailmanclient.cli.lib.mailman_utils import MailmanUtils
+
+
+utils = MailmanUtils()
+
+
+class TestUpdate(unittest.TestCase):
+
+    new_objects = []
+
+    test_user = None
+    test_domain = None
+    test_list = None
+    test_address = None
+    test_member = None
+
+    def setUp(self):
+        self.client = utils.connect()
+        self.preferences = Preferences(self.client)
+        self.test_user = 'a@' + utils.get_random_string(5) + '.com'
+        self.test_user = self.client.create_user(self.test_user,
+                                                 display_name='a',
+                                                 password='a')
+        self.new_objects.append(self.test_user)
+
+        self.test_domain = self.client.create_domain(utils.get_random_string(5)
+                                                     + '.org')
+        self.new_objects.append(self.test_domain)
+        self.test_list = self.test_domain.create_list(utils.get_random_string(5))
+        self.new_objects.append(self.test_list)
+
+        self.test_member = self.test_list.subscribe(self.test_user.addresses[0])
+
+        self.test_address = self.test_user.addresses[0]
+
+    def test_user(self):
+        args = {}
+        args['update_scope'] = 'user'
+        args['email'] = self.test_user.addresses[0]
+        args['key'] = 'receive_list_copy'
+        args['value'] = 'False'
+        self.preferences.update(args)
+        self.assertFalse(self.test_user.preferences['receive_list_copy'])
+
+    def test_address(self):
+        args = {}
+        args['update_scope'] = 'address'
+        args['email'] = self.test_address
+        args['key'] = 'receive_list_copy'
+        args['value'] = 'False'
+        self.preferences.update(args)
+        self.assertFalse(self.test_address.preferences['receive_list_copy'])
+
+    def test_member(self):
+        args = {}
+        args['update_scope'] = 'member'
+        args['email'] = self.test_member.email
+        args['list'] = self.test_list.fqdn_listname
+        args['key'] = 'receive_list_copy'
+        args['value'] = 'False'
+        self.preferences.update(args)
+        self.assertFalse(self.test_member.preferences['receive_list_copy'])
+
+    def tearDown(self):
+        for obj in self.new_objects:
+            try:
+                if type(obj).__name__ == '_Domain':
+                    self.client.delete_domain(obj.base_url)
+                else:
+                    obj.delete()
+            except:
+                pass

=== added file 'src/mailmanclient/cli/tests/test_user.py'
--- src/mailmanclient/cli/tests/test_user.py	1970-01-01 00:00:00 +0000
+++ src/mailmanclient/cli/tests/test_user.py	2015-03-17 19:08:34 +0000
@@ -0,0 +1,127 @@
+#!/usr/bin/python
+
+# Copyright (C) 2010-2014 by the Free Software Foundation, Inc.
+#
+# This file is part of mailman.client.
+#
+# mailman.client is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by the
+# Free Software Foundation, version 3 of the License.
+#
+# mailman.client 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 Lesser General Public
+# License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with mailman.client.  If not, see <http://www.gnu.org/licenses/>.
+#
+# This file is part of the Mailman CLI Project, Google Summer Of Code, 2014
+#
+# Author    :   Rajeev S <[e-mail]>
+# Mentors   :   Stephen J. Turnbull <[e-mail]>
+#               Abhilash Raj <[e-mail]>
+#               Barry Warsaw <[e-mail]>
+
+import unittest
+from mailmanclient.cli.core.users import Users, UserException
+from mailmanclient.cli.lib.mailman_utils import MailmanUtils
+
+
+class TestCreateUser(unittest.TestCase):
+
+    utils = MailmanUtils()
+    new_users = []
+
+    def setUp(self):
+        self.client = self.utils.connect()
+        self.users = Users(self.client)
+        self.test_user = 'a@' + self.utils.get_random_string(5) + '.org'
+        self.new_users.append(self.test_user)
+        self.client.create_user(email=self.test_user,
+                                password='abcdefgh',
+                                display_name='abc')
+        self.test_list = self.client.lists[0]
+        self.test_list.subscribe(self.test_user)
+
+        # Test if user created else setup fails.
+        self.client.get_user(self.test_user)
+
+    def test_normal_create(self):
+        args = {}
+        new_user = 'a@' + self.utils.get_random_string(5) + '.org'
+        self.new_users.append(new_user)
+        args['email'] = new_user
+        args['password'] = 'abc'
+        args['name'] = 'abc'
+        self.users.create(args)
+        self.assertRaises(UserException, self.users.create, args)
+
+    def test_create_existent_user(self):
+        args = {}
+        args['email'] = self.test_user
+        args['password'] = 'abc'
+        args['name'] = 'abc'
+        self.assertRaises(UserException, self.users.create, args)
+
+    def tearDown(self):
+        for user in self.new_users:
+            try:
+                u = self.client.get_user(user)
+                u.delete()
+            except Exception as e:
+                print(e)
+
+
+class TestSubscription(unittest.TestCase):
+
+    utils = MailmanUtils()
+    new_users = []
+    domain_list = []
+
+    def setUp(self):
+        self.client = self.utils.connect()
+        self.users = Users(self.client)
+
+        self.test_domain = self.utils.get_new_domain_name()
+        self.domain_list.append(self.test_domain)
+        self.client.create_domain(self.test_domain)
+
+        self.test_user = self.utils.get_random_string(8) + '@domain.org'
+        self.new_users.append(self.test_user)
+        self.client.create_user(email=self.test_user,
+                                password='abcdefgh',
+                                display_name='abc')
+        self.client.get_user(self.test_user)
+        domain = self.client.get_domain(self.test_domain)
+        self.test_list = (self.utils.get_random_string(8) +
+                          '@' + self.test_domain)
+        domain.create_list(self.test_list.split('@')[0])
+
+        # Test if user created else setup fails.
+        self.client.get_user(self.test_user)
+
+    def test_subscribe_to_list(self):
+        print(self.test_user)
+        _list = self.client.get_list(self.test_list)
+        nmembers = len(_list.members)
+        args = {}
+        args['users'] = ['[e-mail]', '[e-mail]', '[e-mail]']
+        self.new_users.extend(args['users'])
+        args['list_name'] = self.test_list
+        args['quiet'] = False
+        self.users.subscribe(args)
+        self.assertEqual(nmembers + 3, len(_list.members))
+
+    def tearDown(self):
+        for i in self.new_users:
+            try:
+                user = self.client.get_user(i)
+                user.delete()
+            except Exception:
+                pass
+        for i in self.domain_list:
+            try:
+                self.client.delete_domain(i)
+            except Exception:
+                pass