tabs: add TabStops.clear_all()

DKWoods · DKWoods · commit bb2746b00b10 · 2016-05-25T15:47:23.000-05:00
diff --git a/docx/text/tabstops.py b/docx/text/tabstops.py
@@ -75,6 +75,14 @@ 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 tab stops.
+        """
+        tabs = self._pPr.get_or_add_tabs()
+        while len(tabs) > 0:
+            del tabs[0]
+
 
 class TabStop(ElementProxy):
     """
diff --git a/tests/text/test_tabstops.py b/tests/text/test_tabstops.py
@@ -153,8 +153,24 @@ def it_can_delete_a_tab_stop(self, delete_tab_fixture):
         del tab_stops[index]
         assert tab_stops._element.xml == expected_xml
 
+    def it_can_clear_all_tab_stops(self, clear_all_tab_stops_fixture):
+        tab_stops = clear_all_tab_stops_fixture
+        tab_stops.clear_all()
+        assert len(tab_stops) == 0
+
     # fixture --------------------------------------------------------
 
+    @pytest.fixture(params=[
+        'w:pPr',
+        'w:pPr/w:tabs/w:tab{w:pos=2880}',
+        'w:pPr/w:tabs/(w:tab{w:pos=24,w:val=center},'
+        'w:tab{w:pos=42,w:val=left})',
+    ])
+    def clear_all_tab_stops_fixture(self, request):
+        pPr_cxml = request.param
+        tab_stops = TabStops(element(pPr_cxml))
+        return tab_stops
+
     @pytest.fixture(params=[
         ('w:pPr/w:tabs/w:tab{w:pos=42,w:val=left}', 0, 'w:pPr'),
         ('w:pPr/w:tabs/(w:tab{w:pos=24,w:val=center},'
