ENH: Provide dict object for to_dict() pandas-dev#16122

Author: dwkenefick

pandas/core/frame.py

@@ -894,14 +894,10 @@ def to_dict(self, orient='dict', into=dict):
         Returns
         -------
         result : collections.Mapping like {column -> {index -> value}}
-            If ``into`` is collections.defaultdict, the return
-            value's default_factory will be None.
 
         Examples
         --------
-        >>> from pandas import DataFrame
-        >>> from collections import OrderedDict, defaultdict
-        >>> df = DataFrame(
+        >>> df = pd.DataFrame(
                 {'col1': [1, 2], 'col2': [0.5, 0.75]}, index=['a', 'b'])
         >>> df
            col1  col2
@@ -928,7 +924,7 @@ def to_dict(self, orient='dict', into=dict):
         {'a': {'col1': 1.0, 'col2': 0.5}, 'b': {'col1': 2.0, 'col2': 0.75}}
 
         You can also specify the mapping type.
-
+        >>> from collections import OrderedDict, defaultdict
         >>> df.to_dict(into=OrderedDict)
         OrderedDict([('col1', OrderedDict([('a', 1), ('b', 2)])),
                    ('col2', OrderedDict([('a', 0.5), ('b', 0.75)]))])

pandas/core/series.py

@@ -1077,7 +1077,8 @@ def tolist(self):
 
     def to_dict(self, into=dict):
         """
-        Convert Series to {label -> value} dict or dict-like object
+        Convert Series to {label -> value} dict or dict-like object.
+
         Parameters
         ----------
         into : class, default dict
@@ -1096,11 +1097,10 @@ def to_dict(self, into=dict):
 
         Examples
         --------
-        >>> from pandas import Series
-        >>> from collections import OrderedDict, defaultdict
-        >>> s = Series([1, 2, 3, 4])
+        >>> s = pd.Series([1, 2, 3, 4])
         >>> s.to_dict()
         {0: 1, 1: 2, 2: 3, 3: 4}
+        >>> from collections import OrderedDict, defaultdict
         >>> s.to_dict(OrderedDict)
         OrderedDict([(0, 1), (1, 2), (2, 3), (3, 4)])
         >>> dd = defaultdict(list)