acpt: add run-bold-italic.feature

Steve Canny · Steve Canny · commit 8f6ba19e79e2 · 2014-01-04T05:48:25.000-08:00
diff --git a/docx/text.py b/docx/text.py
@@ -89,6 +89,17 @@ def add_text(self, text):
         t = self._r.add_t(text)
         return Text(t)
 
+    @property
+    def bold(self):
+        """
+        Read/write. The bold setting for this run, one of |True|, |False|, or
+        |None|. When |True|, the run will appear in bold unconditionally.
+        When |False| it will appear without bold unconditionally. When
+        |None|, the run will inherit its bold setting from its style
+        hierarchy.
+        """
+        raise NotImplementedError
+
     @property
     def text(self):
         """
diff --git a/features/run-bold-italic.feature b/features/run-bold-italic.feature
@@ -0,0 +1,22 @@
+Feature: Apply bold or italic to run
+  In order to apply emphasis to a particular word or phrase in a paragraph
+  As a python-docx developer
+  I need a way to query and set bold and italic on a run
+
+  @wip
+  Scenario: Apply bold to a run
+    Given a run
+     When I assign True to its bold property
+     Then the run appears in bold typeface
+
+  @wip
+  Scenario: Remove bold from a run
+    Given a run having bold set on
+     When I assign None to its bold property
+     Then the run appears with its inherited bold setting
+
+  @wip
+  Scenario: Set bold off unconditionally
+    Given a run
+     When I assign False to its bold property
+     Then the run appears without bold regardless of its style hierarchy
diff --git a/features/steps/text.py b/features/steps/text.py
@@ -21,6 +21,13 @@ def given_a_run(context):
     context.run = p.add_run()
 
 
+@given('a run having bold set on')
+def given_a_run_having_bold_set_on(context):
+    run = Document().add_paragraph().add_run()
+    run.bold = True
+    context.run = run
+
+
 # when ====================================================
 
 @when('I add a column break')
@@ -41,6 +48,13 @@ def when_add_page_break(context):
     run.add_break(WD_BREAK.PAGE)
 
 
+@when('I assign {value_str} to its bold property')
+def when_assign_true_to_its_bold_property(context, value_str):
+    value = {'True': True, 'False': False, 'None': None}[value_str]
+    run = context.run
+    run.bold = value
+
+
 # then =====================================================
 
 @then('it is a column break')
@@ -69,3 +83,21 @@ def then_last_item_in_run_is_a_break(context):
         '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}br'
     )
     assert context.last_child.tag == expected_tag
+
+
+@then('the run appears in bold typeface')
+def then_run_appears_in_bold_typeface(context):
+    run = context.run
+    assert run.bold is True
+
+
+@then('the run appears with its inherited bold setting')
+def then_run_appears_with_its_inherited_bold_setting(context):
+    run = context.run
+    assert run.bold is None
+
+
+@then('the run appears without bold regardless of its style hierarchy')
+def then_run_appears_without_bold_regardless(context):
+    run = context.run
+    assert run.bold is False
