Add test for breathe integration, add test build scripts

Author: rogerbarton

.gitignore

@@ -1,6 +1,6 @@
 build
 _build/
-test/_build/
 dist
 test-output
 *.egg-info
+_doxygen/

test/basic/build.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+
+sphinx-build . _build

test/conf.py test/basic/conf.pytest/conf.py renamed to test/basic/conf.py

@@ -200,3 +200,5 @@ More Tests
    .. function:: private List < MyInterface<int, float> > GenericsGaloreFunc <T, U> (ref List <T> a = default,  List < MyInterface<int, float> > b = default)
 
    .. function:: private T ReturnGeneric < T, U > (int a = 0)
+
+.. function:: (MyStruct, MyClass2) tupleFunc((MyStruct, MyClass2) a)

test/index.rst test/basic/index.rsttest/index.rst renamed to test/basic/index.rst

@@ -0,0 +1,6 @@
+#!/bin/bash
+
+doxygen
+echo ""
+echo "--- Running spinx-build ---"
+sphinx-build . _build

test/breathe/Doxyfile

@@ -0,0 +1,23 @@
+project = 'Breathe Test'
+version = ''
+
+master_doc = 'index'
+source_suffix = '.rst'
+extensions = ['sphinx_csharp', 'breathe']
+
+breathe_default_project = 'test-project'
+breathe_projects = {'test-project': "_doxygen/xml"}
+
+pygments_style = 'sphinx'
+
+# Debug options
+sphinx_csharp_debug = False
+sphinx_csharp_debug_parse = False
+sphinx_csharp_debug_parse_func = False
+sphinx_csharp_debug_parse_var = False
+sphinx_csharp_debug_parse_prop = False
+sphinx_csharp_debug_parse_attr = False
+sphinx_csharp_debug_parse_idxr = False
+sphinx_csharp_debug_parse_type = False
+sphinx_csharp_debug_xref = False
+sphinx_csharp_debug_ext_links = False

test/breathe/build.sh

@@ -0,0 +1,44 @@
+using System;
+using UI;
+using UnityEngine;
+using XrInput;
+using Object = UnityEngine.Object;
+
+namespace MyNamespace
+{
+    /// <summary>
+    /// This is a <c>partial</c> class, meaning it is split between several files.
+    /// </summary>
+    /// <remarks>See also <see cref="OtherNamespace.B"/>.</remarks>
+    public unsafe partial class MyClass : IDisposable
+    {
+        public GameObject* gameObject;
+
+        public readonly LibiglMesh Mesh;
+
+        /// <summary>
+        /// Create a behaviour for the <see cref="MonoBehaviour"/> component.
+        /// Every Mesh has one behaviour.
+        /// </summary>
+        public MyClass(GameObject other)
+        {
+            
+        }
+
+        /// <summary>
+        /// Called every frame, the normal Unity Update. 
+        /// </summary>
+        public void Update()
+        {
+            
+        }
+
+        /// <summary>
+        /// Called on the main thread.
+        /// </summary>
+        public void PreExecute()
+        {
+            
+        }
+    }
+}

test/breathe/conf.py

@@ -0,0 +1,41 @@
+using System;
+using UnityEngine;
+
+namespace OtherNamespace
+{
+    /// <summary>
+    /// Some text here
+    /// </summary>
+    /// <remarks>See also <see cref="MyNamespace.MyClass"/>.</remarks>
+    public unsafe partial class B : IDisposable
+    {
+        public GameObject* gameObject;
+
+        public readonly LibiglMesh Mesh;
+
+        /// <summary>
+        /// Create a behaviour for the <see cref="MonoBehaviour"/> component.
+        /// Every Mesh has one behaviour.
+        /// </summary>
+        public B(GameObject other)
+        {
+            
+        }
+
+        /// <summary>
+        /// Called every frame, the normal Unity Update. 
+        /// </summary>
+        public Tuple<MyClass, MyClass> Update(ref B b, int a = 0)
+        {
+            
+        }
+
+        /// <summary>
+        /// Called on the main thread.
+        /// </summary>
+        public void PreExecute()
+        {
+            
+        }
+    }
+}

test/breathe/cs/A.cs

@@ -0,0 +1,18 @@
+Namespaces
+==========
+
+.. doxygennamespace:: MyNamespace
+
+.. doxygennamespace:: OtherNamespace
+
+.. doxygenclass:: MyNamespace::MyClass
+   :members:
+   :protected-members:
+   :private-members:
+   :undoc-members:
+
+.. doxygenclass:: OtherNamespace::B
+   :members:
+   :protected-members:
+   :private-members:
+   :undoc-members: