move imports on top, add better warning message, remove error raise

KevsterAmp · KevsterAmp · commit f0bec10715b3 · 2024-11-25T19:22:43.000+08:00
diff --git a/pandas/core/arrays/arrow/array.py b/pandas/core/arrays/arrow/array.py
@@ -12,6 +12,7 @@
     cast,
 )
 import unicodedata
+import warnings
 
 import numpy as np
 
@@ -28,6 +29,7 @@
     pa_version_under13p0,
 )
 from pandas.util._decorators import doc
+from pandas.util._exceptions import find_stack_level
 from pandas.util._validators import validate_fillna_kwargs
 
 from pandas.core.dtypes.cast import (
@@ -663,20 +665,15 @@ def __array__(
     ) -> np.ndarray:
         """Correctly construct numpy arrays when passed to `np.asarray()`."""
         if copy is False:
-            import warnings
-
-            from pandas.util._exceptions import find_stack_level
-
             warnings.warn(
-                "Numpy>=2.0 changed copy keyword's behavior, making copy=False"
-                "raise an error when a zero-copy numpy array is not possible",
+                "Starting on NumPy 2.0, the behavior of the 'copy' keyword has changed "
+                "and passing 'copy=False' raises an error when a zero-copy NumPy array "
+                "is not possible, Pandas will follow this behavior starting with "
+                "version 3.0. This conversion to NumPy requires a copy, but "
+                "'copy=False' was passed. Consider using 'np.asarray(..)' instead.",
                 FutureWarning,
                 stacklevel=find_stack_level(),
             )
-            # TODO: By using `zero_copy_only` it may be possible to implement this
-            raise ValueError(
-                "Unable to avoid copy while creating an array as requested."
-            )
         elif copy is None:
             # `to_numpy(copy=False)` has the meaning of NumPy `copy=None`.
             copy = False
diff --git a/pandas/core/arrays/categorical.py b/pandas/core/arrays/categorical.py
@@ -1672,19 +1672,15 @@ def __array__(
         array(['a', 'b'], dtype=object)
         """
         if copy is False:
-            import warnings
-
-            from pandas.util._exceptions import find_stack_level
-
             warnings.warn(
-                "Numpy>=2.0 changed copy keyword's behavior, making copy=False "
-                "raise an error when a zero-copy numpy array is not possible",
+                "Starting on NumPy 2.0, the behavior of the 'copy' keyword has changed "
+                "and passing 'copy=False' raises an error when a zero-copy NumPy array "
+                "is not possible, Pandas will follow this behavior starting with "
+                "version 3.0. This conversion to NumPy requires a copy, but "
+                "'copy=False' was passed. Consider using 'np.asarray(..)' instead.",
                 FutureWarning,
                 stacklevel=find_stack_level(),
             )
-            raise ValueError(
-                "Unable to avoid copy while creating an array as requested."
-            )
 
         ret = take_nd(self.categories._values, self._codes)
         # When we're a Categorical[ExtensionArray], like Interval,
diff --git a/pandas/core/arrays/datetimelike.py b/pandas/core/arrays/datetimelike.py
@@ -359,19 +359,17 @@ def __array__(
         # used for Timedelta/DatetimeArray, overwritten by PeriodArray
         if is_object_dtype(dtype):
             if copy is False:
-                import warnings
-
-                from pandas.util._exceptions import find_stack_level
-
                 warnings.warn(
-                    "Numpy>=2.0 changed copy keyword's behavior, making copy=False"
-                    "raise an error when a zero-copy numpy array is not possible",
+                    "Starting on NumPy 2.0, the behavior of the 'copy' keyword has "
+                    "changed and passing 'copy=False' raises an error when a zero-copy "
+                    "NumPy array is not possible, Pandas will follow this behavior "
+                    "starting with version 3.0. This conversion to NumPy requires a "
+                    "copy, but 'copy=False' was passed. Consider using "
+                    "'np.asarray(..)' instead.",
                     FutureWarning,
                     stacklevel=find_stack_level(),
                 )
-                raise ValueError(
-                    "Unable to avoid copy while creating an array as requested."
-                )
+
             return np.array(list(self), dtype=object)
 
         if copy is True:
diff --git a/pandas/core/arrays/interval.py b/pandas/core/arrays/interval.py
@@ -42,6 +42,7 @@
 from pandas.compat.numpy import function as nv
 from pandas.errors import IntCastingNaNError
 from pandas.util._decorators import Appender
+from pandas.util._exceptions import find_stack_level
 
 from pandas.core.dtypes.cast import (
     LossySetitemError,
@@ -1575,19 +1576,15 @@ def __array__(
         objects (with dtype='object')
         """
         if copy is False:
-            import warnings
-
-            from pandas.util._exceptions import find_stack_level
-
             warnings.warn(
-                "Numpy>=2.0 changed copy keyword's behavior, making copy=False"
-                "raise an error when a zero-copy numpy array is not possible",
+                "Starting on NumPy 2.0, the behavior of the 'copy' keyword has changed "
+                "and passing 'copy=False' raises an error when a zero-copy NumPy array "
+                "is not possible, Pandas will follow this behavior starting with "
+                "version 3.0. This conversion to NumPy requires a copy, but "
+                "'copy=False' was passed. Consider using 'np.asarray(..)' instead.",
                 FutureWarning,
                 stacklevel=find_stack_level(),
             )
-            raise ValueError(
-                "Unable to avoid copy while creating an array as requested."
-            )
 
         left = self._left
         right = self._right
diff --git a/pandas/core/arrays/masked.py b/pandas/core/arrays/masked.py
@@ -38,6 +38,7 @@
 )
 from pandas.errors import AbstractMethodError
 from pandas.util._decorators import doc
+from pandas.util._exceptions import find_stack_level
 from pandas.util._validators import validate_fillna_kwargs
 
 from pandas.core.dtypes.base import ExtensionDtype
@@ -605,19 +606,15 @@ def __array__(
                 # special case, here we can simply return the underlying data
                 return np.array(self._data, dtype=dtype, copy=copy)
 
-            import warnings
-
-            from pandas.util._exceptions import find_stack_level
-
             warnings.warn(
-                "Numpy>=2.0 changed copy keyword's behavior, making copy=False"
-                "raise an error when a zero-copy numpy array is not possible",
+                "Starting on NumPy 2.0, the behavior of the 'copy' keyword has changed "
+                "and passing 'copy=False' raises an error when a zero-copy NumPy array "
+                "is not possible, Pandas will follow this behavior starting with "
+                "version 3.0. This conversion to NumPy requires a copy, but "
+                "'copy=False' was passed. Consider using 'np.asarray(..)' instead.",
                 FutureWarning,
                 stacklevel=find_stack_level(),
             )
-            raise ValueError(
-                "Unable to avoid copy while creating an array as requested."
-            )
 
         if copy is None:
             copy = False  # The NumPy copy=False meaning is different here.
diff --git a/pandas/core/arrays/period.py b/pandas/core/arrays/period.py
@@ -415,19 +415,15 @@ def __array__(
                 return np.array(self.asi8, dtype=dtype)
 
         if copy is False:
-            import warnings
-
-            from pandas.util._exceptions import find_stack_level
-
             warnings.warn(
-                "Numpy>=2.0 changed copy keyword's behavior, making copy=False"
-                "raise an error when a zero-copy numpy array is not possible",
+                "Starting on NumPy 2.0, the behavior of the 'copy' keyword has changed "
+                "and passing 'copy=False' raises an error when a zero-copy NumPy array "
+                "is not possible, Pandas will follow this behavior starting with "
+                "version 3.0. This conversion to NumPy requires a copy, but "
+                "'copy=False' was passed. Consider using 'np.asarray(..)' instead.",
                 FutureWarning,
                 stacklevel=find_stack_level(),
             )
-            raise ValueError(
-                "Unable to avoid copy while creating an array as requested."
-            )
 
         if dtype == bool:
             return ~self._isnan
diff --git a/pandas/core/arrays/sparse/array.py b/pandas/core/arrays/sparse/array.py
@@ -562,19 +562,15 @@ def __array__(
                 return self.sp_values
 
         if copy is False:
-            import warnings
-
-            from pandas.util._exceptions import find_stack_level
-
             warnings.warn(
-                "Numpy>=2.0 changed copy keyword's behavior, making copy=False"
-                "raise an error when a zero-copy numpy array is not possible",
+                "Starting on NumPy 2.0, the behavior of the 'copy' keyword has changed "
+                "and passing 'copy=False' raises an error when a zero-copy NumPy array "
+                "is not possible, Pandas will follow this behavior starting with "
+                "version 3.0. This conversion to NumPy requires a copy, but "
+                "'copy=False' was passed. Consider using 'np.asarray(..)' instead.",
                 FutureWarning,
                 stacklevel=find_stack_level(),
             )
-            raise ValueError(
-                "Unable to avoid copy while creating an array as requested."
-            )
 
         fill_value = self.fill_value
 
diff --git a/pandas/core/generic.py b/pandas/core/generic.py
@@ -2151,20 +2151,16 @@ def __array__(
     ) -> np.ndarray:
         if copy is False and not self._mgr.is_single_block and not self.empty:
             # check this manually, otherwise ._values will already return a copy
-            # and np.array(values, copy=False) will not raise an error
-            import warnings
-
-            from pandas.util._exceptions import find_stack_level
-
+            # and np.array(values, copy=False) will not raise a warning
             warnings.warn(
-                "Numpy>=2.0 changed the copy keyword behavior, making copy=False"
-                "raise an error when a zero-copy numpy array is not possible.",
+                "Starting on NumPy 2.0, the behavior of the 'copy' keyword has changed "
+                "and passing 'copy=False' raises an error when a zero-copy NumPy array "
+                "is not possible, Pandas will follow this behavior starting with "
+                "version 3.0. This conversion to NumPy requires a copy, but "
+                "'copy=False' was passed. Consider using 'np.asarray(..)' instead.",
                 FutureWarning,
                 stacklevel=find_stack_level(),
             )
-            raise ValueError(
-                "Unable to avoid copy while creating an array as requested."
-            )
         values = self._values
         if copy is None:
             # Note: branch avoids `copy=None` for NumPy 1.x support
diff --git a/pandas/core/indexes/multi.py b/pandas/core/indexes/multi.py
@@ -1314,19 +1314,15 @@ def __array__(self, dtype=None, copy=None) -> np.ndarray:
         """the array interface, return my values"""
         if copy is False:
             # self.values is always a newly construct array, so raise.
-            import warnings
-
-            from pandas.util._exceptions import find_stack_level
-
             warnings.warn(
-                "Numpy>=2.0 changed copy keyword's behavior, making copy=False"
-                "raise an error when a zero-copy numpy array is not possible",
+                "Starting on NumPy 2.0, the behavior of the 'copy' keyword has changed "
+                "and passing 'copy=False' raises an error when a zero-copy NumPy array "
+                "is not possible, Pandas will follow this behavior starting with "
+                "version 3.0. This conversion to NumPy requires a copy, but "
+                "'copy=False' was passed. Consider using 'np.asarray(..)' instead.",
                 FutureWarning,
                 stacklevel=find_stack_level(),
             )
-            raise ValueError(
-                "Unable to avoid copy while creating an array as requested."
-            )
         if copy is True:
             # explicit np.array call to ensure a copy is made and unique objects
             # are returned, because self.values is cached
