Py2 compat

Writable docstrings.

Removed lambda as class attribute.

Author: TomAugspurger

pandas/compat/__init__.py

@@ -451,3 +451,11 @@ def is_platform_mac():
 
 def is_platform_32bit():
     return struct.calcsize("P") * 8 < 64
+
+
+class _WritableDoc(type):
+    # Remove this when Python2 support is dropped
+    # __doc__ is not mutable for new-style classes in Python2, which means
+    # we can't use @Appender to share class docstrings. This can be used
+    # with `add_metaclass` to make cls.__doc__ mutable.
+    pass

pandas/core/arrays/interval.py

@@ -3,6 +3,7 @@
 
 from pandas._libs.interval import (Interval, IntervalMixin,
                                    intervals_to_interval_bounds)
+from pandas.compat import add_metaclass, _WritableDoc
 from pandas.compat.numpy import function as nv
 from pandas.core.common import _all_not_none, _asarray_tuplesafe
 from pandas.core.config import get_option
@@ -95,6 +96,7 @@
     versionadded="0.23.0",
     name='', extra_methods='', examples='',
 ))
+@add_metaclass(_WritableDoc)
 class IntervalArray(IntervalMixin, ExtensionArray):
     dtype = IntervalDtype()
     ndim = 1

pandas/core/indexes/interval.py

@@ -4,6 +4,7 @@
 
 import numpy as np
 
+from pandas.compat import add_metaclass, _WritableDoc
 from pandas.core.dtypes.missing import isna
 from pandas.core.dtypes.cast import find_common_type
 from pandas.core.dtypes.common import (
@@ -130,13 +131,12 @@ def _new_IntervalIndex(cls, d):
     """),
 
 ))
+@add_metaclass(_WritableDoc)
 class IntervalIndex(IntervalMixin, Index):
     _typ = 'intervalindex'
     _comparables = ['name']
     _attributes = ['name', 'closed']
     _allow_index_ops = True
-    _exception_rewrite = lambda: rewrite_exception('IntervalArray',
-                                                   'IntervalIndex')
 
     # we would like our indexing holder to defer to us
     _defer_to_indexing = True
@@ -153,7 +153,7 @@ def __new__(cls, data, closed=None, dtype=None, copy=False,
         if name is None and hasattr(data, 'name'):
             name = data.name
 
-        with cls._exception_rewrite():
+        with rewrite_exception("IntervalArray", cls.__name__):
             array = IntervalArray(data, closed=closed, copy=copy, dtype=dtype,
                                   fastpath=fastpath,
                                   verify_integrity=verify_integrity)
@@ -274,7 +274,7 @@ def from_intervals(cls, data, closed=None, name=None, copy=False,
         msg = ('IntervalIndex.from_intervals is deprecated and will be '
                'removed in a future version; Use IntervalIndex(...) instead')
         warnings.warn(msg, FutureWarning, stacklevel=2)
-        with cls._exception_rewrite():
+        with rewrite_exception("IntervalArray", cls.__name__):
             array = IntervalArray(data, closed=closed, copy=copy, dtype=dtype)
 
         if name is None and isinstance(data, cls):
@@ -286,7 +286,7 @@ def from_intervals(cls, data, closed=None, name=None, copy=False,
     @Appender(_interval_shared_docs['from_tuples'] % _index_doc_kwargs)
     def from_tuples(cls, data, closed='right', name=None, copy=False,
                     dtype=None):
-        with cls._exception_rewrite():
+        with rewrite_exception("IntervalArray", cls.__name__):
             arr = IntervalArray.from_tuples(data, closed=closed, copy=copy,
                                             dtype=dtype)
         return cls._simple_new(arr, name=name)