Merge master

Co-authored-by: Luca Ionescu <[email protected]>

Author: alimcmaster1

doc/source/whatsnew/v1.0.0.rst

@@ -545,6 +545,7 @@ Deprecations
 - :func:`pandas.json_normalize` is now exposed in the top-level namespace.
   Usage of ``json_normalize`` as ``pandas.io.json.json_normalize`` is now deprecated and
   it is recommended to use ``json_normalize`` as :func:`pandas.json_normalize` instead (:issue:`27586`).
+- The ``numpy`` argument of :meth:`pandas.read_json` is deprecated (:issue:`28512`).
 - :meth:`DataFrame.to_stata`, :meth:`DataFrame.to_feather`, and :meth:`DataFrame.to_parquet` argument "fname" is deprecated, use "path" instead (:issue:`23574`)
 - The deprecated internal attributes ``_start``, ``_stop`` and ``_step`` of :class:`RangeIndex` now raise a ``FutureWarning`` instead of a ``DeprecationWarning`` (:issue:`26581`)
 

pandas/io/json/_json.py

@@ -11,6 +11,7 @@
 from pandas._libs.tslibs import iNaT
 from pandas._typing import JSONSerializable
 from pandas.errors import AbstractMethodError
+from pandas.util._decorators import deprecate_kwarg
 
 from pandas.core.dtypes.common import ensure_str, is_period_dtype
 
@@ -346,6 +347,7 @@ def _write(
         return serialized
 
 
+@deprecate_kwarg(old_arg_name="numpy", new_arg_name=None)
 def read_json(
     path_or_buf=None,
     orient=None,
@@ -459,6 +461,8 @@ def read_json(
         non-numeric column and index labels are supported. Note also that the
         JSON ordering MUST be the same for each term if numpy=True.
 
+        .. deprecated:: 1.0.0
+
     precise_float : bool, default False
         Set to enable usage of higher precision (strtod) function when
         decoding string to double values. Default (False) is to use fast but

pandas/tests/io/json/test_pandas.py

@@ -3,6 +3,7 @@
 from io import StringIO
 import json
 import os
+from warnings import catch_warnings, filterwarnings
 
 import numpy as np
 import pytest
@@ -1606,3 +1607,13 @@ def test_emca_262_nan_inf_support(self):
             ["a", np.nan, "NaN", np.inf, "Infinity", -np.inf, "-Infinity"]
         )
         tm.assert_frame_equal(result, expected)
+
+    @pytest.mark.filterwarnings("ignore:.*msgpack:FutureWarning")
+    def test_deprecate_numpy_argument_read_json(self):
+        # https://github.com/pandas-dev/pandas/issues/28512
+        expected = DataFrame([1, 2, 3])
+        with tm.assert_produces_warning(None):
+            with catch_warnings():
+                filterwarnings("ignore", category=FutureWarning)
+                result = read_json(expected.to_json(), numpy=True)
+                tm.assert_frame_equal(result, expected)