Ticket #8447: iterlists.diff

django/utils/datastructures.py

@@ -278 +278 @@
         """Returns a list of (key, list) pairs."""
         return super(MultiValueDict, self).items()
 
+    def iterlists(self):
+        """Yields (key, list) pairs."""
+        return super(MultiValueDict, self).iteritems()
+
     def values(self):
         """Returns a list of the last value on every key list."""
         return [self[key] for key in self.keys()]

tests/regressiontests/datastructures/tests.py

@@ -44 +44 @@
 ['Adrian', 'Simon']
 >>> list(d.iteritems())
 [('position', 'Developer'), ('name', 'Simon')]
+>>> list(d.iterlists())
+[('position', 'Developer'), ('name', ['Adrian', 'Simon'])]
 >>> d['lastname']
 Traceback (most recent call last):
 ...

docs/request_response.txt

@@ -278 +278 @@
            >>> q = QueryDict('a=1&a=2&a=3')
            >>> q.items()
            [('a', '3')]
+           
+    * ``iteritems()`` -- Just like the standard dictionary ``iteritems()``
+      method.  Like ``items()`` this uses the same last-value logic as
+      ``__getitem()__``.
 
     * ``values()`` -- Just like the standard dictionary ``values()`` method,
       except this uses the same last-value logic as ``__getitem()__``. For
@@ -312 +316 @@
            >>> q = QueryDict('a=1&a=2&a=3')
            >>> q.lists()
            [('a', ['1', '2', '3'])]
+           
+    * ''iterlists()'' -- Like ''iteritems()'', except it includes all values,
+      as a list, for each member of the dictionary.
 
     * ``urlencode()`` -- Returns a string of the data in query-string format.
       Example: ``"a=2&b=3&b=5"``.