Merge branch 'feat/pygeometry-connection' of https://github.com/ansys/pyprimemesh into feat/pygeometry-connection

AlejandroFernandezLuces · AlejandroFernandezLuces · commit 04c2cdb4da9f · 2024-12-20T16:16:18.000+01:00
diff --git a/.gitignore b/.gitignore
@@ -33,7 +33,7 @@ dist/
 # autogenerated docs
 _autosummary
 _build/
-
+_gallery_backreferences
 
 # Testing
 .coverage
@@ -49,4 +49,4 @@ test-output.xml
 .vscode
 
 # logger
-.log
+.log
diff --git a/doc/changelog.d/947.documentation.md b/doc/changelog.d/947.documentation.md
@@ -0,0 +1 @@
+Doc/show mini gallery
diff --git a/doc/changelog.d/948.dependencies.md b/doc/changelog.d/948.dependencies.md
@@ -0,0 +1 @@
+build(deps): bump ansys-tools-visualization-interface from 0.5.0 to 0.6.0 in the general-dependencies group
diff --git a/doc/changelog.d/950.dependencies.md b/doc/changelog.d/950.dependencies.md
@@ -0,0 +1 @@
+build(deps): bump pyvista[trame] from 0.44.1 to 0.44.2 in the pyvista group
diff --git a/doc/changelog.d/954.dependencies.md b/doc/changelog.d/954.dependencies.md
@@ -0,0 +1 @@
+build(deps): bump ansys-sphinx-theme[autoapi] from 1.2.2 to 1.2.3 in the doc-dependencies group
diff --git a/doc/make.bat b/doc/make.bat
@@ -8,7 +8,7 @@ if "%SPHINXBUILD%" == "" (
 	set SPHINXBUILD=sphinx-build
 )
 if "%SPHINXOPTS%" == "" (
-	set SPHINXOPTS=-j auto
+	set SPHINXOPTS=-n -j auto
 )
 
 set SOURCEDIR=source
@@ -36,7 +36,7 @@ goto end
 
 :clean
 rmdir /s /q %BUILDDIR% > /NUL 2>&1
-for /d /r %SOURCEDIR% %%d in (_autosummary) do @if exist "%%d" rmdir /s /q "%%d"
+for /d /r %SOURCEDIR% %%d in (_autosummary,_gallery_backreferences) do @if exist "%%d" rmdir /s /q "%%d"
 rmdir /s /q %SOURCEDIR%\examples\gallery_examples
 rmdir /s /q %SOURCEDIR%\images\auto-generated
 goto end
diff --git a/doc/source/_templates/autosummary/class.rst b/doc/source/_templates/autosummary/class.rst
@@ -30,4 +30,9 @@
    {% endif %}
    {% endblock %}
 
+.. minigallery::
+    :add-heading: Examples using {{ objname }}
+
+    {{ fullname }}
+
 .. vale on
diff --git a/doc/source/_templates/autosummary/function.rst b/doc/source/_templates/autosummary/function.rst
@@ -0,0 +1,10 @@
+{{ name | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autofunction:: {{ fullname }}
+
+.. minigallery::
+    :add-heading: Examples using {{ objname }}
+
+    {{ fullname }}
diff --git a/doc/source/_templates/autosummary/method.rst b/doc/source/_templates/autosummary/method.rst
@@ -0,0 +1,10 @@
+{{ name | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. automethod:: {{ fullname }}
+
+.. minigallery::
+   :add-heading: Examples using {{ objname }}
+
+   {{ fullname }}
diff --git a/doc/source/_templates/autosummary/module.rst b/doc/source/_templates/autosummary/module.rst
@@ -64,4 +64,9 @@
 {% endif %}
 {% endblock %}
 
+.. minigallery::
+   :add-heading: Examples using {{ objname }}
+
+   {{ module }}.{{ objname }}
+
 .. vale on
diff --git a/doc/source/conf.py b/doc/source/conf.py
@@ -71,6 +71,7 @@
     'sphinx.ext.autosummary',
     "numpydoc",
     "sphinx.ext.intersphinx",
+    "sphinx.ext.napoleon",
     "sphinx_copybutton",
     "sphinx_gallery.gen_gallery",
     "jupyter_sphinx",
@@ -168,9 +169,10 @@
     # Sort gallery example by file name instead of number of lines (default)
     "within_subsection_order": FileNameSortKey,
     # directory where function granular galleries are stored
-    "backreferences_dir": None,
+    "backreferences_dir": "api/_gallery_backreferences",
     # Modules for which function level galleries are created.  In
-    "doc_module": "ansys-meshing-prime",
+    "doc_module": ("ansys.meshing.prime"),
+    "exclude_implicit_doc": {"ansys\\.meshing\\.prime\\._.*"},  # ignore private submodules
     "image_scrapers": (DynamicScraper(), "matplotlib"),
     "ignore_pattern": "flycheck*",
     "thumbnail_size": (350, 350),
diff --git a/doc/source/user_guide/launch_prime.rst b/doc/source/user_guide/launch_prime.rst
@@ -67,7 +67,7 @@ The :func:`Client.exit() <ansys.meshing.prime.Client.exit>` method ends the conn
 If the :class:`Client <ansys.meshing.prime.Client>` class launched the server, then this terminates the server process.
 
 .. note::
-If you use Intel(R) MPI Library, Version 2021.8, you may encounter the following error while exiting the client:
+    If you use Intel(R) MPI Library, Version 2021.8, you may encounter the following error while exiting the client:
 
 .. figure:: ../images/client_exit_error.png
     :width: 200pt
diff --git a/pyproject.toml b/pyproject.toml
@@ -35,16 +35,16 @@ pygeometry = [
   "ansys-geometry-core>=0.7.6,<1",
 ]
 tests = [
-  "ansys-tools-visualization-interface==0.5.0",
+  "ansys-tools-visualization-interface==0.6.0",
   "pytest==8.3.4",
   "pytest-cov==6.0.0",
   "pytest-pyvista==0.1.9",
   "pytest-xvfb==3.0.0",
-  "pyvista[trame]==0.44.1"
+  "pyvista[trame]==0.44.2"
 ]
 doc = [
-  "ansys-tools-visualization-interface==0.5.0",
-  "ansys-sphinx-theme[autoapi]==1.2.2",
+  "ansys-tools-visualization-interface==0.6.0",
+  "ansys-sphinx-theme[autoapi]==1.2.3",
   "jupyter-sphinx==0.5.3",
   "numpydoc==1.8.0",
   "sphinx==8.1.3",

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+build(deps): bump ansys-tools-visualization-interface from 0.5.0 to 0.6.0 in the general-dependencies group`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+build(deps): bump pyvista[trame] from 0.44.1 to 0.44.2 in the pyvista group`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+build(deps): bump ansys-sphinx-theme[autoapi] from 1.2.2 to 1.2.3 in the doc-dependencies group`