acpt: add scenarios for XxxStyle.font

Steve Canny · Steve Canny · commit 32efba5ef32c · 2015-02-08T00:01:40.000-08:00
diff --git a/docx/text/run.py b/docx/text/run.py
@@ -7,7 +7,7 @@
 from __future__ import absolute_import, print_function, unicode_literals
 
 from ..enum.text import WD_BREAK
-from ..shared import Parented
+from ..shared import ElementProxy, Parented
 
 
 def boolproperty(f):
@@ -372,6 +372,16 @@ def web_hidden(self):
         return 'webHidden'
 
 
+class Font(ElementProxy):
+    """
+    Proxy object wrapping the parent of a ``<w:rPr>`` element and providing
+    access to character properties such as font name, font size, bold, and
+    subscript.
+    """
+
+    __slots__ = ()
+
+
 class _Text(object):
     """
     Proxy object wrapping ``<w:t>`` element.
diff --git a/features/steps/styles.py b/features/steps/styles.py
@@ -10,6 +10,7 @@
 from docx.enum.style import WD_STYLE_TYPE
 from docx.styles.styles import Styles
 from docx.styles.style import BaseStyle
+from docx.text.run import Font
 
 from helpers import test_docx
 
@@ -67,6 +68,18 @@ def given_a_style_having_a_known_attr_name(context, attr_name):
     context.style = document.styles['Normal']
 
 
+@given('a style of type {style_type}')
+def given_a_style_of_type(context, style_type):
+    document = Document(test_docx('sty-known-styles'))
+    name = {
+        'WD_STYLE_TYPE.CHARACTER': 'Default Paragraph Font',
+        'WD_STYLE_TYPE.LIST':      'No List',
+        'WD_STYLE_TYPE.PARAGRAPH': 'Normal',
+        'WD_STYLE_TYPE.TABLE':     'Normal Table',
+    }[style_type]
+    context.style = document.styles[name]
+
+
 # when =====================================================
 
 @when('I assign a new name to the style')
@@ -155,6 +168,14 @@ def then_style_builtin_is_builtin(context, builtin_str):
     assert style.builtin == builtin
 
 
+@then('style.font is the Font object for the style')
+def then_style_font_is_the_Font_object_for_the_style(context):
+    style = context.style
+    font = style.font
+    assert isinstance(font, Font)
+    assert font.element is style.element
+
+
 @then('style.name is the {which} name')
 def then_style_name_is_the_which_name(context, which):
     expected_name = {
diff --git a/features/sty-access-font.feature b/features/sty-access-font.feature
@@ -0,0 +1,16 @@
+Feature: Access style font
+  In order to discover or change the character formatting of a style
+  As a developer using python-docx
+  I need access to the font of a style
+
+
+  @wip
+  Scenario Outline: Get style font
+    Given a style of type <style-type>
+     Then style.font is the Font object for the style
+
+    Examples: Style types
+      | style-type              |
+      | WD_STYLE_TYPE.CHARACTER |
+      | WD_STYLE_TYPE.PARAGRAPH |
+      | WD_STYLE_TYPE.TABLE     |
