ENH: added .items to Series and DataFrame for both PY2 and PY3

Closes: #13918

Author: lewisacidic

doc/source/whatsnew/v0.17.1.txt

@@ -121,6 +121,7 @@ API changes
   result in ``NaT`` and not ``nan`` (:issue:`11245`).
 - Indexing with a null key will raise a ``TypeError``, instead of a ``ValueError`` (:issue:`11356`)
 - ``Series.ptp`` will now ignore missing values by default (:issue:`11163`)
+- ``Series`` and ``DataFrame`` have gained the .items() method to mirror .iteritems() and for compat with PY3 (:issue:`13918`)
 
 .. _whatsnew_0171.deprecations:
 

pandas/core/frame.py

@@ -761,8 +761,7 @@ def itertuples(self, index=True, name="Pandas"):
         # fallback to regular tuples
         return zip(*arrays)
 
-    if compat.PY3:  # pragma: no cover
-        items = iteritems
+    items = iteritems
 
     def __len__(self):
         """Returns length of info axis, but here we use the index """

pandas/core/series.py

@@ -1096,8 +1096,7 @@ def iteritems(self):
         """
         return zip(iter(self.index), iter(self))
 
-    if compat.PY3:  # pragma: no cover
-        items = iteritems
+    items = iteritems
 
     # ----------------------------------------------------------------------
     # Misc public methods

pandas/tests/frame/test_misc_api.py

@@ -241,6 +241,12 @@ def test_iteritems(self):
         for k, v in compat.iteritems(df):
             self.assertEqual(type(v), Series)
 
+    def test_items(self):
+        # items is the same as iteritems (#13918)
+        df = DataFrame([[1, 2, 3], [4, 5, 6]], columns=['a', 'a', 'b'])
+        for k, v in df.items():
+            self.assertEqual(type(v), Series)
+
     def test_iter(self):
         self.assertTrue(tm.equalContents(list(self.frame), self.frame.columns))
 

pandas/tests/series/test_misc_api.py

@@ -218,6 +218,16 @@ def test_iteritems(self):
         # assert is lazy (genrators don't define reverse, lists do)
         self.assertFalse(hasattr(self.series.iteritems(), 'reverse'))
 
+    def test_items(self):
+        # items is the same as iteritems (#13918)
+        for idx, val in self.series.items():
+            self.assertEqual(val, self.series[idx])
+
+        for idx, val in self.ts.items():
+            self.assertEqual(val, self.ts[idx])
+
+        self.assertFalse(hasattr(self.series.items(), 'reverse'))
+
     def test_raise_on_info(self):
         s = Series(np.random.randn(10))
         with tm.assertRaises(AttributeError):