tab: add TabStops.clear_all()

Author: DKWoods

docx/text/tabstops.py

@@ -78,6 +78,12 @@ def add_tab_stop(self, position, alignment=WD_TAB_ALIGNMENT.LEFT,
         tab = tabs.insert_tab_in_order(position, alignment, leader)
         return TabStop(tab)
 
+    def clear_all(self):
+        """
+        Remove all custom tab stops.
+        """
+        self._pPr._remove_tabs()
+
 
 class TabStop(ElementProxy):
     """

features/tab-access-tabs.feature

@@ -39,7 +39,6 @@ Feature: Access TabStop objects
       And the removed tab stop is no longer present in tab_stops
 
 
-  @wip
   Scenario: TabStops.clear_all()
     Given a tab_stops having 3 tab stops
      When I call tab_stops.clear_all()

tests/text/test_tabstops.py

@@ -175,8 +175,24 @@ def it_raises_on_del_idx_invalid(self, del_raises_fixture):
             del tab_stops[idx]
         assert exc.value.args[0] == 'tab index out of range'
 
+    def it_can_clear_all_its_tab_stops(self, clear_all_fixture):
+        tab_stops, expected_xml = clear_all_fixture
+        tab_stops.clear_all()
+        assert tab_stops._element.xml == expected_xml
+
     # fixture --------------------------------------------------------
 
+    @pytest.fixture(params=[
+        'w:pPr',
+        'w:pPr/w:tabs/w:tab{w:pos=42}',
+        'w:pPr/w:tabs/(w:tab{w:pos=24},w:tab{w:pos=42})',
+    ])
+    def clear_all_fixture(self, request):
+        pPr_cxml = request.param
+        tab_stops = TabStops(element(pPr_cxml))
+        expected_xml = xml('w:pPr')
+        return tab_stops, expected_xml
+
     @pytest.fixture(params=[
         ('w:pPr/w:tabs/w:tab{w:pos=42}',                   0,
          'w:pPr'),