Add version added to functions created in 2022

Author: steff456

src/array_api_stubs/_draft/__init__.py

@@ -21,4 +21,6 @@
 __array_api_version__: str = "YYYY.MM"
 """
 String representing the version of the array API specification which the conforming implementation adheres to.
+
+.. versionadded:: 2022.12
 """

src/array_api_stubs/_draft/array_object.py

@@ -269,6 +269,8 @@ def __complex__(self: array, /) -> complex:
         - If ``self`` is ``+infinity``, the result is ``+infinity + 0j``.
         - If ``self`` is ``-infinity``, the result is ``-infinity + 0j``.
         - If ``self`` is a finite number, the result is ``self + 0j``.
+
+        .. versionadded:: 2022.12
         """
 
     def __dlpack__(

src/array_api_stubs/_draft/data_type_functions.py

@@ -101,6 +101,8 @@ def finfo(type: Union[dtype, array], /) -> finfo_object:
 
           real-valued floating-point data type.
 
+          .. versionadded:: 2022.12
+
     .. versionchanged:: 2022.12
        Added complex data type support.
     """
@@ -135,6 +137,8 @@ def iinfo(type: Union[dtype, array], /) -> iinfo_object:
         - **dtype**: dtype
 
           integer data type.
+
+          .. versionadded:: 2022.12
     """
 
 
@@ -173,6 +177,8 @@ def isdtype(
     -------
     out: bool
         boolean indicating whether a provided dtype is of a specified data type kind.
+
+    .. versionadded:: 2022.12
     """
 
 

src/array_api_stubs/_draft/elementwise_functions.py

@@ -733,6 +733,8 @@ def conj(x: array, /) -> array:
     -------
     out: array
         an array containing the element-wise results. The returned array must have the same data type as ``x``.
+
+    .. versionadded:: 2022.12
     """
 
 
@@ -1234,6 +1236,8 @@ def imag(x: array, /) -> array:
     -------
     out: array
         an array containing the element-wise results. The returned array must have a floating-point data type with the same floating-point precision as ``x`` (e.g., if ``x`` is ``complex64``, the returned array must have the floating-point data type ``float32``).
+
+    .. versionadded:: 2022.12
     """
 
 
@@ -1941,6 +1945,8 @@ def real(x: array, /) -> array:
     -------
     out: array
         an array containing the element-wise results. The returned array must have a floating-point data type with the same floating-point precision as ``x`` (e.g., if ``x`` is ``complex64``, the returned array must have the floating-point data type ``float32``).
+
+    .. versionadded:: 2022.12
     """
 
 

src/array_api_stubs/_draft/fft.py

@@ -44,6 +44,8 @@ def fft(
     -------
     out: array
         an array transformed along the axis (dimension) indicated by ``axis``. The returned array must have a complex floating-point data type determined by :ref:`type-promotion`.
+
+    .. versionadded:: 2022.12
     """
 
 
@@ -90,6 +92,8 @@ def ifft(
     -------
     out: array
         an array transformed along the axis (dimension) indicated by ``axis``. The returned array must have a complex floating-point data type determined by :ref:`type-promotion`.
+
+    .. versionadded:: 2022.12
     """
 
 
@@ -143,6 +147,8 @@ def fftn(
     -------
     out: array
         an array transformed along the axes (dimension) indicated by ``axes``. The returned array must have a complex floating-point data type determined by :ref:`type-promotion`.
+
+    .. versionadded:: 2022.12
     """
 
 
@@ -196,6 +202,8 @@ def ifftn(
     -------
     out: array
         an array transformed along the axes (dimension) indicated by ``axes``. The returned array must have a complex floating-point data type determined by :ref:`type-promotion`.
+
+    .. versionadded:: 2022.12
     """
 
 
@@ -242,6 +250,8 @@ def rfft(
     -------
     out: array
         an array transformed along the axis (dimension) indicated by ``axis``. The returned array must have a complex-valued floating-point data type determined by :ref:`type-promotion`.
+
+    .. versionadded:: 2022.12
     """
 
 
@@ -288,6 +298,8 @@ def irfft(
     -------
     out: array
         an array transformed along the axis (dimension) indicated by ``axis``. The returned array must have a real-valued floating-point data type determined by :ref:`type-promotion`. The length along the transformed axis is ``n`` (if given) or ``2*(m-1)`` (otherwise).
+
+    .. versionadded:: 2022.12
     """
 
 
@@ -341,6 +353,8 @@ def rfftn(
     -------
     out: array
         an array transformed along the axes (dimension) indicated by ``axes``. The returned array must have a complex-valued floating-point data type determined by :ref:`type-promotion`.
+
+    .. versionadded:: 2022.12
     """
 
 
@@ -394,6 +408,8 @@ def irfftn(
     -------
     out: array
         an array transformed along the axes (dimension) indicated by ``axes``. The returned array must have a real-valued floating-point data type determined by :ref:`type-promotion`. The length along the last transformed axis is ``s[-1]`` (if given) or ``2*(m - 1)`` (otherwise), and all other axes ``s[i]``.
+
+    .. versionadded:: 2022.12
     """
 
 
@@ -437,6 +453,8 @@ def hfft(
     -------
     out: array
         an array transformed along the axis (dimension) indicated by ``axis``. The returned array must have a real-valued floating-point data type determined by :ref:`type-promotion`.
+
+    .. versionadded:: 2022.12
     """
 
 
@@ -480,6 +498,8 @@ def ihfft(
     -------
     out: array
         an array transformed along the axis (dimension) indicated by ``axis``. The returned array must have a complex-valued floating-point data type determined by :ref:`type-promotion`.
+
+    .. versionadded:: 2022.12
     """
 
 
@@ -507,6 +527,8 @@ def fftfreq(n: int, /, *, d: float = 1.0, device: Optional[device] = None) -> ar
     -------
     out: array
         an array of length ``n`` containing the sample frequencies. The returned array must have a real-valued floating-point data type determined by :ref:`type-promotion`.
+
+    .. versionadded:: 2022.12
     """
 
 
@@ -536,6 +558,8 @@ def rfftfreq(n: int, /, *, d: float = 1.0, device: Optional[device] = None) -> a
     -------
     out: array
         an array of length ``n//2+1`` containing the sample frequencies. The returned array must have a real-valued floating-point data type determined by :ref:`type-promotion`.
+
+    .. versionadded:: 2022.12
     """
 
 
@@ -559,6 +583,8 @@ def fftshift(x: array, /, *, axes: Union[int, Sequence[int]] = None) -> array:
     -------
     out: array
         the shifted array. The returned array must have the same data type as ``x``.
+
+    .. versionadded:: 2022.12
     """
 
 
@@ -580,6 +606,8 @@ def ifftshift(x: array, /, *, axes: Union[int, Sequence[int]] = None) -> array:
     -------
     out: array
         the shifted array. The returned array must have the same data type as ``x``.
+
+    .. versionadded:: 2022.12
     """
 
 

src/array_api_stubs/_draft/indexing_functions.py

@@ -23,6 +23,8 @@ def take(x: array, indices: array, /, *, axis: int) -> array:
     -------
     out: array
         an array having the same data type as ``x``. The output array must have the same rank (i.e., number of dimensions) as ``x`` and must have the same shape as ``x``, except for the axis specified by ``axis`` whose size must equal the number of elements in ``indices``.
+
+    .. versionadded:: 2022.12
     """