acpt: add par-clear-paragraph.feature

Steve Canny · Steve Canny · commit 4ecf198592a2 · 2014-06-26T16:23:51.000-07:00
With scenario for Paragraph.clear()
diff --git a/features/par-clear-paragraph.feature b/features/par-clear-paragraph.feature
@@ -0,0 +1,12 @@
+Feature: Clear paragraph content
+  In order to change paragraph content while retaining its formatting
+  As a developer using python-docx
+  I need a way to remove the content of a paragraph
+
+
+  @wip
+  Scenario: Clear paragraph content
+    Given a paragraph with content and formatting
+     When I clear the paragraph content
+     Then the paragraph has no content
+      But the paragraph formatting is preserved
diff --git a/features/steps/paragraph.py b/features/steps/paragraph.py
@@ -7,6 +7,9 @@
 from behave import given, then, when
 
 from docx import Document
+from docx.oxml import parse_xml
+from docx.oxml.ns import nsdecls
+from docx.text import Paragraph
 
 from helpers import saved_docx_path, test_text
 
@@ -25,6 +28,21 @@ def given_a_document_containing_three_paragraphs(context):
     context.document = document
 
 
+@given('a paragraph with content and formatting')
+def given_a_paragraph_with_content_and_formatting(context):
+    p_xml = """\
+        <w:p %s>
+          <w:pPr>
+            <w:pStyle w:val="%s"/>
+          </w:pPr>
+          <w:r>
+            <w:t>foobar</w:t>
+          </w:r>
+        </w:p>""" % (nsdecls('w'), TEST_STYLE)
+    p = parse_xml(p_xml)
+    context.paragraph = Paragraph(p)
+
+
 # when ====================================================
 
 @when('I add a run to the paragraph')
@@ -33,10 +51,15 @@ def when_add_new_run_to_paragraph(context):
 
 
 @when('I add text to the run')
-def when_add_new_text_to_run(context):
+def when_I_add_text_to_the_run(context):
     context.r.add_text(test_text)
 
 
+@when('I clear the paragraph content')
+def when_I_clear_the_paragraph_content(context):
+    context.paragraph.clear()
+
+
 @when('I insert a paragraph above the second paragraph')
 def when_I_insert_a_paragraph_above_the_second_paragraph(context):
     paragraph = context.document.paragraphs[1]
@@ -65,6 +88,16 @@ def then_document_contains_text_I_added(context):
     assert r.text == test_text
 
 
+@then('the paragraph formatting is preserved')
+def then_the_paragraph_formatting_is_preserved(context):
+    assert context.paragraph.style == TEST_STYLE
+
+
+@then('the paragraph has no content')
+def then_the_paragraph_has_no_content(context):
+    assert context.paragraph.text == ''
+
+
 @then('the paragraph has the style I set')
 def then_the_paragraph_has_the_style_I_set(context):
     paragraph = Document(saved_docx_path).paragraphs[-1]
