acpt: add api-add-paragraph.feature

Steve Canny · Steve Canny · commit 3ab7ad1b5ae9 · 2014-01-02T19:07:47.000-08:00
diff --git a/features/api-add-paragraph.feature b/features/api-add-paragraph.feature
@@ -0,0 +1,22 @@
+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
+
+  @wip
+  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
+
+  @wip
+  Scenario: Add a paragraph specifying its text
+    Given a document
+     When I add a paragraph spefifying its text
+     Then the last paragraph contains the text I specified
+
+  @wip
+  Scenario: Add a paragraph specifying its style
+    Given a document
+     When I add a paragraph spefifying its style
+     Then the style of the last paragraph is the style I specified
diff --git a/features/blk-add-paragraph.feature b/features/blk-add-paragraph.feature
@@ -1,12 +1,12 @@
 Feature: Add a paragraph of text
-  In order to add text to a document
+  In order to populate the text of a document
   As an python-docx developer
-  I need to add a paragraph
+  I need the ability to add a paragraph
 
-  Scenario: Add a paragraph
-     Given a document
-      When I add a paragraph
-       And I add a run to the paragraph
-       And I add text to the run
-       And I save the document
-      Then the document contains the text I added
+  Scenario: Add a paragraph using low-level text API
+    Given a document
+     When I add a paragraph
+      And I add a run to the paragraph
+      And I add text to the run
+      And I save the document
+     Then the document contains the text I added
diff --git a/features/steps/api.py b/features/steps/api.py
@@ -0,0 +1,24 @@
+# encoding: utf-8
+
+"""
+Step implementations for top-level features
+"""
+
+from behave import then, when
+
+
+# when ====================================================
+
+@when('I add a paragraph without specifying text or style')
+def step_when_add_paragraph_without_specifying_text_or_style(context):
+    document = context.document
+    document.add_paragraph()
+
+
+# then =====================================================
+
+@then('the last paragraph is the empty paragraph I added')
+def step_then_document_contains_text_I_added(context):
+    document = context.document
+    p = document.paragraphs[-1]
+    assert p.text == ''
