1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
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
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 |
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 |
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 |
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 |
|
