Skip to content

Commit

Permalink
DEPR: deprecate the data reader package, #10861
Browse files Browse the repository at this point in the history
  • Loading branch information
jreback authored and jorisvandenbossche committed Aug 23, 2015
1 parent 3bf4dc6 commit dacae10
Show file tree
Hide file tree
Showing 2 changed files with 24 additions and 0 deletions.
15 changes: 15 additions & 0 deletions doc/source/whatsnew/v0.17.0.txt
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,21 @@ users upgrade to this version.

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

.. warning::

The ``pandas.io.data`` package is deprecated and will be replaced by the
`pandas-datareader package <https://github.com/pydata/pandas-datareader>`_.
This will allow the data modules to be independently updated to your pandas
installation. The API for ``pandas-datareader v0.1.1`` is exactly the same
as in ``pandas v0.17.0`` (:issue:`8961`, :issue:`10861`).

After installing pandas-datareader, you can easily change your imports:

.. code-block:: Python

from pandas.io import data, wb # becomes
from pandas_datareader import data, wb

Highlights include:

- Release the Global Interpreter Lock (GIL) on some cython operations, see :ref:`here <whatsnew_0170.gil>`
Expand Down
9 changes: 9 additions & 0 deletions pandas/io/data.py
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,15 @@
from pandas.util.testing import _network_error_classes
from pandas.io.html import read_html

warnings.warn("\n"
"The pandas.io.data module is moved to a separate package "
"(pandas-datareader) and will be removed from pandas in a "
"future version.\nAfter installing the pandas-datareader package "
"(https://github.com/pydata/pandas-datareader), you can change "
"the import ``from pandas.io import data, wb`` to "
"``from pandas_datareader import data, wb``.",
FutureWarning)

class SymbolWarning(UserWarning):
pass

Expand Down

0 comments on commit dacae10

Please sign in to comment.