acpt: elaborate Document.add_paragraph() scenario

Steve Canny · Steve Canny · commit d0968211f12b · 2015-02-08T00:01:14.000-08:00
Add case for specifying style as style object.
diff --git a/features/api-add-paragraph.feature b/features/api-add-paragraph.feature
@@ -3,17 +3,26 @@ Feature: Add a paragraph with optional text and style
   As a programmer using the basic python-docx API
   I want to add a styled paragraph of text in a single step
 
+
   Scenario: Add an empty paragraph
     Given a 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
      When I add a paragraph specifying its text
      Then the last paragraph contains the text I specified
 
-  Scenario: Add a paragraph specifying its style
+
+  @wip
+  Scenario Outline: Add a paragraph specifying its style
     Given a document
-     When I add a paragraph specifying its style
+     When I add a paragraph specifying its style as a <style-spec>
      Then the last paragraph has the style I specified
+
+    Examples: ways of specifying a style
+      | style-spec   |
+      | style object |
+      | style name   |
diff --git a/features/steps/api.py b/features/steps/api.py
@@ -46,11 +46,15 @@ def when_add_page_break_to_document(context):
     document.add_page_break()
 
 
-@when('I add a paragraph specifying its style')
-def when_add_paragraph_specifying_style(context):
+@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
-    context.paragraph_style = 'barfoo'
-    document.add_paragraph(style=context.paragraph_style)
+    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')
@@ -135,11 +139,10 @@ def then_last_p_contains_specified_text(context):
 
 
 @then('the last paragraph has the style I specified')
-def then_last_p_has_specified_style(context):
-    document = context.document
-    style = context.paragraph_style
-    p = document.paragraphs[-1]
-    assert p.style == style
+def then_the_last_paragraph_has_the_style_I_specified(context):
+    document, expected_style = context.document, context.style
+    paragraph = document.paragraphs[-1]
+    assert paragraph.style == expected_style
 
 
 @then('the last paragraph is the empty paragraph I added')
