Merge branch 'main' into release/0.5

Author: RobPasMue

CHANGELOG.md

@@ -1,10 +1,10 @@
 # CHANGELOG
 
-This project uses [towncrier](https://towncrier.readthedocs.io/) to generate changelogs. You can see the changes for the upcoming release in <https://github.com/ansys/{repo-name}/tree/main/changelog.d/>.
+This project uses [towncrier](https://towncrier.readthedocs.io/) to generate changelogs. You can see the changes for the upcoming release in the [changelog fragment directory](https://github.com/ansys/pyansys-geometry/tree/main/doc/changelog.d).
 
 <!-- towncrier release notes start -->
 
-## [0.5.0](https://github.com/ansys/pyansys-geometry/releases/tag/v0.5.0) - 2024-04-16
+## [0.5.0](https://github.com/ansys/pyansys-geometry/releases/tag/v0.5.0) - 2024-04-17
 
 
 ### Added
@@ -51,6 +51,8 @@ This project uses [towncrier](https://towncrier.readthedocs.io/) to generate cha
 - fix: improper types being passed for Face and Edge ctor. [#1096](https://github.com/ansys/pyansys-geometry/pull/1096)
 - fix: return type should be dict and not ``ScalarMapContainer`` (grpc type) [#1103](https://github.com/ansys/pyansys-geometry/pull/1103)
 - fix: env version for Dockerfile Windows [#1120](https://github.com/ansys/pyansys-geometry/pull/1120)
+- fix: changelog description ill-formatted [#1121](https://github.com/ansys/pyansys-geometry/pull/1121)
+- fix: solve issues with intersphinx when releasing [#1123](https://github.com/ansys/pyansys-geometry/pull/1123)
 
 ### Dependencies
 

doc/source/conf.py

@@ -58,6 +58,40 @@ def get_wheelhouse_assets_dictionary():
     return assets
 
 
+def intersphinx_pyansys_geometry(switcher_version: str):
+    """
+    Auxiliary method to build the intersphinx mapping for PyAnsys Geometry.
+
+    Notes
+    -----
+    If the objects.inv file is not found whenever it is a release, the method
+    will default to the "dev" version. If the objects.inv file is not found
+    for the "dev" version, the method will return an empty string.
+
+    Parameters
+    ----------
+    switcher_version : str
+        Version of the PyAnsys Geometry package.
+
+    Returns
+    -------
+    str
+        The intersphinx mapping for PyAnsys Geometry.
+    """
+    prefix = "https://geometry.docs.pyansys.com/version"
+
+    # Check if the object.inv file exists
+    response = requests.get(f"{prefix}/{switcher_version}/objects.inv")
+
+    if response.status_code == 404:
+        if switcher_version == "dev":
+            return ""
+        else:
+            return intersphinx_pyansys_geometry("dev")
+    else:
+        return f"{prefix}/{switcher_version}"
+
+
 # Project information
 project = "ansys-geometry-core"
 copyright = f"(c) {datetime.now().year} ANSYS, Inc. All rights reserved"
@@ -136,9 +170,15 @@ def get_wheelhouse_assets_dictionary():
     "beartype": ("https://beartype.readthedocs.io/en/stable/", None),
     "docker": ("https://docker-py.readthedocs.io/en/stable/", None),
     "pypim": ("https://pypim.docs.pyansys.com/version/stable", None),
-    "ansys.geometry.core": (f"https://geometry.docs.pyansys.com/version/{switcher_version}", None),
 }
 
+# Conditional intersphinx mapping
+if intersphinx_pyansys_geometry(switcher_version):
+    intersphinx_mapping["ansys.geometry.core"] = (
+        intersphinx_pyansys_geometry(switcher_version),
+        None,
+    )
+
 # numpydoc configuration
 numpydoc_show_class_members = False
 numpydoc_xref_param_type = True