Description module rst2text

module.py

@@ -5,6 +5,12 @@ from trytond.model import fields
 from trytond.pool import Pool, PoolMeta
 from trytond.modules import get_module_info
 import os
+import re
+try:
+    import docutils.core
+    has_docutils = True
+except ImportError:
+    has_docutils = False
 
 __all__ = ['Module']
 __metaclass__ = PoolMeta
@@ -17,7 +23,56 @@ class Module:
     @staticmethod
     def read_rst(doc_path):
         f = open(doc_path, "r")
-        return f.read()
+        description = f.read()
+
+        def rst2html(source, source_path=None, source_class=docutils.io.StringInput,
+                     destination_path=None, reader=None, reader_name='standalone',
+                     parser=None, parser_name='restructuredtext', writer=None,
+                     writer_name='html', settings=None, settings_spec=None,
+                     settings_overrides=None, config_section=None,
+                     enable_exit_status=None):
+            """
+            Set up & run a `Publisher`, and return a dictionary of document parts.
+            Dictionary keys are the names of parts, and values are Unicode strings;
+            encoding is up to the client. For programmatic use with string I/O.
+
+            For encoded string input, be sure to set the 'input_encoding' setting to
+            the desired encoding. Set it to 'unicode' for unencoded Unicode string
+            input. Here's how::
+
+            publish_parts(..., settings_overrides={'input_encoding': 'unicode'})
+
+            Parameters: see `publish_programmatically`.
+            """
+            output, pub = docutils.core.publish_programmatically(
+                source=source, source_path=source_path, source_class=source_class,
+                destination_class=docutils.io.StringOutput,
+                destination=None, destination_path=destination_path,
+                reader=reader, reader_name=reader_name,
+                parser=parser, parser_name=parser_name,
+                writer=writer, writer_name=writer_name,
+                settings=settings, settings_spec=settings_spec,
+                settings_overrides=settings_overrides,
+                config_section=config_section,
+                enable_exit_status=enable_exit_status)
+            return pub.writer.parts['fragment'], pub.document.reporter.max_level, pub.settings.record_dependencies
+
+        def remove_tags(text):
+            TAG_RE = re.compile(r'<[^>]+>')
+            return TAG_RE.sub('', text)
+
+        if has_docutils:
+            output, error_level, deps = rst2html(
+                    description, settings_overrides={
+                        'initial_header_level': 2,
+                        'record_dependencies': True,
+                        'stylesheet_path': None,
+                        'link_stylesheet': True,
+                        'syntax_highlight': 'short',
+                    })
+            return remove_tags(output)
+        else:
+            return description
 
     def get_description(self, name):
         Config = Pool().get('ir.configuration')