acpt: add api-add-page-break.feature

Steve Canny · Steve Canny · commit ec057f357256 · 2014-01-03T23:39:55.000-08:00
diff --git a/docx/text.py b/docx/text.py
@@ -60,9 +60,9 @@ class Run(object):
     """
     Proxy object wrapping ``<w:r>`` element.
     """
-    def __init__(self, r_elm):
+    def __init__(self, r):
         super(Run, self).__init__()
-        self._r = r_elm
+        self._r = r
 
     def add_break(self, break_type=WD_BREAK.LINE):
         """
diff --git a/features/api-add-page-break.feature b/features/api-add-page-break.feature
@@ -0,0 +1,10 @@
+Feature: Add a page break
+  In order to force a page break at a particular location
+  As a programmer using the basic python-docx API
+  I need a method that adds a hard page break on its own paragraph
+
+  @wip
+  Scenario: Add a hard page break paragraph
+    Given a document
+     When I add a page break to the document
+     Then the last paragraph contains only a page break
diff --git a/features/steps/api.py b/features/steps/api.py
@@ -27,6 +27,12 @@ def when_add_heading_specifying_only_its_text(context):
     document.add_heading(context.heading_text)
 
 
+@when('I add a page break to the document')
+def when_add_page_break_to_document(context):
+    document = context.document
+    document.add_page_break()
+
+
 @when('I add a paragraph specifying its style')
 def when_add_paragraph_specifying_style(context):
     document = context.document
@@ -80,6 +86,15 @@ def when_add_picture_specifying_only_image_file(context):
 
 # then =====================================================
 
+@then('the last paragraph contains only a page break')
+def then_last_paragraph_contains_only_a_page_break(context):
+    document = context.document
+    p = document.paragraphs[-1]
+    assert len(p.runs) == 1
+    assert len(p.runs[0]) == 1
+    assert p.runs[0]._r[0].type == 'page'
+
+
 @then('the last paragraph contains the heading text')
 def then_last_p_contains_heading_text(context):
     document = context.document
