acpt: add scenarios for ParagraphFormat.alignment

Steve Canny · Steve Canny · commit 2be2c920b3dd · 2015-02-08T00:01:42.000-08:00
diff --git a/features/steps/test_files/sty-known-styles.docx b/features/steps/test_files/sty-known-styles.docx
diff --git a/features/steps/text.py b/features/steps/text.py
@@ -11,7 +11,7 @@
 from behave import given, then, when
 
 from docx import Document
-from docx.enum.text import WD_BREAK, WD_UNDERLINE
+from docx.enum.text import WD_ALIGN_PARAGRAPH, WD_BREAK, WD_UNDERLINE
 from docx.oxml import parse_xml
 from docx.oxml.ns import nsdecls, qn
 from docx.text.run import Font, Run
@@ -65,6 +65,17 @@ def given_a_font_of_size(context, size):
     context.font = document.styles[style_name].font
 
 
+@given('a paragraph format having {type} alignment')
+def given_a_paragraph_format_having_align_type_alignment(context, type):
+    style_name = {
+        'inherited': 'Normal',
+        'center':    'Base',
+        'right':     'Citation',
+    }[type]
+    document = Document(test_docx('sty-known-styles'))
+    context.paragraph_format = document.styles[style_name].paragraph_format
+
+
 @given('a run')
 def given_a_run(context):
     document = Document()
@@ -235,6 +246,17 @@ def when_I_assign_value_to_font_sub_super(context, value_key, sub_super):
     setattr(font, name, value)
 
 
+@when('I assign {value_key} to paragraph_format.alignment')
+def when_I_assign_value_to_paragraph_format_alignment(context, value_key):
+    value = {
+        'None':                      None,
+        'WD_ALIGN_PARAGRAPH.CENTER': WD_ALIGN_PARAGRAPH.CENTER,
+        'WD_ALIGN_PARAGRAPH.RIGHT':  WD_ALIGN_PARAGRAPH.RIGHT,
+    }[value_key]
+    paragraph_format = context.paragraph_format
+    paragraph_format.alignment = value
+
+
 @when('I assign {value_str} to its {bool_prop_name} property')
 def when_assign_true_to_bool_run_prop(context, value_str, bool_prop_name):
     value = {'True': True, 'False': False, 'None': None}[value_str]
@@ -327,6 +349,18 @@ def then_type_is_page_break(context):
     assert attrib == {qn('w:type'): 'page'}
 
 
+@then('paragraph_format.alignment is {value_key}')
+def then_paragraph_format_alignment_is_value(context, value_key):
+    value = {
+        'None':                      None,
+        'WD_ALIGN_PARAGRAPH.LEFT':   WD_ALIGN_PARAGRAPH.LEFT,
+        'WD_ALIGN_PARAGRAPH.CENTER': WD_ALIGN_PARAGRAPH.CENTER,
+        'WD_ALIGN_PARAGRAPH.RIGHT':  WD_ALIGN_PARAGRAPH.RIGHT,
+    }[value_key]
+    paragraph_format = context.paragraph_format
+    assert paragraph_format.alignment == value
+
+
 @then('run.font is the Font object for the run')
 def then_run_font_is_the_Font_object_for_the_run(context):
     run, font = context.run, context.run.font
diff --git a/features/txt-parfmt-props.feature b/features/txt-parfmt-props.feature
@@ -0,0 +1,29 @@
+Feature: Get or set paragraph formatting properties
+  In order to customize the formatting of paragraphs in a document
+  As a python-docx developer
+  I need a ParagraphFormat object with read/write formatting properties
+
+
+  @wip
+  Scenario Outline: Get paragraph alignment
+    Given a paragraph format having <align-type> alignment
+     Then paragraph_format.alignment is <value>
+
+    Examples: paragraph_format.alignment values
+      | align-type | value                     |
+      | inherited  | None                      |
+      | center     | WD_ALIGN_PARAGRAPH.CENTER |
+      | right      | WD_ALIGN_PARAGRAPH.RIGHT  |
+
+
+  @wip
+  Scenario Outline: Set paragraph alignment
+    Given a paragraph format having <align-type> alignment
+     When I assign <new-value> to paragraph_format.alignment
+     Then paragraph_format.alignment is <value>
+
+    Examples: paragraph_format.alignment assignment results
+      | align-type | new-value                 | value                     |
+      | inherited  | WD_ALIGN_PARAGRAPH.CENTER | WD_ALIGN_PARAGRAPH.CENTER |
+      | center     | WD_ALIGN_PARAGRAPH.RIGHT  | WD_ALIGN_PARAGRAPH.RIGHT  |
+      | right      | None                      | None                      |
