DOC: Don't show traceback for :okexcept:

- temporarily use local modified ipython_directive
- some flake8-rst ignores to make the pseudodecorators pass

Author: StefRe

doc/source/conf.py

@@ -51,7 +51,7 @@
 
 extensions = [
     "contributors",  # custom pandas extension
-    "IPython.sphinxext.ipython_directive",
+    "ipython_sphinxext.ipython_directive",
     "IPython.sphinxext.ipython_console_highlighting",
     "matplotlib.sphinxext.plot_directive",
     "numpydoc",
@@ -69,6 +69,7 @@
     "sphinx.ext.mathjax",
     "sphinx.ext.todo",
     "nbsphinx",
+    "flake8_rst.sphinxext.custom_roles",
 ]
 
 exclude_patterns = [

doc/source/user_guide/categorical.rst

@@ -361,20 +361,16 @@ Renaming categories is done by using the
 Categories must be unique or a ``ValueError`` is raised:
 
 .. ipython:: python
+   :okexcept: no_traceback
 
-    try:
-        s = s.cat.rename_categories([1, 1, 1])
-    except ValueError as e:
-        print("ValueError:", str(e))
+    s = s.cat.rename_categories([1, 1, 1])
 
 Categories must also not be ``NaN`` or a ``ValueError`` is raised:
 
 .. ipython:: python
+   :okexcept: no_traceback
 
-    try:
-        s = s.cat.rename_categories([1, 2, np.nan])
-    except ValueError as e:
-        print("ValueError:", str(e))
+    s = s.cat.rename_categories([1, 2, np.nan])
 
 Appending new categories
 ~~~~~~~~~~~~~~~~~~~~~~~~
@@ -577,24 +573,21 @@ Equality comparisons work with any list-like object of same length and scalars:
 This doesn't work because the categories are not the same:
 
 .. ipython:: python
+   :okexcept: no_traceback
 
-    try:
-        cat > cat_base2
-    except TypeError as e:
-        print("TypeError:", str(e))
+    cat > cat_base2
 
 If you want to do a "non-equality" comparison of a categorical series with a list-like object
 which is not categorical data, you need to be explicit and convert the categorical data back to
 the original values:
 
 .. ipython:: python
+   :flake8-group: Ignore
 
     base = np.array([1, 2, 3])
 
-    try:
-        cat > base
-    except TypeError as e:
-        print("TypeError:", str(e))
+    @okexcept no_traceback
+    cat > base
 
     np.asarray(cat) > base
 
@@ -765,6 +758,7 @@ Setting values in a categorical column (or ``Series``) works as long as the
 value is included in the ``categories``:
 
 .. ipython:: python
+   :flake8-group: Ignore
 
     idx = pd.Index(["h", "i", "j", "k", "l", "m", "n"])
     cats = pd.Categorical(["a", "a", "a", "a", "a", "a", "a"], categories=["a", "b"])
@@ -773,21 +767,18 @@ value is included in the ``categories``:
 
     df.iloc[2:4, :] = [["b", 2], ["b", 2]]
     df
-    try:
-        df.iloc[2:4, :] = [["c", 3], ["c", 3]]
-    except TypeError as e:
-        print("TypeError:", str(e))
+    @okexcept no_traceback
+    df.iloc[2:4, :] = [["c", 3], ["c", 3]]
 
 Setting values by assigning categorical data will also check that the ``categories`` match:
 
 .. ipython:: python
+   :flake8-group: Ignore
 
     df.loc["j":"k", "cats"] = pd.Categorical(["a", "a"], categories=["a", "b"])
     df
-    try:
-        df.loc["j":"k", "cats"] = pd.Categorical(["b", "b"], categories=["a", "b", "c"])
-    except TypeError as e:
-        print("TypeError:", str(e))
+    @okexcept no_traceback
+    df.loc["j":"k", "cats"] = pd.Categorical(["b", "b"], categories=["a", "b", "c"])
 
 Assigning a ``Categorical`` to parts of a column of other types will use the values:
 
@@ -1072,21 +1063,19 @@ object and not as a low-level NumPy array dtype. This leads to some problems.
 NumPy itself doesn't know about the new ``dtype``:
 
 .. ipython:: python
+   :flake8-group: Ignore
 
-    try:
-        np.dtype("category")
-    except TypeError as e:
-        print("TypeError:", str(e))
+    @okexcept no_traceback
+    np.dtype("category")
 
     dtype = pd.Categorical(["a"]).dtype
-    try:
-        np.dtype(dtype)
-    except TypeError as e:
-        print("TypeError:", str(e))
+    @okexcept no_traceback
+    np.dtype(dtype)
 
 Dtype comparisons work:
 
 .. ipython:: python
+   :flake8-group: Ignore
 
     dtype == np.str_
     np.str_ == dtype
@@ -1102,13 +1091,12 @@ Using NumPy functions on a ``Series`` of type ``category`` should not work as ``
 are not numeric data (even in the case that ``.categories`` is numeric).
 
 .. ipython:: python
+   :flake8-group: Ignore
 
     s = pd.Series(pd.Categorical([1, 2, 3, 4]))
-    try:
-        np.sum(s)
-        # same with np.log(s),...
-    except TypeError as e:
-        print("TypeError:", str(e))
+    @okexcept no_traceback
+    np.sum(s)
+    # same with np.log(s),...
 
 .. note::
     If such a function works, please file a bug at https://github.com/pandas-dev/pandas!