acpt: add cel-text.feature

Steve Canny · Steve Canny · commit cc8339b4d7b0 · 2013-12-23T20:34:16.000-08:00
diff --git a/docx/shared.py b/docx/shared.py
@@ -25,3 +25,13 @@ def get_prop_value(obj):
             return value
 
     return property(get_prop_value, doc=docstring)
+
+
+def write_only_property(f):
+    """
+    @write_only_property decorator. Creates a property (descriptor attribute)
+    that accepts assignment, but not getattr (use in an expression).
+    """
+    docstring = f.__doc__
+
+    return property(fset=f, doc=docstring)
diff --git a/docx/table.py b/docx/table.py
@@ -6,7 +6,7 @@
 
 from __future__ import absolute_import, print_function, unicode_literals
 
-from .shared import lazyproperty
+from .shared import lazyproperty, write_only_property
 from .text import Paragraph
 
 
@@ -66,6 +66,14 @@ def __init__(self, tc):
     def paragraphs(self):
         return [Paragraph(p) for p in self._tc.p_lst]
 
+    @write_only_property
+    def text(self, text):
+        """
+        Write-only. Set entire contents of cell to the string *text*. Any
+        existing content or revisions are replaced.
+        """
+        raise NotImplementedError
+
 
 class _Column(object):
     """
diff --git a/features/cel-text.feature b/features/cel-text.feature
@@ -0,0 +1,10 @@
+Feature: Set table cell text
+  In order to quickly populate a table cell with regular text
+  As an python-docx developer working with a table
+  I need the ability to set the text of a table cell
+
+  @wip
+  Scenario: Set table cell text
+     Given a table cell
+      When I assign a string to the cell text attribute
+      Then the cell contains the string I assigned
diff --git a/features/steps/cell.py b/features/steps/cell.py
@@ -0,0 +1,39 @@
+# encoding: utf-8
+
+"""
+Step implementations for table cell-related features
+"""
+
+from __future__ import absolute_import, print_function, unicode_literals
+
+from behave import given, then, when
+
+from docx import Document
+
+
+# given ===================================================
+
+@given('a table cell')
+def given_a_table_cell(context):
+    table = Document().body.add_table(rows=2, cols=2)
+    context.cell = table.cell(0, 0)
+
+
+# when =====================================================
+
+@when('I assign a string to the cell text attribute')
+def when_assign_string_to_cell_text_attribute(context):
+    cell = context.cell
+    text = 'foobar'
+    cell.text = text
+    context.expected_text = text
+
+
+# then =====================================================
+
+@then('the cell contains the string I assigned')
+def then_cell_contains_string_assigned(context):
+    cell, expected_text = context.cell, context.expected_text
+    text = cell.paragraphs[0].runs[0].text
+    msg = "expected '%s', got '%s'" % (expected_text, text)
+    assert text == expected_text, msg
