acpt: migrate doc-add-paragraph.feature

Steve Canny · Steve Canny · commit be56d1db7e19 · 2015-02-14T16:36:57.000-08:00
diff --git a/features/doc-add-paragraph.feature b/features/doc-add-paragraph.feature
@@ -1,17 +1,17 @@
 Feature: Add a paragraph with optional text and style
   In order to populate the text of a document
-  As a programmer using the basic python-docx API
-  I want to add a styled paragraph of text in a single step
+  As a developer using python-docx
+  I need a way to add a styled paragraph of text in a single step
 
 
   Scenario: Add an empty paragraph
-    Given a document
+    Given a blank document
      When I add a paragraph without specifying text or style
      Then the last paragraph is the empty paragraph I added
 
 
   Scenario: Add a paragraph specifying its text
-    Given a document
+    Given a blank document
      When I add a paragraph specifying its text
      Then the last paragraph contains the text I specified
 
diff --git a/features/steps/api.py b/features/steps/api.py
@@ -56,30 +56,6 @@ def when_add_page_break_to_document(context):
     document.add_page_break()
 
 
-@when('I add a paragraph specifying its style as a {kind}')
-def when_I_add_a_paragraph_specifying_its_style_as_a(context, kind):
-    document = context.document
-    style = context.style = document.styles['Heading 1']
-    style_spec = {
-        'style object': style,
-        'style name':   'Heading 1',
-    }[kind]
-    document.add_paragraph(style=style_spec)
-
-
-@when('I add a paragraph specifying its text')
-def when_add_paragraph_specifying_text(context):
-    document = context.document
-    context.paragraph_text = 'foobar'
-    document.add_paragraph(context.paragraph_text)
-
-
-@when('I add a paragraph without specifying text or style')
-def when_add_paragraph_without_specifying_text_or_style(context):
-    document = context.document
-    document.add_paragraph()
-
-
 @when('I add a picture specifying 1.75" width and 2.5" height')
 def when_add_picture_specifying_width_and_height(context):
     document = context.document
diff --git a/features/steps/document.py b/features/steps/document.py
@@ -18,6 +18,11 @@
 
 # given ===================================================
 
+@given('a blank document')
+def given_a_blank_document(context):
+    context.document = Document()
+
+
 @given('a document having three sections')
 def given_a_document_having_three_sections(context):
     context.document = Document(test_docx('doc-access-sections'))
@@ -38,6 +43,30 @@ def given_a_single_section_document_having_portrait_layout(context):
 
 # when ====================================================
 
+@when('I add a paragraph specifying its style as a {kind}')
+def when_I_add_a_paragraph_specifying_its_style_as_a(context, kind):
+    document = context.document
+    style = context.style = document.styles['Heading 1']
+    style_spec = {
+        'style object': style,
+        'style name':   'Heading 1',
+    }[kind]
+    document.add_paragraph(style=style_spec)
+
+
+@when('I add a paragraph specifying its text')
+def when_add_paragraph_specifying_text(context):
+    document = context.document
+    context.paragraph_text = 'foobar'
+    document.add_paragraph(context.paragraph_text)
+
+
+@when('I add a paragraph without specifying text or style')
+def when_add_paragraph_without_specifying_text_or_style(context):
+    document = context.document
+    document.add_paragraph()
+
+
 @when('I add an even-page section to the document')
 def when_I_add_an_even_page_section_to_the_document(context):
     context.section = context.document.add_section(WD_SECTION.EVEN_PAGE)
