docstrings

Author: willmcgugan

CHANGELOG.md

@@ -24,6 +24,9 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 - Added App.ALLOW_SELECT for a global switch to disable text selection https://github.com/Textualize/textual/pull/5409
 - Added `DOMNode.query_ancestor` https://github.com/Textualize/textual/pull/5409
 - Added selection to Log widget https://github.com/Textualize/textual/pull/5467
+- Added `text-wrap` and `text-overflow` CSS values https://github.com/Textualize/textual/pull/5485
+- Added Textual markup to replace Rich markup https://github.com/Textualize/textual/pull/5485
+- Added `Content.from_markup` https://github.com/Textualize/textual/pull/5485
 
 ### Fixed
 

src/textual/content.py

@@ -10,7 +10,7 @@
 from __future__ import annotations
 
 import re
-from functools import lru_cache, total_ordering
+from functools import cached_property, total_ordering
 from operator import itemgetter
 from typing import Callable, Iterable, NamedTuple, Sequence, Union
 
@@ -137,7 +137,7 @@ def __init__(
     def __str__(self) -> str:
         return self._text
 
-    @property
+    @cached_property
     def markup(self) -> str:
         """Get Content markup to render this Text.
 
@@ -260,7 +260,7 @@ def styled(
         style: Style | str = "",
         cell_length: int | None = None,
     ) -> Content:
-        """Create a Content instance from a single styled piece of text.
+        """Create a Content instance from text and an optional style.
 
         Args:
             text: String content.
@@ -294,9 +294,9 @@ def __lt__(self, other: object) -> bool:
     def is_same(self, content: Content) -> bool:
         """Compare to another Content object.
 
-        Two Content objects are the same if their text and spans match.
-        Note that if you use the `==` operator to compare Content instances, it will only consider the plain text portion of the content (and not the spans).
-
+        Two Content objects are the same if their text *and* spans match.
+        Note that if you use the `==` operator to compare Content instances, it will only consider
+        the plain text portion of the content (and not the spans).
 
         Args:
             content: Content instance.
@@ -427,6 +427,19 @@ def render_strips(
         selection: Selection | None = None,
         selection_style: Style | None = None,
     ) -> list[Strip]:
+        """Render the visual into an iterable of strips. Part of the Visual protocol.
+
+        Args:
+            rules: A mapping of style rules, such as the Widgets `styles` object.
+            width: Width of desired render.
+            height: Height of desired render or `None` for any height.
+            style: The base style to render on top of.
+            selection: Selection information, if applicable, otherwise `None`.
+            selection_style: Selection style if `selection` is not `None`.
+
+        Returns:
+            An list of Strips.
+        """
         if not width:
             return []
 
@@ -903,9 +916,9 @@ def render(
                 yield end, base_style
             return
 
+        get_style: Callable[[str], Style]
         if parse_style is None:
 
-            @lru_cache(maxsize=1024)
             def get_style(style: str, /) -> Style:
                 """The default get_style method."""
                 try:

src/textual/style.py

@@ -10,7 +10,7 @@
 from dataclasses import dataclass
 from functools import cached_property, lru_cache
 from marshal import dumps, loads
-from typing import TYPE_CHECKING, Any, Iterable
+from typing import TYPE_CHECKING, Any, Iterable, Mapping
 
 import rich.repr
 from rich.style import Style as RichStyle
@@ -216,7 +216,7 @@ def parse(cls, text_style: str, variables: dict[str, str] | None = None) -> Styl
             variables: Optional mapping of CSS variables. `None` to get variables from the app.
 
         Returns:
-            _type_: _description_
+            New style.
         """
         from textual.markup import parse_style
 
@@ -385,8 +385,8 @@ def combine(cls, styles: Iterable[Style]) -> Style:
         iter_styles = iter(styles)
         return sum(iter_styles, next(iter_styles))
 
-    @property
-    def meta(self) -> dict[str, Any]:
+    @cached_property
+    def meta(self) -> Mapping[str, Any]:
         """Get meta information (can not be changed after construction)."""
         return {} if self._meta is None else loads(self._meta)
 

src/textual/visual.py

@@ -124,6 +124,8 @@ def render_strips(
             width: Width of desired render.
             height: Height of desired render or `None` for any height.
             style: The base style to render on top of.
+            selection: Selection information, if applicable, otherwise `None`.
+            selection_style: Selection style if `selection` is not `None`.
 
         Returns:
             An list of Strips.