adding the breathe files

doc/breathe/parser/__init__.py

@@ -0,0 +1,118 @@
+
+import breathe.parser.doxygen.index
+import breathe.parser.doxygen.compound
+
+class ParserError(Exception):
+
+    def __init__(self, error, filename):
+        Exception.__init__(self, error)
+
+        self.error = error
+        self.filename = filename
+
+class FileIOError(Exception):
+
+    def __init__(self, error, filename):
+        Exception.__init__(self, error)
+
+        self.error = error
+        self.filename = filename
+
+class Parser(object):
+
+    def __init__(self, cache, path_handler, file_state_cache):
+
+        self.cache = cache
+        self.path_handler = path_handler
+        self.file_state_cache = file_state_cache
+
+class DoxygenIndexParser(Parser):
+
+    def __init__(self, cache, path_handler, file_state_cache):
+        Parser.__init__(self, cache, path_handler, file_state_cache)
+
+    def parse(self, project_info):
+
+        filename = self.path_handler.resolve_path(
+                project_info.project_path(),
+                "index.xml"
+                )
+
+        self.file_state_cache.update(filename)
+
+        try: 
+            # Try to get from our cache
+            return self.cache[filename]
+        except KeyError:
+
+            # If that fails, parse it afresh
+            try:
+                result = breathe.parser.doxygen.index.parse(filename)
+                self.cache[filename] = result
+                return result
+            except breathe.parser.doxygen.index.ParseError as e:
+                raise ParserError(e, filename)
+            except breathe.parser.doxygen.index.FileIOError as e:
+                raise FileIOError(e, filename)
+
+class DoxygenCompoundParser(Parser):
+
+    def __init__(self, cache, path_handler, file_state_cache, project_info):
+        Parser.__init__(self, cache, path_handler, file_state_cache)
+
+        self.project_info = project_info
+
+    def parse(self, refid):
+
+        filename = self.path_handler.resolve_path(
+                self.project_info.project_path(),
+                "%s.xml" % refid
+                )
+
+        self.file_state_cache.update(filename)
+
+        try: 
+            # Try to get from our cache
+            return self.cache[filename]
+        except KeyError:
+
+            # If that fails, parse it afresh
+            try:
+                result = breathe.parser.doxygen.compound.parse(filename)
+                self.cache[filename] = result
+                return result
+            except breathe.parser.doxygen.compound.ParseError as e:
+                raise ParserError(e, filename)
+            except breathe.parser.doxygen.compound.FileIOError as e:
+                raise FileIOError(e, filename)
+
+class CacheFactory(object):
+
+    def create_cache(self):
+
+        # Return basic dictionary as cache
+        return {}
+
+class DoxygenParserFactory(object):
+
+    def __init__(self, cache, path_handler, file_state_cache):
+
+        self.cache = cache
+        self.path_handler = path_handler
+        self.file_state_cache = file_state_cache
+
+    def create_index_parser(self):
+
+        return DoxygenIndexParser(self.cache, self.path_handler, self.file_state_cache)
+
+    def create_compound_parser(self, project_info):
+
+        return DoxygenCompoundParser(
+                self.cache,
+                self.path_handler,
+                self.file_state_cache,
+                project_info
+                )
+
+
+