Merge pull request #6042 from Textualize/content-tests

Content tests

Author: willmcgugan

src/textual/widgets/_static.py

@@ -53,17 +53,25 @@ def __init__(
 
     @property
     def visual(self) -> Visual:
+        """The visual to be displayed.
+
+        Note that the visual is what is ultimately rendered in the widget, but may not be the
+        same object set with the `update` method  or `content` property. For instance, if you
+        update with a string, then the visual will be a [Content][textual.content.Content] instance.
+
+        """
         if self._visual is None:
             self._visual = visualize(self, self._content, markup=self._render_markup)
         return self._visual
 
     @property
     def content(self) -> VisualType:
-        """The content set in the constructor."""
+        """The original content set in the constructor."""
         return self._content
 
     @content.setter
     def content(self, content: VisualType) -> None:
+        self._content = content
         self._visual = visualize(self, content, markup=self._render_markup)
         self.clear_cached_dimensions()
         self.refresh(layout=True)
@@ -77,11 +85,11 @@ def render(self) -> RenderResult:
         return self.visual
 
     def update(self, content: VisualType = "", *, layout: bool = True) -> None:
-        """Update the widget's content area with new text or Rich renderable.
+        """Update the widget's content area with a string, a Visual (such as [Content][textual.content.Content]), or a [Rich renderable](https://rich.readthedocs.io/en/latest/protocol.html).
 
         Args:
             content: New content.
-            layout: Also perform a layout operation (set to `False` if you are certain the size won't change.)
+            layout: Also perform a layout operation (set to `False` if you are certain the size won't change).
         """
 
         self._content = content

tests/test_static.py

@@ -0,0 +1,18 @@
+from textual.content import Content
+from textual.widgets import Static
+
+
+def test_content_property():
+    static = Static()
+    assert static.content == ""
+    static.content = "Foo"
+    assert static.content == "Foo"
+    assert isinstance(static.content, str)
+    assert static.visual == "Foo"
+    assert isinstance(static.visual, Content)
+
+    static.update("Hello")
+    assert static.content == "Hello"
+    assert isinstance(static.content, str)
+    assert static.visual == "Hello"
+    assert isinstance(static.visual, Content)