tbl: add Table.alignment getter

Author: Steve Canny

docx/oxml/table.py

@@ -134,16 +134,29 @@ class CT_TblPr(BaseOxmlElement):
     ``<w:tblPr>`` element, child of ``<w:tbl>``, holds child elements that
     define table properties such as style and borders.
     """
-    tblStyle = ZeroOrOne('w:tblStyle', successors=(
-        'w:tblpPr', 'w:tblOverlap', 'w:bidiVisual', 'w:tblStyleRowBandSize',
-        'w:tblStyleColBandSize', 'w:tblW', 'w:jc', 'w:tblCellSpacing',
-        'w:tblInd', 'w:tblBorders', 'w:shd', 'w:tblLayout', 'w:tblCellMar',
-        'w:tblLook', 'w:tblCaption', 'w:tblDescription', 'w:tblPrChange'
-    ))
-    tblLayout = ZeroOrOne('w:tblLayout', successors=(
+    _tag_seq = (
+        'w:tblStyle', 'w:tblpPr', 'w:tblOverlap', 'w:bidiVisual',
+        'w:tblStyleRowBandSize', 'w:tblStyleColBandSize', 'w:tblW', 'w:jc',
+        'w:tblCellSpacing', 'w:tblInd', 'w:tblBorders', 'w:shd',
         'w:tblLayout', 'w:tblCellMar', 'w:tblLook', 'w:tblCaption',
         'w:tblDescription', 'w:tblPrChange'
-    ))
+    )
+    tblStyle = ZeroOrOne('w:tblStyle', successors=_tag_seq[1:])
+    jc = ZeroOrOne('w:jc', successors=_tag_seq[8:])
+    tblLayout = ZeroOrOne('w:tblLayout', successors=_tag_seq[13:])
+    del _tag_seq
+
+    @property
+    def alignment(self):
+        """
+        Member of :ref:`WdRowAlignment` enumeration or |None|, based on the
+        contents of the `w:val` attribute of `./w:jc`. |None| if no `w:jc`
+        element is present.
+        """
+        jc = self.jc
+        if jc is None:
+            return None
+        return jc.val
 
     @property
     def autofit(self):

docx/table.py

@@ -39,6 +39,16 @@ def add_row(self):
             tr.add_tc()
         return _Row(tr, self)
 
+    @property
+    def alignment(self):
+        """
+        Read/write. A member of :ref:`WdRowAlignment` or None, specifying the
+        positioning of this table between the page margins. |None| if no
+        setting is specified, causing the effective value to be inherited
+        from the style hierarchy.
+        """
+        return self._tblPr.alignment
+
     @property
     def autofit(self):
         """

features/tbl-props.feature

@@ -4,7 +4,6 @@ Feature: Get and set table properties
   I need a way to get and set a table's properties
 
 
-  @wip
   Scenario Outline: Determine table alignment
     Given a table having <alignment> alignment
      Then table.alignment is <value>

tests/test_table.py

@@ -8,6 +8,7 @@
 
 import pytest
 
+from docx.enum.table import WD_TABLE_ALIGNMENT
 from docx.oxml import parse_xml
 from docx.oxml.table import CT_Tc
 from docx.shared import Inches
@@ -23,6 +24,10 @@
 
 class DescribeTable(object):
 
+    def it_knows_its_alignment_setting(self, alignment_get_fixture):
+        table, expected_value = alignment_get_fixture
+        assert table.alignment == expected_value
+
     def it_knows_whether_it_should_autofit(self, autofit_get_fixture):
         table, expected_value = autofit_get_fixture
         assert table.autofit is expected_value
@@ -117,6 +122,17 @@ def add_row_fixture(self):
         expected_xml = _tbl_bldr(rows=2, cols=2).xml()
         return table, expected_xml
 
+    @pytest.fixture(params=[
+        ('w:tbl/w:tblPr',                    None),
+        ('w:tbl/w:tblPr/w:jc{w:val=center}', WD_TABLE_ALIGNMENT.CENTER),
+        ('w:tbl/w:tblPr/w:jc{w:val=right}',  WD_TABLE_ALIGNMENT.RIGHT),
+        ('w:tbl/w:tblPr/w:jc{w:val=left}',   WD_TABLE_ALIGNMENT.LEFT),
+    ])
+    def alignment_get_fixture(self, request):
+        tbl_cxml, expected_value = request.param
+        table = Table(element(tbl_cxml), None)
+        return table, expected_value
+
     @pytest.fixture(params=[
         ('w:tbl/w:tblPr',                             True),
         ('w:tbl/w:tblPr/w:tblLayout',                 True),