text: add Paragraph.runs

Steve Canny · Steve Canny · commit dc8295b5a6c8 · 2013-12-20T20:10:44.000-08:00
diff --git a/docx/text.py b/docx/text.py
@@ -27,6 +27,14 @@ def add_run(self):
         r = self._p.add_r()
         return Run(r)
 
+    @property
+    def runs(self):
+        """
+        Sequence of |Run| instances corresponding to the <w:r> elements in
+        this paragraph.
+        """
+        return tuple([Run(r) for r in self._p.r_elms])
+
 
 class Run(object):
     """
diff --git a/tests/test_text.py b/tests/test_text.py
@@ -14,7 +14,7 @@
 
 import pytest
 
-from mock import create_autospec, Mock
+from mock import call, create_autospec, Mock
 
 from .unitutil import class_mock
 
@@ -25,6 +25,19 @@ class DescribeParagraph(object):
     def Run_(self, request):
         return class_mock('docx.text.Run', request)
 
+    def it_has_a_sequence_of_the_runs_it_contains(self, Run_):
+        p_elm = Mock(name='p_elm')
+        r1, r2 = (Mock(name='r1'), Mock(name='r2'))
+        R1, R2 = (Mock(name='Run1'), Mock(name='Run2'))
+        p_elm.r_elms = [r1, r2]
+        p = Paragraph(p_elm)
+        Run_.side_effect = [R1, R2]
+        # exercise ---------------------
+        runs = p.runs
+        # verify -----------------------
+        assert Run_.mock_calls == [call(r1), call(r2)]
+        assert runs == (R1, R2)
+
     def it_can_add_a_run_to_itself(self, Run_):
         # mockery ----------------------
         p_elm = create_autospec(CT_P)
