acpt: add scenarios for Run.text getter and setter

Steve Canny · Steve Canny · commit e3c2e2ba1a45 · 2014-06-25T21:54:13.000-07:00
Both handling text containing embedded \n, \t, and/or \r characters.
diff --git a/features/run-access-content.feature b/features/run-access-content.feature
@@ -0,0 +1,10 @@
+Feature: Access run content
+  In order to discover or locate existing inline content
+  As a developer using python-docx
+  I need ways to access the run content
+
+
+  @wip
+  Scenario: Get run content as Python text
+    Given a run having mixed text content
+     Then the text of the run represents the textual run content
diff --git a/features/run-add-content.feature b/features/run-add-content.feature
@@ -8,3 +8,10 @@ Feature: Add content to a run
     Given a run
      When I add a tab
      Then the tab appears at the end of the run
+
+
+  @wip
+  Scenario: Assign mixed text to text property
+    Given a run
+     When I assign mixed text to the text property
+     Then the text of the run represents the textual run content
diff --git a/features/steps/text.py b/features/steps/text.py
@@ -10,7 +10,9 @@
 
 from docx import Document
 from docx.enum.text import WD_BREAK, WD_UNDERLINE
-from docx.oxml.ns import qn
+from docx.oxml import parse_xml
+from docx.oxml.ns import nsdecls, qn
+from docx.text import Run
 
 from helpers import test_docx, test_text
 
@@ -38,6 +40,26 @@ def given_a_run_having_known_text_and_formatting(context):
     context.run = run
 
 
+@given('a run having mixed text content')
+def given_a_run_having_mixed_text_content(context):
+    """
+    Mixed here meaning it contains ``<w:tab/>``, ``<w:cr/>``, etc. elements.
+    """
+    r_xml = """\
+        <w:r %s>
+          <w:t>abc</w:t>
+          <w:tab/>
+          <w:t>def</w:t>
+          <w:cr/>
+          <w:t>ghi</w:t>
+          <w:drawing/>
+          <w:br/>
+          <w:t>jkl</w:t>
+        </w:r>""" % nsdecls('w')
+    r = parse_xml(r_xml)
+    context.run = Run(r)
+
+
 @given('a run having {underline_type} underline')
 def given_a_run_having_underline_type(context, underline_type):
     run_idx = {
@@ -91,6 +113,11 @@ def when_I_add_a_tab(context):
     context.run.add_tab()
 
 
+@when('I assign mixed text to the text property')
+def when_I_assign_mixed_text_to_the_text_property(context):
+    context.run.text = 'abc\tdef\nghi\rjkl'
+
+
 @when('I assign {value_str} to its {bool_prop_name} property')
 def when_assign_true_to_bool_run_prop(context, value_str, bool_prop_name):
     value = {'True': True, 'False': False, 'None': None}[value_str]
@@ -207,3 +234,10 @@ def then_the_tab_appears_at_the_end_of_the_run(context):
     r = context.run._r
     tab = r.find(qn('w:tab'))
     assert tab is not None
+
+
+@then('the text of the run represents the textual run content')
+def then_the_text_of_the_run_represents_the_textual_run_content(context):
+    assert context.run.text == 'abc\tdef\nghi\njkl', (
+        'got \'%s\'' % context.run.text
+    )
