acpt: add scenario for ParagraphFormat.tab_stops

DKWoods · Steve Canny · commit b8e3de8266ae · 2016-03-18T23:10:21.000-07:00
diff --git a/docx/text/tabstops.py b/docx/text/tabstops.py
@@ -0,0 +1,20 @@
+# encoding: utf-8
+
+"""
+Tabstop-related proxy types.
+"""
+
+from __future__ import (
+    absolute_import, division, print_function, unicode_literals
+)
+
+from ..shared import ElementProxy
+
+
+class TabStops(ElementProxy):
+    """
+    A sequence providing access to the tab stops of a paragraph or paragraph
+    style. Supports iteration, indexed access, del, and len(). It is accesed
+    using the `tab_stops` property of ParagraphFormat; it is not intended to
+    be constructed directly.
+    """
diff --git a/features/steps/parfmt.py b/features/steps/parfmt.py
@@ -13,12 +13,19 @@
 from docx import Document
 from docx.enum.text import WD_ALIGN_PARAGRAPH, WD_LINE_SPACING
 from docx.shared import Pt
+from docx.text.tabstops import TabStops
 
 from helpers import test_docx
 
 
 # given ===================================================
 
+@given('a paragraph format')
+def given_a_paragraph_format(context):
+    document = Document(test_docx('tab-stops'))
+    context.paragraph_format = document.paragraphs[0].paragraph_format
+
+
 @given('a paragraph format having {prop_name} set {setting}')
 def given_a_paragraph_format_having_prop_set(context, prop_name, setting):
     style_name = {
@@ -139,6 +146,12 @@ def when_I_assign_value_to_paragraph_format_prop(context, value, prop_name):
 
 # then =====================================================
 
+@then('paragraph_format.tab_stops is a TabStops object')
+def then_paragraph_format_tab_stops_is_a_tabstops_object(context):
+    tab_stops = context.paragraph_format.tab_stops
+    assert isinstance(tab_stops, TabStops)
+
+
 @then('paragraph_format.alignment is {value}')
 def then_paragraph_format_alignment_is_value(context, value):
     expected_value = {
diff --git a/features/steps/test_files/tab-stops.docx b/features/steps/test_files/tab-stops.docx
diff --git a/features/txt-parfmt-props.feature b/features/txt-parfmt-props.feature
@@ -4,6 +4,12 @@ Feature: Get or set paragraph formatting properties
   I need a ParagraphFormat object with read/write formatting properties
 
 
+  @wip
+  Scenario: Get tab stops
+    Given a paragraph format
+     Then paragraph_format.tab_stops is a TabStops object
+
+
   Scenario Outline: Get paragraph alignment
     Given a paragraph format having <align-type> alignment
      Then paragraph_format.alignment is <value>
