Dynamic mode: add augmentation gallery (#6057)

- Dynamic mode augmentation gallery notebook
- Adds Dynamic Mode section to the examples section of the documentation
- Sphinx 8.x Compatibility 

Signed-off-by: Joaquin Anton Guirao <[email protected]>

Author: jantonguirao

docs/conf.py

@@ -521,20 +521,35 @@ def filter_members(self, members, want_all):
         the ones we're interested in.
         We can do the sorting here based on the values, and pass through in self.sort_members()
         """
+
         # Since pybind11 https://github.com/pybind/pybind11/pull/2739 there is an extra `value`
         # member returned by get_object_members().
         # Here we are filtering the list, to keep only enum members
+        def get_member_name(member):
+            # Sphinx 8.x: ObjectMember with __name__ attribute
+            # Older Sphinx: tuple (name, value, docstring)
+            if hasattr(member, "__name__"):
+                return member.__name__
+            else:
+                return member[0]
+
         filtered = [
             member
             for member in members
-            if member[0] in self.object.__members__.keys()
+            if get_member_name(member) in self.object.__members__.keys()
         ]
 
         filtered = super().filter_members(filtered, want_all)
 
         # sort by the actual value of enum - this is a tuple of (name, value, boolean)
+        # In Sphinx 8.x, it's an ObjectMember with .object attribute
         def get_member_value(member_desc):
-            _, member_value, _ = member_desc
+            if hasattr(member_desc, "object"):
+                # Sphinx 8.x: ObjectMember
+                member_value = member_desc.object
+            else:
+                # Older Sphinx: tuple unpacking
+                _, member_value, _ = member_desc
             if isinstance(member_value, Enum):
                 return member_value.value
             else:

docs/examples/dynamic_mode/augmentation_gallery.ipynb

@@ -0,0 +1,42 @@
+# Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from doc_index import doc, doc_entry, op_reference
+
+doc(
+    title="Dynamic Mode",
+    underline_char="=",
+    entries=[
+        doc_entry(
+            "augmentation_gallery.ipynb",
+            [
+                op_reference("dynamic.erase", "Augmentation gallery"),
+                op_reference("dynamic.water", "Augmentation gallery"),
+                op_reference("dynamic.sphere", "Augmentation gallery"),
+                op_reference("dynamic.warp_affine", "Augmentation gallery"),
+                op_reference(
+                    "dynamic.jpeg_compression_distortion",
+                    "Augmentation gallery",
+                ),
+                op_reference("dynamic.paste", "Augmentation gallery"),
+                op_reference("dynamic.flip", "Augmentation gallery"),
+                op_reference("dynamic.rotate", "Augmentation gallery"),
+                op_reference("dynamic.hsv", "Augmentation gallery"),
+                op_reference(
+                    "dynamic.brightness_contrast", "Augmentation gallery"
+                ),
+            ],
+        ),
+    ],
+)

docs/examples/dynamic_mode/index.py

@@ -0,0 +1,7 @@
+Dynamic Mode
+============
+
+.. toctree::
+   :maxdepth: 2
+
+   augmentation_gallery.ipynb

docs/examples/dynamic_mode/index.rst

@@ -37,6 +37,7 @@
             ],
         ),
         "operations_index.py",
+        "dynamic_mode/index.py",
         "use_cases/index.py",
         "other_index.py",
     ],