TYP: positional-only binop parameters in numpy.generic subtypes

Author: jorenham

numpy/__init__.pyi

@@ -2882,13 +2882,13 @@ class datetime64(generic):
         format: _CharLike_co | tuple[_CharLike_co, _IntLike_co],
         /,
     ) -> None: ...
-    def __add__(self, other: _TD64Like_co) -> datetime64: ...
-    def __radd__(self, other: _TD64Like_co) -> datetime64: ...
+    def __add__(self, other: _TD64Like_co, /) -> datetime64: ...
+    def __radd__(self, other: _TD64Like_co, /) -> datetime64: ...
     @overload
-    def __sub__(self, other: datetime64) -> timedelta64: ...
+    def __sub__(self, other: datetime64, /) -> timedelta64: ...
     @overload
-    def __sub__(self, other: _TD64Like_co) -> datetime64: ...
-    def __rsub__(self, other: datetime64) -> timedelta64: ...
+    def __sub__(self, other: _TD64Like_co, /) -> datetime64: ...
+    def __rsub__(self, other: datetime64, /) -> timedelta64: ...
     __lt__: _ComparisonOp[datetime64, _ArrayLikeDT64_co]
     __le__: _ComparisonOp[datetime64, _ArrayLikeDT64_co]
     __gt__: _ComparisonOp[datetime64, _ArrayLikeDT64_co]
@@ -2911,9 +2911,9 @@ class integer(number[_NBit1]):  # type: ignore
     @property
     def denominator(self) -> L[1]: ...
     @overload
-    def __round__(self, ndigits: None = ...) -> int: ...
+    def __round__(self, ndigits: None = ..., /) -> int: ...
     @overload
-    def __round__(self: _ScalarType, ndigits: SupportsIndex) -> _ScalarType: ...
+    def __round__(self: _ScalarType, ndigits: SupportsIndex, /) -> _ScalarType: ...
 
     # NOTE: `__index__` is technically defined in the bottom-most
     # sub-classes (`int64`, `uint32`, etc)
@@ -2926,20 +2926,20 @@ class integer(number[_NBit1]):  # type: ignore
     def __index__(self) -> int: ...
     __truediv__: _IntTrueDiv[_NBit1]
     __rtruediv__: _IntTrueDiv[_NBit1]
-    def __mod__(self, value: _IntLike_co) -> integer[Any]: ...
-    def __rmod__(self, value: _IntLike_co) -> integer[Any]: ...
+    def __mod__(self, value: _IntLike_co, /) -> integer[Any]: ...
+    def __rmod__(self, value: _IntLike_co, /) -> integer[Any]: ...
     def __invert__(self: _IntType) -> _IntType: ...
     # Ensure that objects annotated as `integer` support bit-wise operations
-    def __lshift__(self, other: _IntLike_co) -> integer[Any]: ...
-    def __rlshift__(self, other: _IntLike_co) -> integer[Any]: ...
-    def __rshift__(self, other: _IntLike_co) -> integer[Any]: ...
-    def __rrshift__(self, other: _IntLike_co) -> integer[Any]: ...
-    def __and__(self, other: _IntLike_co) -> integer[Any]: ...
-    def __rand__(self, other: _IntLike_co) -> integer[Any]: ...
-    def __or__(self, other: _IntLike_co) -> integer[Any]: ...
-    def __ror__(self, other: _IntLike_co) -> integer[Any]: ...
-    def __xor__(self, other: _IntLike_co) -> integer[Any]: ...
-    def __rxor__(self, other: _IntLike_co) -> integer[Any]: ...
+    def __lshift__(self, other: _IntLike_co, /) -> integer[Any]: ...
+    def __rlshift__(self, other: _IntLike_co, /) -> integer[Any]: ...
+    def __rshift__(self, other: _IntLike_co, /) -> integer[Any]: ...
+    def __rrshift__(self, other: _IntLike_co, /) -> integer[Any]: ...
+    def __and__(self, other: _IntLike_co, /) -> integer[Any]: ...
+    def __rand__(self, other: _IntLike_co, /) -> integer[Any]: ...
+    def __or__(self, other: _IntLike_co, /) -> integer[Any]: ...
+    def __ror__(self, other: _IntLike_co, /) -> integer[Any]: ...
+    def __xor__(self, other: _IntLike_co, /) -> integer[Any]: ...
+    def __rxor__(self, other: _IntLike_co, /) -> integer[Any]: ...
 
 class signedinteger(integer[_NBit1]):
     def __init__(self, value: _IntValue = ..., /) -> None: ...
@@ -3003,20 +3003,20 @@ class timedelta64(generic):
     def __neg__(self: _ArraySelf) -> _ArraySelf: ...
     def __pos__(self: _ArraySelf) -> _ArraySelf: ...
     def __abs__(self: _ArraySelf) -> _ArraySelf: ...
-    def __add__(self, other: _TD64Like_co) -> timedelta64: ...
-    def __radd__(self, other: _TD64Like_co) -> timedelta64: ...
-    def __sub__(self, other: _TD64Like_co) -> timedelta64: ...
-    def __rsub__(self, other: _TD64Like_co) -> timedelta64: ...
-    def __mul__(self, other: _FloatLike_co) -> timedelta64: ...
-    def __rmul__(self, other: _FloatLike_co) -> timedelta64: ...
+    def __add__(self, other: _TD64Like_co, /) -> timedelta64: ...
+    def __radd__(self, other: _TD64Like_co, /) -> timedelta64: ...
+    def __sub__(self, other: _TD64Like_co, /) -> timedelta64: ...
+    def __rsub__(self, other: _TD64Like_co, /) -> timedelta64: ...
+    def __mul__(self, other: _FloatLike_co, /) -> timedelta64: ...
+    def __rmul__(self, other: _FloatLike_co, /) -> timedelta64: ...
     __truediv__: _TD64Div[float64]
     __floordiv__: _TD64Div[int64]
-    def __rtruediv__(self, other: timedelta64) -> float64: ...
-    def __rfloordiv__(self, other: timedelta64) -> int64: ...
-    def __mod__(self, other: timedelta64) -> timedelta64: ...
-    def __rmod__(self, other: timedelta64) -> timedelta64: ...
-    def __divmod__(self, other: timedelta64) -> tuple[int64, timedelta64]: ...
-    def __rdivmod__(self, other: timedelta64) -> tuple[int64, timedelta64]: ...
+    def __rtruediv__(self, other: timedelta64, /) -> float64: ...
+    def __rfloordiv__(self, other: timedelta64, /) -> int64: ...
+    def __mod__(self, other: timedelta64, /) -> timedelta64: ...
+    def __rmod__(self, other: timedelta64, /) -> timedelta64: ...
+    def __divmod__(self, other: timedelta64, /) -> tuple[int64, timedelta64]: ...
+    def __rdivmod__(self, other: timedelta64, /) -> tuple[int64, timedelta64]: ...
     __lt__: _ComparisonOp[_TD64Like_co, _ArrayLikeTD64_co]
     __le__: _ComparisonOp[_TD64Like_co, _ArrayLikeTD64_co]
     __gt__: _ComparisonOp[_TD64Like_co, _ArrayLikeTD64_co]
@@ -3087,9 +3087,9 @@ class floating(inexact[_NBit1]):
     def __getnewargs__(self: float64) -> tuple[float]: ...
     def __getformat__(self: float64, typestr: L["double", "float"], /) -> str: ...
     @overload
-    def __round__(self, ndigits: None = ...) -> int: ...
+    def __round__(self, ndigits: None = ..., /) -> int: ...
     @overload
-    def __round__(self: _ScalarType, ndigits: SupportsIndex) -> _ScalarType: ...
+    def __round__(self: _ScalarType, ndigits: SupportsIndex, /) -> _ScalarType: ...
     __add__: _FloatOp[_NBit1]
     __radd__: _FloatOp[_NBit1]
     __sub__: _FloatOp[_NBit1]
@@ -3170,13 +3170,14 @@ class void(flexible):
         self, val: ArrayLike, dtype: DTypeLike, offset: int = ...
     ) -> None: ...
     @overload
-    def __getitem__(self, key: str | SupportsIndex) -> Any: ...
+    def __getitem__(self, key: str | SupportsIndex, /) -> Any: ...
     @overload
-    def __getitem__(self, key: list[str]) -> void: ...
+    def __getitem__(self, key: list[str], /) -> void: ...
     def __setitem__(
         self,
         key: str | list[str] | SupportsIndex,
         value: ArrayLike,
+        /,
     ) -> None: ...
 
 class character(flexible):  # type: ignore