--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/INSTALL.py	Sat Mar 24 11:37:59 2012 -0700
@@ -0,0 +1,67 @@
+#!/usr/bin/env python
+
+"""
+installation script for configuration
+multi-level unified configuration
+"""
+
+import os
+import sys
+import urllib2
+import subprocess
+try:
+    from subprocess import check_call as call
+except:
+    from subprocess import call
+
+REPO='http://k0s.org/mozilla/hg/configuration'
+DEST='configuration' # name of the virtualenv
+VIRTUALENV='https://raw.github.com/pypa/virtualenv/develop/virtualenv.py'
+
+def which(binary, path=os.environ['PATH']):
+    dirs = path.split(os.pathsep)
+    for dir in dirs:
+        if os.path.isfile(os.path.join(dir, fileName)):
+            return os.path.join(dir, fileName)
+        if os.path.isfile(os.path.join(dir, fileName + ".exe")):
+            return os.path.join(dir, fileName + ".exe")
+
+def main(args=sys.argv[1:]):
+
+    # create a virtualenv
+    virtualenv = which('virtualenv') or which('virtualenv.py')
+    if virtualenv:
+        call([virtualenv, DEST])
+    else:
+        process = subproces.Popen([sys.executable, '-', DEST], stdin=subprocess.PIPE)
+        process.communicate(stdin=urllib2.urlopen(VIRTUALENV).read())
+
+    # create a src directory
+    src = os.path.join(DEST, 'src')
+    os.mkdir(src)
+
+    # clone the repository
+    call(['hg', 'clone', REPO], cwd=src)
+
+    # find the virtualenv python
+    python = None
+    for path in (('bin', 'python'), ('Scripts', 'python.exe')):
+        _python = os.path.join(DEST, *path)
+        if os.path.exists(_python)
+            python = _python
+            break
+    else:
+        raise Exception("Python binary not found in %s" % DEST)
+
+    # find the clone
+    filename = REPO.rstrip('/')
+    filename = filename.split('/')[-1]
+    clone = os.path.join(src, filename)
+    assert os.path.exists(clone), "Clone directory not found in %s" % src
+
+    # ensure setup.py exists
+    assert os.path.exists(os.path.join(clone, 'setup.py')), 'setup.py not found in %s' % clone
+
+    # install the package in develop mode
+    call([python 'setup.py', 'develop'], cwd=clone)
+

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README.txt	Sat Mar 24 11:37:59 2012 -0700
@@ -0,0 +1,11 @@
+configuration
+===========
+
+multi-level unified configuration
+
+----
+
+Jeff Hammel
+
+http://k0s.org/mozilla/hg/configuration
+

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/configuration/__init__.py	Sat Mar 24 11:37:59 2012 -0700
@@ -0,0 +1,2 @@
+#
+from config import *

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/configuration/config.py	Sat Mar 24 11:37:59 2012 -0700
@@ -0,0 +1,26 @@
+#!/usr/bin/env python
+
+"""
+multi-level unified configuration
+"""
+
+import sys
+import optparse
+
+def main(args=sys.argv[:]):
+
+    # parse command line options
+    usage = '%prog [options]'
+    class PlainDescriptionFormatter(optparse.IndentedHelpFormatter):
+        """description formatter for console script entry point"""
+        def format_description(self, description):
+            if description:
+                return description.strip() + '\n'
+            else:
+                return ''
+    parser = optparse.OptionParser(usage=usage, description=__doc__, formatter=PlainDescriptionFormatter())
+    options, args = parser.parse_args(args)
+
+if __name__ == '__main__':
+  main()
+

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/configuration/template.py	Sat Mar 24 11:37:59 2012 -0700
@@ -0,0 +1,32 @@
+#!/usr/bin/env python
+
+"""
+configuration template for makeitso
+"""
+
+import sys
+from cli import MakeItSoCLI
+from optparse import OptionParser
+from template import MakeItSoTemplate
+
+class configurationTemplate(MakeItSoTemplate):
+  """
+  configuration template
+  """
+  name = 'configuration'
+  templates = ['template']
+  look = True
+
+class TemplateCLI(MakeItSoCLI):
+  """
+  CLI driver for the configuration template
+  """
+
+def main(args=sys.argv[:]):
+  cli = TemplateCLI()
+  cli(*args)
+  
+if __name__ == '__main__':
+  main()  
+
+

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/setup.py	Sat Mar 24 11:37:59 2012 -0700
@@ -0,0 +1,49 @@
+"""
+setup packaging script for configuration
+"""
+
+import os
+
+version = "0.0"
+dependencies = ['MakeItSo', 'PyYAML']
+
+try:
+    import json
+except ImportError:
+    dependencies.append('simplejson')
+
+# allow use of setuptools/distribute or distutils
+kw = {}
+try:
+    from setuptools import setup
+    kw['entry_points'] = """
+      [console_scripts]
+      configuration-template = configuration.template:main
+"""
+    kw['install_requires'] = dependencies
+except ImportError:
+    from distutils.core import setup
+    kw['requires'] = dependencies
+
+try:
+    here = os.path.dirname(os.path.abspath(__file__))
+    description = file(os.path.join(here, 'README.txt')).read()
+except IOError:
+    description = ''
+
+
+setup(name='configuration',
+      version=version,
+      description="multi-level unified configuration",
+      long_description=description,
+      classifiers=[], # Get strings from http://www.python.org/pypi?%3Aaction=list_classifiers
+      author='Jeff Hammel',
+      author_email='jhammel@mozilla.com',
+      url='http://k0s.org/mozilla/hg/configuration',
+      license='MPL',
+      packages=['configuration'],
+      include_package_data=True,
+      zip_safe=False,
+      **kw
+      )
+

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/tests/doctest.txt	Sat Mar 24 11:37:59 2012 -0700
@@ -0,0 +1,11 @@
+Test configuration
+================
+
+The obligatory imports:
+
+    >>> import configuration
+
+Run some tests.  This test will fail, please fix it:
+
+    >>> assert True == False
+

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/tests/example.py	Sat Mar 24 11:37:59 2012 -0700
@@ -0,0 +1,4 @@
+from configuration import Configuration
+
+class ExampleConfiguration(Configuration):
+    """example configuration instance"""

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/tests/test.py	Sat Mar 24 11:37:59 2012 -0700
@@ -0,0 +1,61 @@
+#!/usr/bin/env python
+
+"""
+doctest runner
+"""
+
+import doctest
+import os
+import sys
+from optparse import OptionParser
+
+
+def run_tests(raise_on_error=False, report_first=False):
+
+    # add results here
+    results = {}
+
+    # doctest arguments
+    directory = os.path.dirname(os.path.abspath(__file__))
+    extraglobs = {'here': directory}
+    doctest_args = dict(extraglobs=extraglobs, raise_on_error=raise_on_error)
+    doctest_args['optionsflags'] = doctest.ELLIPSIS
+    if report_first:
+        doctest_args['optionflags'] |= doctest.REPORT_ONLY_FIRST_FAILURE
+
+    # gather tests
+    tests =  [test for test in os.listdir(directory)
+              if test.endswith('.txt')]
+
+    # run the tests
+    for test in tests:
+        try:
+            results[test] = doctest.testfile(test, **doctest_args)
+        except doctest.DocTestFailure, failure:
+            raise
+        except doctest.UnexpectedException, failure:
+            raise failure.exc_info[0], failure.exc_info[1], failure.exc_info[2]
+
+    return results
+
+def main(args=sys.argv[1:]):
+
+    # parse command line args
+    parser = OptionParser(description=__doc__)
+    parser.add_option('--raise', dest='raise_on_error',
+                      default=False, action='store_true',
+                      help="raise on first error")
+    parser.add_option('--report-first', dest='report_first',
+                      default=False, action='store_true',
+                      help="report the first error only (all tests will still run)")
+    options, args = parser.parse_args(args)
+
+    # run the tests
+    results = run_tests(**options.__dict__)
+    if sum([i.failed for i in results.values()]):
+        sys.exit(1) # error
+                
+
+if __name__ == '__main__':
+    main()
+

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/tests/unit.py	Sat Mar 24 11:37:59 2012 -0700
@@ -0,0 +1,21 @@
+#!/usr/bin/env python
+
+"""
+unit tests
+"""
+
+import os
+import sys
+import unittest
+
+# globals
+here = os.path.dirname(os.path.abspath(__file__))
+
+class configurationUnitTest(unittest.TestCase):
+
+    def test_configuration(self):
+        pass
+
+if __name__ == '__main__':
+    unittest.main()
+