add stevedore

pythonmao · pythonmao · commit 0a6c176674dc · 2016-12-24T18:43:26.000+08:00
diff --git a/test_stevedore/example/example/__init__.py b/test_stevedore/example/example/__init__.py
diff --git a/test_stevedore/example/example/example.py b/test_stevedore/example/example/example.py
@@ -0,0 +1,36 @@
+import textwrap
+
+from example1 import base
+
+
+class FieldList(base.FormatterBase):
+    """Format values as a reStructuredText field list.
+
+    For example::
+
+      : name1 : value
+      : name2 : value
+      : name3 : a long value
+          will be wrapped with
+          a hanging indent
+    """
+
+    def format(self, data):
+        """Format the data and return unicode text.
+
+        :param data: A dictionary with string keys and simple types as
+                     values.
+        :type data: dict(str:?)
+        """
+        for name, value in sorted(data.items()):
+            full_text = ': {name} : {value}'.format(
+                name=name,
+                value=value,
+            )
+            wrapped_text = textwrap.fill(
+                full_text,
+                initial_indent='',
+                subsequent_indent='    ',
+                width=self.max_width,
+            )
+            yield wrapped_text + '\n'
diff --git a/test_stevedore/example/setup.py b/test_stevedore/example/setup.py
@@ -0,0 +1,40 @@
+# stevedore/example2/setup.py
+from setuptools import setup, find_packages
+
+setup(
+    name='stevedore-example',
+    version='1.0',
+
+    description='Demonstration package for stevedore',
+
+    url='http://git.openstack.org/cgit/openstack/stevedore',
+
+    classifiers=['Development Status :: 3 - Alpha',
+                 'License :: OSI Approved :: Apache Software License',
+                 'Programming Language :: Python',
+                 'Programming Language :: Python :: 2',
+                 'Programming Language :: Python :: 2.7',
+                 'Programming Language :: Python :: 3',
+                 'Programming Language :: Python :: 3.4',
+                 'Intended Audience :: Developers',
+                 'Environment :: Console',
+                 ],
+
+    platforms=['Any'],
+
+    scripts=[],
+
+    provides=['example',
+              ],
+
+    packages=find_packages(),
+    include_package_data=True,
+
+    entry_points={
+        'test_stevedore.study': [
+            'field =example.example:FieldList',
+        ],
+    },
+
+    zip_safe=False,
+)
diff --git a/test_stevedore/example1/example1/__init__.py b/test_stevedore/example1/example1/__init__.py
diff --git a/test_stevedore/example1/example1/base.py b/test_stevedore/example1/example1/base.py
@@ -0,0 +1,15 @@
+import abc
+import six
+
+
+@six.add_metaclass(abc.ABCMeta)
+class FormatterBase(object):
+    """Base class for example plugin used in the tutorial.
+    """
+
+    def __init__(self, max_width=60):
+        self.max_width = max_width
+
+    @abc.abstractmethod
+    def format(self, data):
+        pass
diff --git a/test_stevedore/example1/example1/driver.py b/test_stevedore/example1/example1/driver.py
@@ -0,0 +1,38 @@
+# stevedore/example/load_as_driver.py
+from __future__ import print_function
+
+import argparse
+
+from stevedore import driver
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser()
+    parser.add_argument(
+        'format',
+        nargs='?',
+        default='simple',
+        help='the output format',
+    )
+    parser.add_argument(
+        '--width',
+        default=60,
+        type=int,
+        help='maximum output width for text',
+    )
+    parsed_args = parser.parse_args()
+
+    data = {
+        'a': 'A',
+        'b': 'B',
+        'long': 'word ' * 80,
+    }
+
+    mgr = driver.DriverManager(
+        namespace='test_stevedore.study',
+        name=parsed_args.format,
+        invoke_on_load=True,
+        invoke_args=(parsed_args.width,),
+    )
+    for chunk in mgr.driver.format(data):
+        print(chunk, end='')
diff --git a/test_stevedore/example1/example1/simple.py b/test_stevedore/example1/example1/simple.py
@@ -0,0 +1,20 @@
+from example1 import base
+
+
+class Simple(base.FormatterBase):
+    """A very basic formatter.
+    """
+
+    def format(self, data):
+        """Format the data and return unicode text.
+
+        :param data: A dictionary with string keys and simple types as
+                     values.
+        :type data: dict(str:?)
+        """
+        for name, value in sorted(data.items()):
+            line = '{name} = {value}\n'.format(
+                name=name,
+                value=value,
+            )
+            yield line
diff --git a/test_stevedore/example1/setup.py b/test_stevedore/example1/setup.py
@@ -0,0 +1,40 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='stevedore-example1',
+    version='1.0',
+
+    description='Demonstration package for stevedore',
+
+    url='http://git.openstack.org/cgit/openstack/stevedore',
+
+    classifiers=['Development Status :: 3 - Alpha',
+                 'License :: OSI Approved :: Apache Software License',
+                 'Programming Language :: Python',
+                 'Programming Language :: Python :: 2',
+                 'Programming Language :: Python :: 2.7',
+                 'Programming Language :: Python :: 3',
+                 'Programming Language :: Python :: 3.4',
+                 'Intended Audience :: Developers',
+                 'Environment :: Console',
+                 ],
+
+    platforms=['Any'],
+
+    scripts=[],
+
+    provides=['test_stevedore.example1',
+              ],
+
+    packages=find_packages(),
+    include_package_data=True,
+
+    entry_points={
+        'test_stevedore.study': [
+            'simple = example1.simple:Simple',
+            'plain = example1.simple:Simple',
+        ],
+    },
+
+    zip_safe=False,
+)
