Stacklevel argument updated pandas-dev#46687

Author: Anupam-USP

doc/source/whatsnew/v1.5.0.rst

@@ -553,6 +553,7 @@ Other Deprecations
 - Deprecated the ``closed`` argument in :meth:`interval_range` in favor of ``inclusive`` argument; In a future version passing ``closed`` will raise (:issue:`40245`)
 - Deprecated the methods :meth:`DataFrame.mad`, :meth:`Series.mad`, and the corresponding groupby methods (:issue:`11787`)
 - Deprecated positional arguments to :meth:`Index.join` except for ``other``, use keyword-only arguments instead of positional arguments (:issue:`46518`)
+- Deprecated passing arguments as positional in :meth:`stacklevel` (:issue:`46687`)
 
 .. ---------------------------------------------------------------------------
 .. _whatsnew_150.performance:

pandas/io/parsers/readers.py

@@ -828,9 +828,7 @@ def read_csv(
     ...
 
 
-@deprecate_nonkeyword_arguments(
-    version=None, allowed_args=["filepath_or_buffer"], stacklevel=3
-)
+@deprecate_nonkeyword_arguments(version=None, allowed_args=["filepath_or_buffer"])
 @Appender(
     _doc_read_csv_and_table.format(
         func_name="read_csv",
@@ -1167,9 +1165,7 @@ def read_table(
     ...
 
 
-@deprecate_nonkeyword_arguments(
-    version=None, allowed_args=["filepath_or_buffer"], stacklevel=3
-)
+@deprecate_nonkeyword_arguments(version=None, allowed_args=["filepath_or_buffer"])
 @Appender(
     _doc_read_csv_and_table.format(
         func_name="read_table",
@@ -1266,9 +1262,7 @@ def read_table(
     return _read(filepath_or_buffer, kwds)
 
 
-@deprecate_nonkeyword_arguments(
-    version=None, allowed_args=["filepath_or_buffer"], stacklevel=2
-)
+@deprecate_nonkeyword_arguments(version=None, allowed_args=["filepath_or_buffer"])
 def read_fwf(
     filepath_or_buffer: FilePath | ReadCsvBuffer[bytes] | ReadCsvBuffer[str],
     colspecs: Sequence[tuple[int, int]] | str | None = "infer",

pandas/util/_decorators.py

@@ -13,6 +13,7 @@
 
 from pandas._libs.properties import cache_readonly  # noqa:F401
 from pandas._typing import F
+from pandas.util._exceptions import find_stack_level
 
 
 def deprecate(
@@ -260,7 +261,7 @@ def future_version_msg(version: str | None) -> str:
 def deprecate_nonkeyword_arguments(
     version: str | None,
     allowed_args: list[str] | None = None,
-    stacklevel: int = 2,
+    stacklevel: int = None,
     name: str | None = None,
 ) -> Callable[[F], F]:
     """
@@ -280,7 +281,7 @@ def deprecate_nonkeyword_arguments(
         defaults to list of all arguments not having the
         default value.
 
-    stacklevel : int, default=2
+    stacklevel : int
         The stack level for warnings.warn
 
     name : str, optional
@@ -304,6 +305,7 @@ def decorate(func):
             f"{future_version_msg(version)} all arguments of "
             f"{name or func.__qualname__}{{arguments}} will be keyword-only."
         )
+        stacklevel = find_stack_level()
 
         @wraps(func)
         def wrapper(*args, **kwargs):