acpt: add par-add-run.feature

Victor Volle · Steve Canny · commit a80f0e35c989 · 2014-05-06T23:37:11.000-07:00
Retroactively added an acceptance test for Paragraph.add_run(). Made
some stylistic updates to naming in steps along the way.
diff --git a/features/par-add-run.feature b/features/par-add-run.feature
@@ -0,0 +1,15 @@
+Feature: Add a run with optional text and style
+  In order to add distinctively formatted text to a paragraph
+  As a python-docx programmer
+  I want a way to add a styled run of text in a single step
+
+  Scenario: Add a run specifying its text
+    Given a paragraph
+     When I add a run specifying its text
+     Then the run contains the text I specified
+
+  @wip
+  Scenario: Add a run specifying its style
+    Given a paragraph
+     When I add a run specifying the character style Emphasis
+     Then the style of the run is Emphasis
diff --git a/features/steps/block.py b/features/steps/block.py
@@ -23,7 +23,7 @@ def given_a_document_containing_a_table(context):
 @given('a paragraph')
 def given_a_paragraph(context):
     context.document = Document()
-    context.p = context.document.add_paragraph()
+    context.paragraph = context.document.add_paragraph()
 
 
 # when ====================================================
diff --git a/features/steps/paragraph.py b/features/steps/paragraph.py
@@ -10,31 +10,32 @@
 
 from helpers import saved_docx_path, test_text
 
-test_style = 'Heading1'
+
+TEST_STYLE = 'Heading1'
 
 
 # when ====================================================
 
 @when('I add a run to the paragraph')
-def step_when_add_new_run_to_paragraph(context):
+def when_add_new_run_to_paragraph(context):
     context.r = context.p.add_run()
 
 
 @when('I add text to the run')
-def step_when_add_new_text_to_run(context):
+def when_add_new_text_to_run(context):
     context.r.add_text(test_text)
 
 
 @when('I set the paragraph style')
-def step_when_set_paragraph_style(context):
-    context.p.add_run().add_text(test_text)
-    context.p.style = test_style
+def when_I_set_the_paragraph_style(context):
+    context.paragraph.add_run().add_text(test_text)
+    context.paragraph.style = TEST_STYLE
 
 
 # then =====================================================
 
 @then('the document contains the text I added')
-def step_then_document_contains_text_I_added(context):
+def then_document_contains_text_I_added(context):
     document = Document(saved_docx_path)
     paragraphs = document.paragraphs
     p = paragraphs[-1]
@@ -43,8 +44,6 @@ def step_then_document_contains_text_I_added(context):
 
 
 @then('the paragraph has the style I set')
-def step_then_paragraph_has_the_style_I_set(context):
-    document = Document(saved_docx_path)
-    paragraphs = document.paragraphs
-    p = paragraphs[-1]
-    assert p.style == test_style
+def then_the_paragraph_has_the_style_I_set(context):
+    paragraph = Document(saved_docx_path).paragraphs[-1]
+    assert paragraph.style == TEST_STYLE
diff --git a/features/steps/text.py b/features/steps/text.py
@@ -12,7 +12,7 @@
 from docx.enum.text import WD_BREAK
 from docx.oxml.shared import qn
 
-from .helpers import test_docx
+from .helpers import test_docx, test_text
 
 
 # given ===================================================
@@ -59,6 +59,16 @@ def when_add_page_break(context):
     run.add_break(WD_BREAK.PAGE)
 
 
+@when('I add a run specifying its text')
+def when_I_add_a_run_specifying_its_text(context):
+    context.run = context.paragraph.add_run(test_text)
+
+
+@when('I add a run specifying the character style Emphasis')
+def when_I_add_a_run_specifying_the_character_style_Emphasis(context):
+    context.run = context.paragraph.add_run(test_text, 'Emphasis')
+
+
 @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]
@@ -122,6 +132,11 @@ def then_run_appears_without_bool_prop(context, boolean_prop_name):
     assert getattr(run, boolean_prop_name) is False
 
 
+@then('the run contains the text I specified')
+def then_the_run_contains_the_text_I_specified(context):
+    assert context.run.text == test_text
+
+
 @then('the style of the run is {char_style}')
 def then_the_style_of_the_run_is_char_style(context, char_style):
     expected_value = {
