COMPAT: Catch warnings on tab-complete in IPy 6

Properties may run code with Jedi completion in IPython 6

Closes #16409

Author: TomAugspurger

doc/source/whatsnew/v0.20.2.txt

@@ -38,6 +38,10 @@ Bug Fixes
 
 - Bug in using ``pathlib.Path`` or ``py.path.local`` objects with io functions (:issue:`16291`)
 
+
+- Fixed a compatibility issue with IPython 6.0's tab completion showing deprecation warnings on Categoricals (:issue:`16409`)
+
+
 Conversion
 ^^^^^^^^^^
 

pandas/core/categorical.py

@@ -342,6 +342,11 @@ def __init__(self, values, categories=None, ordered=False, fastpath=False):
         self._categories = categories
         self._codes = coerce_indexer_dtype(codes, categories)
 
+    def __dir__(self):
+        # Avoid IPython warnings for deprecated properties
+        # https://github.com/pandas-dev/pandas/issues/16409
+        return [x for x in dir(self) if x != 'labels']
+
     @property
     def _constructor(self):
         return Categorical

pandas/tests/test_categorical.py

@@ -736,6 +736,21 @@ def test_unicode_print(self):
 
             assert _rep(c) == expected
 
+    def test_tab_complete_warning(self):
+        # https://github.com/pandas-dev/pandas/issues/16409
+        pytest.importorskip('IPython', minversion="6.0.0")
+        from IPython.core.interactiveshell import InteractiveShell
+        from IPython.core.completer import provisionalcompleter
+
+        ip = InteractiveShell()
+        code = "import pandas as pd; c = pd.Categorical([])"
+        ip.run_code(code)
+        with pytest.warns(None) as record:
+            with provisionalcompleter('ignore'):
+                list(ip.Completer.completions('c.', 1))
+
+        assert len(record) == 0
+
     def test_periodindex(self):
         idx1 = PeriodIndex(['2014-01', '2014-01', '2014-02', '2014-02',
                             '2014-03', '2014-03'], freq='M')