acpt: add run-clear-run.feature

Steve Canny · Steve Canny · commit 9c864625c658 · 2014-06-24T23:59:35.000-07:00
Scenario for Run.clear() API method.
diff --git a/features/run-clear-run.feature b/features/run-clear-run.feature
@@ -0,0 +1,12 @@
+Feature: Remove the content of a run
+  In order to edit the content of a run while preserving its formatting
+  As a developer using python-docx
+  I need a way to clear the content of a run
+
+
+  @wip
+  Scenario: Clear run content
+    Given a run having known text and formatting
+     When I clear the run
+     Then the run contains no text
+      But the run formatting is preserved
diff --git a/features/steps/text.py b/features/steps/text.py
@@ -30,6 +30,14 @@ def given_a_run_having_bool_prop_set_on(context, bool_prop_name):
     context.run = run
 
 
+@given('a run having known text and formatting')
+def given_a_run_having_known_text_and_formatting(context):
+    run = Document().add_paragraph().add_run('foobar')
+    run.bold = True
+    run.italic = True
+    context.run = run
+
+
 @given('a run having {underline_type} underline')
 def given_a_run_having_underline_type(context, underline_type):
     run_idx = {
@@ -85,6 +93,11 @@ def when_assign_true_to_bool_run_prop(context, value_str, bool_prop_name):
     setattr(run, bool_prop_name, value)
 
 
+@when('I clear the run')
+def when_I_clear_the_run(context):
+    context.run.clear()
+
+
 @when('I set the character style of the run to {char_style}')
 def when_I_set_the_character_style_of_the_run(context, char_style):
     style_value = {
@@ -151,11 +164,22 @@ def then_run_appears_without_bool_prop(context, boolean_prop_name):
     assert getattr(run, boolean_prop_name) is False
 
 
+@then('the run contains no text')
+def then_the_run_contains_no_text(context):
+    assert context.run.text == ''
+
+
 @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 run formatting is preserved')
+def then_the_run_formatting_is_preserved(context):
+    assert context.run.bold is True
+    assert context.run.italic is True
+
+
 @then('the run underline property value is {underline_value}')
 def then_the_run_underline_property_value_is(context, underline_value):
     expected_value = {
