update docs, type

Author: TomAugspurger

pandas/core/arrays/base.py

@@ -681,17 +681,25 @@ def __repr__(self):
                                dtype=self.dtype)
 
     def _formatter(self, formatter=None):
-        # type: (ExtensionArrayFormatter) -> Callable[Any]
+        # type: (Optional[ExtensionArrayFormatter]) -> Callable[[Any], str]
         """Formatting function for scalar values.
 
         This is used in the default '__repr__'. The formatting function
         receives instances of your scalar type.
 
         Parameters
         ----------
-        boxed: bool, default False
-            Whether the formatter is to be used by pandas inside a Series
-            or DataFrame repr.
+        formatter: GenericArrayFormatter, optional
+            The formatter this array is being rendered with. The formatter
+            may have a `.formatter` method already defined. By default, this
+            will be used if a `formatter` is passed, otherwise the formatter
+            is ``str``.
+
+        Returns
+        -------
+        Callable[[Any], str]
+            A callable that gets instances of the scalar type and
+            returns a string.
         """
         return getattr(formatter, 'formatter', None) or str
 

pandas/core/arrays/integer.py

@@ -264,12 +264,14 @@ def _from_sequence(cls, scalars, dtype=None, copy=False):
     def _from_factorized(cls, values, original):
         return integer_array(values, dtype=original.dtype)
 
-    def _formatter(self, boxed=False):
-        def fmt(x):
-            if isna(x):
-                return 'NaN'
-            return str(x)
-        return fmt
+    def _formatter(self, formatter=None):
+        if formatter is None:
+            def fmt(x):
+                if isna(x):
+                    return 'NaN'
+                return str(x)
+            return fmt
+        return formatter.formatter
 
     def __getitem__(self, item):
         if is_integer(item):

pandas/core/arrays/period.py

@@ -330,8 +330,8 @@ def start_time(self):
     def end_time(self):
         return self.to_timestamp(how='end')
 
-    def _formatter(self, boxed=False):
-        if boxed:
+    def _formatter(self, formatter=None):
+        if formatter:
             return str
         return "'{}'".format
 

pandas/tests/arrays/test_integer.py

@@ -67,6 +67,11 @@ def test_repr_array(data):
     assert 'dtype: ' in result
 
 
+def test_na_repr(data):
+    result = repr(integer_array([1, None]))
+    assert 'NaN' in result
+
+
 def test_repr_array_long(data):
     # some arrays may be able to assert a ... in the repr
     with pd.option_context('display.max_seq_items', 1):