acpt: add scenarios for Cell.width

Steve Canny · Steve Canny · commit ef4d4ee35787 · 2014-07-13T17:00:36.000-07:00
diff --git a/docx/table.py b/docx/table.py
@@ -121,6 +121,12 @@ def text(self, text):
         r = p.add_r()
         r.text = text
 
+    @property
+    def width(self):
+        """
+        The width of this cell in EMU, or |None| if no explicit width is set.
+        """
+
 
 class _Column(Parented):
     """
diff --git a/features/steps/table.py b/features/steps/table.py
@@ -9,6 +9,7 @@
 from behave import given, then, when
 
 from docx import Document
+from docx.shared import Inches
 from docx.table import (
     _Cell, _Column, _ColumnCells, _Columns, _Row, _RowCells, _Rows
 )
@@ -56,6 +57,15 @@ def given_a_table(context):
     context.table_ = Document().add_table(rows=2, cols=2)
 
 
+@given('a table cell having a width of {width}')
+def given_a_table_cell_having_a_width_of_width(context, width):
+    table_idx = {'no explicit setting': 0, '1 inch': 1, '2 inches': 2}[width]
+    document = Document(test_docx('tbl-props'))
+    table = document.tables[table_idx]
+    cell = table.cell(0, 0)
+    context.cell = cell
+
+
 @given('a table column having a width of {width_desc}')
 def given_a_table_having_a_width_of_width_desc(context, width_desc):
     col_idx = {
@@ -135,6 +145,12 @@ def when_apply_style_to_table(context):
     table.style = 'LightShading-Accent1'
 
 
+@when('I set the cell width to {width}')
+def when_I_set_the_cell_width_to_width(context, width):
+    new_value = {'1 inch': Inches(1)}[width]
+    context.cell.width = new_value
+
+
 @when('I set the column width to {width_emu}')
 def when_I_set_the_column_width_to_width_emu(context, width_emu):
     new_value = None if width_emu == 'None' else int(width_emu)
@@ -317,6 +333,15 @@ def then_the_reported_column_width_is_width_emu(context, width_emu):
     )
 
 
+@then('the reported width of the cell is {width}')
+def then_the_reported_width_of_the_cell_is_width(context, width):
+    expected_width = {'None': None, '1 inch': Inches(1)}[width]
+    actual_width = context.cell.width
+    assert actual_width == expected_width, (
+        'expected %s, got %s' % (expected_width, actual_width)
+    )
+
+
 @then('the table style matches the name I applied')
 def then_table_style_matches_name_applied(context):
     table = context.table_
diff --git a/features/steps/test_files/tbl-props.docx b/features/steps/test_files/tbl-props.docx
diff --git a/features/tbl-cell-props.feature b/features/tbl-cell-props.feature
@@ -0,0 +1,27 @@
+Feature: Get and set table cell properties
+  In order to format a table cell to my requirements
+  As an python-docx developer
+  I need a way to get and set the properties of a table cell
+
+
+  @wip
+  Scenario Outline: Get cell width
+    Given a table cell having a width of <width-setting>
+     Then the reported width of the cell is <reported-width>
+
+    Examples: Table cell width settings
+      | width-setting       | reported-width |
+      | no explicit setting | None           |
+      | 1 inch              | 1 inch         |
+
+
+  @wip
+  Scenario Outline: Set cell width
+    Given a table cell having a width of <width-setting>
+     When I set the cell width to <new-setting>
+     Then the reported width of the cell is <reported-width>
+
+    Examples: table column width values
+      | width-setting       | new-setting | reported-width |
+      | no explicit setting | 1 inch      | 1 inch         |
+      | 2 inches            | 1 inch      | 1 inch         |
