acpt: add scenarios for Font.name

Steve Canny · Steve Canny · commit 234cc0f1f7ae · 2015-02-08T00:01:40.000-08:00
diff --git a/features/steps/test_files/txt-font-props.docx b/features/steps/test_files/txt-font-props.docx
diff --git a/features/steps/text.py b/features/steps/text.py
@@ -21,6 +21,16 @@
 
 # given ===================================================
 
+@given('a font having typeface name {name}')
+def given_a_font_having_typeface_name(context, name):
+    document = Document(test_docx('txt-font-props'))
+    style_name = {
+        'not specified': 'Normal',
+        'Avenir Black':  'Having Typeface',
+    }[name]
+    context.font = document.styles[style_name].font
+
+
 @given('a run')
 def given_a_run(context):
     document = Document()
@@ -148,6 +158,13 @@ def when_I_assign_mixed_text_to_the_text_property(context):
     context.run.text = 'abc\tdef\nghi\rjkl'
 
 
+@when('I assign {value} to font.name')
+def when_I_assign_value_to_font_name(context, value):
+    font = context.font
+    value = None if value == 'None' else value
+    font.name = 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]
@@ -180,6 +197,13 @@ def when_I_set_the_run_underline_to_value(context, underline_value):
 
 # then =====================================================
 
+@then('font.name is {value}')
+def then_font_name_is_value(context, value):
+    font = context.font
+    value = None if value == 'None' else value
+    assert font.name == value
+
+
 @then('it is a column break')
 def then_type_is_column_break(context):
     attrib = context.last_child.attrib
diff --git a/features/txt-font-props.feature b/features/txt-font-props.feature
@@ -1,7 +1,32 @@
-Feature: Query or apply boolean property to a run
-  In order to query or change a boolean display property of a word or phrase
+Feature: Get or set font properties
+  In order to customize the character formatting of text in a document
   As a python-docx developer
-  I need a way to query and set the boolean properties on a run
+  I need a set of read/write properties on the Font object
+
+
+  @wip
+  Scenario Outline: Get typeface name
+    Given a font having typeface name <name>
+     Then font.name is <value>
+
+    Examples: font.name values
+      | name          | value        |
+      | not specified | None         |
+      | Avenir Black  | Avenir Black |
+
+
+  @wip
+  Scenario Outline: Set typeface name
+    Given a font having typeface name <name>
+     When I assign <value> to font.name
+     Then font.name is <value>
+
+    Examples: font.name values
+      | name          | value        |
+      | not specified | Avenir Black |
+      | Avenir Black  | Calibri      |
+      | Avenir Black  | None         |
+
 
   Scenario Outline: Apply boolean property to a run
     Given a run
@@ -31,6 +56,7 @@ Feature: Query or apply boolean property to a run
       | strike            |
       | web_hidden        |
 
+
   Scenario Outline: Set <boolean_prop_name> off unconditionally
     Given a run
      When I assign False to its <boolean_prop_name> property
@@ -59,6 +85,7 @@ Feature: Query or apply boolean property to a run
       | strike            |
       | web_hidden        |
 
+
   Scenario Outline: Remove boolean property from a run
     Given a run having <boolean_prop_name> set on
      When I assign None to its <boolean_prop_name> property
