acpt: add run-char-style.feature

Victor Volle · Steve Canny · commit 520d90f03d86 · 2014-05-05T21:22:29.000-07:00
Acceptance tests for character style support, implemented as the
read/write Run.style property.
diff --git a/docx/text.py b/docx/text.py
@@ -300,6 +300,14 @@ def strike(self):
         """
         return 'strike'
 
+    @property
+    def style(self):
+        """
+        The string name of the character style applied to this run, or |None|
+        if it has no directly-applied character style.
+        """
+        raise NotImplementedError
+
     @property
     def text(self):
         """
diff --git a/features/run-char-style.feature b/features/run-char-style.feature
@@ -0,0 +1,31 @@
+Feature: Each run has a read/write style
+  In order to use the stylesheet capability built into Word
+  As an python-docx developer
+  I need the ability to get and set the character style of a run
+
+
+  @wip
+  Scenario Outline: Get the character style of a run
+    Given a run having style <char style>
+     Then the style of the run is <char style>
+
+    Examples: Character styles
+      | char style |
+      | None       |
+      | Emphasis   |
+      | Strong     |
+
+
+  @wip
+  Scenario Outline: Set the style of a run
+    Given a run having style <char style>
+     When I set the character style of the run to <new char style>
+     Then the style of the run is <new char style>
+
+    Examples: Character style transitions
+      | char style | new char style |
+      | None       | None           |
+      | None       | Emphasis       |
+      | Emphasis   | None           |
+      | Emphasis   | Emphasis       |
+      | Emphasis   | Strong         |
diff --git a/features/steps/test_files/run-char-style.docx b/features/steps/test_files/run-char-style.docx
diff --git a/features/steps/text.py b/features/steps/text.py
@@ -12,6 +12,8 @@
 from docx.enum.text import WD_BREAK
 from docx.oxml.shared import qn
 
+from .helpers import test_docx
+
 
 # given ===================================================
 
@@ -28,6 +30,15 @@ def given_a_run_having_bool_prop_set_on(context, bool_prop_name):
     context.run = run
 
 
+@given('a run having style {char_style}')
+def given_a_run_having_style_char_style(context, char_style):
+    run_idx = {
+        'None': 0, 'Emphasis': 1, 'Strong': 2
+    }[char_style]
+    document = Document(test_docx('run-char-style'))
+    context.run = document.paragraphs[0].runs[run_idx]
+
+
 # when ====================================================
 
 @when('I add a column break')
@@ -55,6 +66,14 @@ def when_assign_true_to_bool_run_prop(context, value_str, bool_prop_name):
     setattr(run, bool_prop_name, value)
 
 
+@when('I set the character style of the run to {char_style}')
+def when_I_set_the_character_style_of_the_run(context, char_style):
+    style_value = {
+        'None': None, 'Emphasis': 'Emphasis', 'Strong': 'Strong'
+    }[char_style]
+    context.run.style = style_value
+
+
 # then =====================================================
 
 @then('it is a column break')
@@ -101,3 +120,11 @@ def then_run_inherits_bool_prop_value(context, boolean_prop_name):
 def then_run_appears_without_bool_prop(context, boolean_prop_name):
     run = context.run
     assert getattr(run, boolean_prop_name) is False
+
+
+@then('the style of the run is {char_style}')
+def then_the_style_of_the_run_is_char_style(context, char_style):
+    expected_value = {
+        'None': None, 'Emphasis': 'Emphasis', 'Strong': 'Strong'
+    }[char_style]
+    assert context.run.style == expected_value
