acpt: add scenarios for Table.autofit get and set

Steve Canny · Steve Canny · commit 0528a7825d24 · 2014-07-13T14:22:36.000-07:00
diff --git a/docx/table.py b/docx/table.py
@@ -38,6 +38,15 @@ def add_row(self):
             tr.add_tc()
         return _Row(tr, self)
 
+    @property
+    def autofit(self):
+        """
+        |True| if column widths can be automatically adjusted to improve the
+        fit of cell contents. |False| if table layout is fixed. Column widths
+        are adjusted in either case if total column width exceeds page width.
+        Read/write boolean.
+        """
+
     def cell(self, row_idx, col_idx):
         """
         Return |_Cell| instance correponding to table cell at *row_idx*,
diff --git a/features/steps/table.py b/features/steps/table.py
@@ -74,6 +74,17 @@ def given_a_table_having_an_applied_style(context):
     context.table_ = document.tables[0]
 
 
+@given('a table having an autofit layout of {autofit}')
+def given_a_table_having_an_autofit_layout_of_autofit(context, autofit):
+    tbl_idx = {
+        'no explicit setting': 0,
+        'autofit':             1,
+        'fixed':               2,
+    }[autofit]
+    document = Document(test_docx('tbl-props'))
+    context.table_ = document.tables[tbl_idx]
+
+
 @given('a table having two columns')
 def given_a_table_having_two_columns(context):
     docx_path = test_docx('blk-containing-table')
@@ -130,6 +141,13 @@ def when_I_set_the_column_width_to_width_emu(context, width_emu):
     context.column.width = new_value
 
 
+@when('I set the table autofit to {setting}')
+def when_I_set_the_table_autofit_to_setting(context, setting):
+    new_value = {'autofit': True, 'fixed': False}[setting]
+    table = context.table_
+    table.autofit = new_value
+
+
 # then =====================================================
 
 @then('I can access a cell using its row and column indices')
@@ -284,6 +302,13 @@ def then_new_row_has_2_cells(context):
     assert len(context.row.cells) == 2
 
 
+@then('the reported autofit setting is {autofit}')
+def then_the_reported_autofit_setting_is_autofit(context, autofit):
+    expected_value = {'autofit': True, 'fixed': False}[autofit]
+    table = context.table_
+    assert table.autofit is expected_value
+
+
 @then('the reported column width is {width_emu}')
 def then_the_reported_column_width_is_width_emu(context, width_emu):
     expected_value = None if width_emu == 'None' else int(width_emu)
diff --git a/features/steps/test_files/tbl-props.docx b/features/steps/test_files/tbl-props.docx
diff --git a/features/tbl-props.feature b/features/tbl-props.feature
@@ -0,0 +1,32 @@
+Feature: Get and set table properties
+  In order to format a table to my requirements
+  As an python-docx developer
+  I need a way to get and set a table's properties
+
+
+  @wip
+  Scenario Outline: Get autofit layout setting
+    Given a table having an autofit layout of <autofit-setting>
+     Then the reported autofit setting is <reported-autofit>
+
+    Examples: table autofit settings
+      | autofit-setting     | reported-autofit |
+      | no explicit setting | autofit          |
+      | autofit             | autofit          |
+      | fixed               | fixed            |
+
+
+  @wip
+  Scenario Outline: Set autofit layout setting
+    Given a table having an autofit layout of <autofit-setting>
+     When I set the table autofit to <new-setting>
+     Then the reported autofit setting is <reported-autofit>
+
+    Examples: table column width values
+      | autofit-setting     | new-setting | reported-autofit |
+      | no explicit setting | autofit     | autofit          |
+      | no explicit setting | fixed       | fixed            |
+      | fixed               | autofit     | autofit          |
+      | autofit             | autofit     | autofit          |
+      | fixed               | fixed       | fixed            |
+      | autofit             | fixed       | fixed            |
