Collect Index methods by purpose: rendering, constructors, setops... (pandas-dev#23961)

Author: jbrockmendel

pandas/core/indexes/base.py

@@ -94,6 +94,9 @@ def _engine_type(self):
 
     _attributes = ['name']
 
+    # --------------------------------------------------------------------
+    # Constructors
+
     def __new__(cls, data=None, categories=None, ordered=None, dtype=None,
                 copy=False, name=None, fastpath=None):
 
@@ -212,6 +215,8 @@ def _simple_new(cls, values, name=None, categories=None, ordered=None,
         result._reset_identity()
         return result
 
+    # --------------------------------------------------------------------
+
     @Appender(_index_shared_docs['_shallow_copy'])
     def _shallow_copy(self, values=None, categories=None, ordered=None,
                       dtype=None, **kwargs):
@@ -284,6 +289,9 @@ def equals(self, other):
 
         return False
 
+    # --------------------------------------------------------------------
+    # Rendering Methods
+
     @property
     def _formatter_func(self):
         return self.categories._formatter_func
@@ -307,6 +315,8 @@ def _format_attrs(self):
             attrs.append(('length', len(self)))
         return attrs
 
+    # --------------------------------------------------------------------
+
     @property
     def inferred_type(self):
         return 'categorical'

pandas/core/indexes/category.py

@@ -331,9 +331,6 @@ def _box_values_as_index(self):
         from pandas.core.index import Index
         return Index(self._box_values(self.asi8), name=self.name, dtype=object)
 
-    def _format_with_header(self, header, **kwargs):
-        return header + list(self._format_native_types(**kwargs))
-
     @Appender(_index_shared_docs['__contains__'] % _index_doc_kwargs)
     def __contains__(self, key):
         try:
@@ -544,6 +541,12 @@ def argmax(self, axis=None, *args, **kwargs):
             i8[mask] = 0
         return i8.argmax()
 
+    # --------------------------------------------------------------------
+    # Rendering Methods
+
+    def _format_with_header(self, header, **kwargs):
+        return header + list(self._format_native_types(**kwargs))
+
     @property
     def _formatter_func(self):
         raise AbstractMethodError(self)
@@ -561,6 +564,8 @@ def _format_attrs(self):
                 attrs.append(('freq', freq))
         return attrs
 
+    # --------------------------------------------------------------------
+
     def _convert_scalar_indexer(self, key, kind=None):
         """
         We don't allow integer or float indexing on datetime-like when using