pythoningLearning
diff --git a/‎docs/dev/analysis/features/table.rst‎
Lines changed: 28 additions & 15 deletions b/‎docs/dev/analysis/features/table.rst‎
Lines changed: 28 additions & 15 deletions
diff --git a/‎features/steps/table.py‎
Lines changed: 41 additions & 0 deletions b/‎features/steps/table.py‎
Lines changed: 41 additions & 0 deletions
diff --git a/‎features/tbl-item-access.feature‎
Lines changed: 9 additions & 0 deletions b/‎features/tbl-item-access.feature‎
Lines changed: 9 additions & 0 deletions
@@ -16,21 +16,6 @@ Open questions
 * What about ranges? Why is that a good idea?
 
 
-Candidate Protocol
-------------------
-
-::
-
-    >>> row_count, col_count = 2, 2
-    >>> table = body.add_table(row_count, col_count)
-    >>> cell = table.cell(0, 0)
-    >>> p = cell.content[0]
-    >>> p.text = 'foobar'
-    >>> p = cell.content.add_paragraph('barfoo')
-    >>> p.text
-    'barfoo'
-
-
 Table access protocol
 ---------------------
 
@@ -43,6 +28,34 @@ Table access protocol
     ...         ..do table-y things..
 
 
+Candidate Protocol
+------------------
+
+::
+
+    >>> table = body.add_table(rows=1, cols=2)
+    >>> header_cells = table.rows[0].cells
+    >>> header_cells[0].text = 'Foo Name'
+    >>> header_cells[1].text = 'Bar Value'
+    >>> for obj in data_records:
+    ...     row_cells = table.add_row().cells
+    ...     row_cells[0].text = obj.str_fld_a
+    ...     row_cells[1].text = str(obj.int_fld_b)
+    ...
+
+
+Other protocol notions
+----------------------
+
+::
+
+    >>> cell = table.cell(0, 0)
+    >>> p = cell.content[0]
+    >>> p.text = 'foobar'
+    >>> p = cell.content.add_paragraph('barfoo')
+    >>> p.text
+    'barfoo'
+
 
 MS API
 ------
 
@@ -0,0 +1,41 @@
+# encoding: utf-8
+
+"""
+Step implementations for table-related features
+"""
+
+from __future__ import absolute_import, print_function, unicode_literals
+
+from behave import given, then
+
+from docx import Document
+from docx.table import _Row
+
+from .helpers import test_docx
+
+
+# given ===================================================
+
+@given('a table having two rows')
+def given_a_table_having_two_rows(context):
+    docx_path = test_docx('blk-containing-table')
+    document = Document(docx_path)
+    context.table_ = document.body.tables[0]
+
+
+# then =====================================================
+
+@then('the length of its row collection is 2')
+def then_len_of_row_collection_is_2(context):
+    rows = context.table_.rows
+    assert len(rows) == 2
+
+
+@then('each item in its row collection is a table row')
+def then_each_item_in_row_collection_is_a_table_row(context):
+    rows = context.table_.rows
+    count = 0
+    for item in rows:
+        count += 1
+        assert isinstance(item, _Row)
+    assert count == 2
@@ -0,0 +1,9 @@
+Feature: Access table rows, columns, and cells
+  In order to query and modify individual table items
+  As an python-docx developer
+  I need the ability to access table rows, columns, and cells
+
+  Scenario: Access table row collection
+     Given a table having two rows
+      Then the length of its row collection is 2
+       And each item in its row collection is a table row