Update to property

Author: tqchen

src/array_api_stubs/_draft/array_object.py

@@ -17,19 +17,6 @@
 
 
 class _array:
-    """
-    Attributes
-    ----------
-    __dlpack_c_exchange_api__: PyCapsule
-        An optional static array type attribute stored in ``type(array_instance).__dlpack_c_exchange_api__``
-        that can be used to retrieve the DLPack C-API exchange API struct in DLPack 1.3 or later to speed up
-        exchange of array data at the C extension level without going through Python-level exchange.
-        See :ref:`data-interchange` section for more details.
-    """
-
-    # use None for placeholder
-    __dlpack_c_exchange_api__: PyCapsule = None
-
     def __init__(self: array) -> None:
         """Initialize the attributes for the array object class."""
 
@@ -132,6 +119,26 @@ def T(self: array) -> array:
            Limiting the transpose to two-dimensional arrays (matrices) deviates from the NumPy et al practice of reversing all axes for arrays having more than two-dimensions. This is intentional, as reversing all axes was found to be problematic (e.g., conflicting with the mathematical definition of a transpose which is limited to matrices; not operating on batches of matrices; et cetera). In order to reverse all axes, one is recommended to use the functional ``permute_dims`` interface found in this specification.
         """
 
+
+    @property
+    def __dlpack_c_exchange_api__(self: array) -> PyCapsule:
+        """
+
+        An optional static array type attribute stored in ``type(array_instance).__dlpack_c_exchange_api__``
+        that can be used to retrieve the DLPack C-API exchange API struct in DLPack 1.3 or later to speed up
+        exchange of array data at the C extension level without going through Python-level exchange.
+        See :ref:`data-interchange` section for more details.
+
+        Returns
+        -------
+        out: PyCapsule
+            The PyCapsule object containing the DLPack C-API exchange API struct.
+
+        .. note::
+           This is a static global object shared across all the array instances of the same type.
+           It can be queried through the ``type(array_instance).__dlpack_c_exchange_api__`` attribute.
+        """
+
     def __abs__(self: array, /) -> array:
         """
         Calculates the absolute value for each element of an array instance.