acpt: add scenarios for _Cell.merge()

Author: Steve Canny

features/steps/table.py

@@ -4,7 +4,9 @@
 Step implementations for table-related features
 """
 
-from __future__ import absolute_import, print_function, unicode_literals
+from __future__ import (
+    absolute_import, division, print_function, unicode_literals
+)
 
 from behave import given, then, when
 
@@ -127,6 +129,17 @@ def when_apply_style_to_table(context):
     table.style = 'LightShading-Accent1'
 
 
+@when('I merge from cell {origin} to cell {other}')
+def when_I_merge_from_cell_origin_to_cell_other(context, origin, other):
+    def cell(table, idx):
+        row, col = idx // 3, idx % 3
+        return table.cell(row, col)
+    a_idx, b_idx = int(origin) - 1, int(other) - 1
+    table = context.table_
+    a, b = cell(table, a_idx), cell(table, b_idx)
+    a.merge(b)
+
+
 @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]
@@ -266,8 +279,9 @@ def then_the_reported_width_of_the_cell_is_width(context, width):
     )
 
 
-@then('the row cells text is {expected_text}')
-def then_the_row_cells_text_is_expected_text(context, expected_text):
+@then('the row cells text is {encoded_text}')
+def then_the_row_cells_text_is_expected_text(context, encoded_text):
+    expected_text = encoded_text.replace('\\', '\n')
     table = context.table_
     cells_text = ' '.join(c.text for row in table.rows for c in row.cells)
     assert cells_text == expected_text, 'got %s' % cells_text
@@ -292,3 +306,13 @@ def then_table_has_count_rows(context, count):
     row_count = int(count)
     rows = context.table_.rows
     assert len(rows) == row_count
+
+
+@then('the width of cell {n_str} is {inches_str} inches')
+def then_the_width_of_cell_n_is_x_inches(context, n_str, inches_str):
+    def _cell(table, idx):
+        row, col = idx // 3, idx % 3
+        return table.cell(row, col)
+    idx, inches = int(n_str) - 1, float(inches_str)
+    cell = _cell(context.table_, idx)
+    assert cell.width == Inches(inches), 'got %s' % cell.width.inches

features/tbl-merge-cells.feature

@@ -0,0 +1,57 @@
+Feature: Merge table cells
+  In order to form a table cell spanning multiple rows and/or columns
+  As a developer using python-docx
+  I need a way to merge a range of cells
+
+  @wip
+  Scenario Outline: Merge cells
+     Given a 3x3 table having only uniform cells
+      When I merge from cell <origin> to cell <other>
+      Then the row cells text is <expected-text>
+
+    Examples: Reported row cell contents
+      | origin | other | expected-text                             |
+      |    1   |   2   | 1\2 1\2 3 4 5 6 7 8 9                     |
+      |    2   |   5   | 1 2\5 3 4 2\5 6 7 8 9                     |
+      |    5   |   9   | 1 2 3 4 5\6\8\9 5\6\8\9 7 5\6\8\9 5\6\8\9 |
+
+
+  @wip
+  Scenario Outline: Merge horizontal span with other cell
+     Given a 3x3 table having a horizontal span
+      When I merge from cell <origin> to cell <other>
+      Then the row cells text is <expected-text>
+
+    Examples: Reported row cell contents
+      | origin | other | expected-text                     |
+      |    4   |   8   | 1 2 3 4\7\8 4\7\8 6 4\7\8 4\7\8 9 |
+      |    4   |   6   | 1 2 3 4\6 4\6 4\6 7 8 9           |
+      |    2   |   4   | 1\2\4 1\2\4 3 1\2\4 1\2\4 6 7 8 9 |
+
+
+  @wip
+  Scenario Outline: Merge vertical span with other cell
+     Given a 3x3 table having a vertical span
+      When I merge from cell <origin> to cell <other>
+      Then the row cells text is <expected-text>
+
+    Examples: Reported row cell contents
+      | origin | other | expected-text                     |
+      |    5   |   9   | 1 2 3 4 5\6\9 5\6\9 7 5\6\9 5\6\9 |
+      |    2   |   5   | 1 2\5 3 4 2\5 6 7 2\5 9           |
+      |    7   |   5   | 1 2 3 4\5\7 4\5\7 6 4\5\7 4\5\7 9 |
+
+
+  @wip
+  Scenario Outline: Horizontal span adds cell widths
+     Given a 3x3 table having <span-state>
+      When I merge from cell <origin> to cell <other>
+      Then the width of cell <merged> is <width> inches
+
+    Examples: Reported row cell contents
+      | span-state         | origin | other | merged | width |
+      | only uniform cells |    1   |   2   |    1   |  2.0  |
+      | only uniform cells |    1   |   5   |    1   |  2.0  |
+      | a horizontal span  |    4   |   6   |    4   |  3.0  |
+      | a vertical span    |    5   |   2   |    2   |  1.0  |
+      | a vertical span    |    5   |   7   |    5   |  2.0  |