Skip to content

Commit dacae10

Browse files
jrebackjorisvandenbossche
authored andcommitted
DEPR: deprecate the data reader package, #10861
1 parent 3bf4dc6 commit dacae10

File tree

2 files changed

+24
-0
lines changed

2 files changed

+24
-0
lines changed

doc/source/whatsnew/v0.17.0.txt

+15
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,21 @@ users upgrade to this version.
1111

1212
pandas >= 0.17.0 will no longer support compatibility with Python version 3.2 (:issue:`9118`)
1313

14+
.. warning::
15+
16+
The ``pandas.io.data`` package is deprecated and will be replaced by the
17+
`pandas-datareader package <https://github.com/pydata/pandas-datareader>`_.
18+
This will allow the data modules to be independently updated to your pandas
19+
installation. The API for ``pandas-datareader v0.1.1`` is exactly the same
20+
as in ``pandas v0.17.0`` (:issue:`8961`, :issue:`10861`).
21+
22+
After installing pandas-datareader, you can easily change your imports:
23+
24+
.. code-block:: Python
25+
26+
from pandas.io import data, wb # becomes
27+
from pandas_datareader import data, wb
28+
1429
Highlights include:
1530

1631
- Release the Global Interpreter Lock (GIL) on some cython operations, see :ref:`here <whatsnew_0170.gil>`

pandas/io/data.py

+9
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,15 @@
2323
from pandas.util.testing import _network_error_classes
2424
from pandas.io.html import read_html
2525

26+
warnings.warn("\n"
27+
"The pandas.io.data module is moved to a separate package "
28+
"(pandas-datareader) and will be removed from pandas in a "
29+
"future version.\nAfter installing the pandas-datareader package "
30+
"(https://github.com/pydata/pandas-datareader), you can change "
31+
"the import ``from pandas.io import data, wb`` to "
32+
"``from pandas_datareader import data, wb``.",
33+
FutureWarning)
34+
2635
class SymbolWarning(UserWarning):
2736
pass
2837

0 commit comments

Comments
 (0)