Bug 751795 - Part 2: Add settings module; r=jhammel

python/mach/mach/main.py

@@ -19,10 +19,11 @@ from mozbuild.logger import LoggingManager
 # Import sub-command modules
 # TODO Bug 794509 do this via auto-discovery. Update README once this is
 # done.
-# TODO import modules
+from mach.settings import Settings
 
 # Classes inheriting from ArgumentProvider that provide commands.
 HANDLERS = [
+    Settings,
 ]
 
 # Classes inheriting from ConfigProvider that provide settings.

python/mach/mach/settings.py

@@ -0,0 +1,51 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this file,
+# You can obtain one at http://mozilla.org/MPL/2.0/.
+
+from __future__ import print_function, unicode_literals
+
+from textwrap import TextWrapper
+
+from mozbuild.base import MozbuildObject
+from mach.base import ArgumentProvider
+
+class Settings(MozbuildObject, ArgumentProvider):
+    """Interact with settings for mach.
+
+    Currently, we only provide functionality to view what settings are
+    available. In the future, this module will be used to modify settings, help
+    people create configs via a wizard, etc.
+    """
+    def list_settings(self):
+        """List available settings in a concise list."""
+        for section in sorted(self.settings):
+            for option in sorted(self.settings[section]):
+                short, full = self.settings.option_help(section, option)
+                print('%s.%s -- %s' % (section, option, short))
+
+    def create(self):
+        """Create an empty settings file with full documentation."""
+        wrapper = TextWrapper(initial_indent='# ', subsequent_indent='# ')
+
+        for section in sorted(self.settings):
+            print('[%s]' % section)
+            print('')
+
+            for option in sorted(self.settings[section]):
+                short, full = self.settings.option_help(section, option)
+
+                print(wrapper.fill(full))
+                print(';%s =' % option)
+                print('')
+
+    @staticmethod
+    def populate_argparse(parser):
+        lst = parser.add_parser('settings-list',
+            help='Show available config settings.')
+
+        lst.set_defaults(cls=Settings, method='list_settings')
+
+        create = parser.add_parser('settings-create',
+            help='Print a new settings file with usage info.')
+
+        create.set_defaults(cls=Settings, method='create')