Allow retrieval of 'raw' headers.

Author: Lukasa

hyper/common/headers.py

@@ -146,6 +146,16 @@ def get(self, name, default=None):
         except KeyError:
             return default
 
+    def iter_raw(self):
+        """
+        Allows iterating over the headers in 'raw' form: that is, the form in
+        which they were added to the structure. This iteration is in order,
+        and can be used to rebuild the original headers (e.g. to determine
+        exactly what a server sent).
+        """
+        for item in self._items:
+            yield item
+
     def __eq__(self, other):
         return self._items == other._items
 

test/test_headers.py

@@ -203,3 +203,13 @@ def test_create_from_iterables_and_kwargs(self):
             h == items + [('k3', 'v4'), ('k4', 'v5')] or
             h == items + [('k4', 'v5'), ('k3', 'v4')]
         )
+
+    def test_raw_iteration(self):
+        items = [
+            ('k1', 'v2'),
+            ('k2', 'v2, v3, v4'),
+            ('k2', 'v3'),
+        ]
+        h = HTTPHeaderMap(items)
+
+        assert list(h.iter_raw()) == items