urwid 2.6.15__py3-none-any.whl → 3.0.5__py3-none-any.whl

urwid/widget/scrollable.py

@@ -25,8 +25,6 @@ import contextlib
 import enum
 import typing
 
-from typing_extensions import Protocol, runtime_checkable
-
 from .constants import BOX_SYMBOLS, SHADE_SYMBOLS, Sizing
 from .widget_decoration import WidgetDecoration, WidgetError
 
@@ -84,8 +82,8 @@ class ScrollbarSymbols(str, enum.Enum):
     DRAWING_DOUBLE = BOX_SYMBOLS.DOUBLE.VERTICAL
 
 
-@runtime_checkable
-class WidgetProto(Protocol):
+@typing.runtime_checkable
+class WidgetProto(typing.Protocol):
     """Protocol for widget.
 
     Due to protocol cannot inherit non-protocol bases, define several obligatory Widget methods.
@@ -117,8 +115,8 @@ class WidgetProto(Protocol):
     def render(self, size: tuple[int, int], focus: bool = False) -> Canvas: ...
 
 
-@runtime_checkable
-class SupportsScroll(WidgetProto, Protocol):
+@typing.runtime_checkable
+class SupportsScroll(WidgetProto, typing.Protocol):
     """Scroll specific methods."""
 
     def get_scrollpos(self, size: tuple[int, int], focus: bool = False) -> int: ...
@@ -126,8 +124,8 @@ class SupportsScroll(WidgetProto, Protocol):
     def rows_max(self, size: tuple[int, int] | None = None, focus: bool = False) -> int: ...
 
 
-@runtime_checkable
-class SupportsRelativeScroll(WidgetProto, Protocol):
+@typing.runtime_checkable
+class SupportsRelativeScroll(WidgetProto, typing.Protocol):
     """Relative scroll-specific methods."""
 
     def require_relative_scroll(self, size: tuple[int, int], focus: bool = False) -> bool: ...
@@ -140,10 +138,7 @@ class SupportsRelativeScroll(WidgetProto, Protocol):
 def orig_iter(w: Widget) -> Iterator[Widget]:
     visited = {w}
     yield w
-    while hasattr(w, "original_widget"):
-        w = w.original_widget
-        if w in visited:
-            break
+    while (w := getattr(w, "original_widget", w)) not in visited:
         visited.add(w)
         yield w
 
@@ -194,8 +189,8 @@ class Scrollable(WidgetDecoration[WrappedWidget]):
             first_visible = False
             for pwi, (w, _o) in enumerate(ow.contents):
                 wcanv = w.render((maxcol,))
-                wh = wcanv.rows()
-                if wh:
+
+                if wh := wcanv.rows():
                     ch += wh
 
                 if not last_hidden and ch >= self._trim_top:
@@ -235,17 +230,13 @@ class Scrollable(WidgetDecoration[WrappedWidget]):
         canv = canvas.CompositeCanvas(canv_full)
         canv_cols, canv_rows = canv.cols(), canv.rows()
 
-        if canv_cols <= maxcol:
-            pad_width = maxcol - canv_cols
-            if pad_width > 0:
-                # Canvas is narrower than available horizontal space
-                canv.pad_trim_left_right(0, pad_width)
+        if canv_cols <= maxcol and (pad_width := maxcol - canv_cols) > 0:
+            # Canvas is narrower than available horizontal space
+            canv.pad_trim_left_right(0, pad_width)
 
-        if canv_rows <= maxrow:
-            fill_height = maxrow - canv_rows
-            if fill_height > 0:
-                # Canvas is lower than available vertical space
-                canv.pad_trim_top_bottom(0, fill_height)
+        if canv_rows <= maxrow and (fill_height := maxrow - canv_rows) > 0:
+            # Canvas is lower than available vertical space
+            canv.pad_trim_top_bottom(0, fill_height)
 
         if canv_cols <= maxcol and canv_rows <= maxrow:
             # Canvas is small enough to fit without trimming
@@ -537,7 +528,7 @@ class ScrollBar(WidgetDecoration[WrappedWidget]):
         if use_relative:
             # `operator.length_hint` is Protocol (Spec) over class based and can end false-negative on the instance
             # use length_hint-like approach with safe `AttributeError` handling
-            ow_len = getattr(ow_base, "__len__", getattr(ow_base, "__length_hint__", lambda: 0))()
+            ow_len = getattr(ow_base, "__len__", getattr(ow_base, "__length_hint__", int))()
             ow_canv = render_for_scrollbar()
             visible_amount = ow_base.get_visible_amount(ow_size, focus)
             pos = ow_base.get_first_visible_pos(ow_size, focus)
@@ -552,17 +543,18 @@ class ScrollBar(WidgetDecoration[WrappedWidget]):
                 use_relative = False
 
         if not use_relative:
-            ow_rows_max = ow_base.rows_max(size, focus)
-            if ow_rows_max <= maxrow:
+            if ow_base.rows_max(size, focus) > maxrow:
+                ow_canv = render_for_scrollbar()
+                # re-calculate using wrapped size
+                ow_rows_max = ow_base.rows_max(ow_size, focus)
+                pos = ow_base.get_scrollpos(ow_size, focus)
+                posmax = ow_rows_max - maxrow
+                thumb_weight = min(1.0, maxrow / max(1, ow_rows_max))
+
+            else:
                 # Canvas fits without scrolling - no scrollbar needed
                 return render_no_scrollbar()
 
-            ow_canv = render_for_scrollbar()
-            ow_rows_max = ow_base.rows_max(ow_size, focus)
-            pos = ow_base.get_scrollpos(ow_size, focus)
-            posmax = ow_rows_max - maxrow
-            thumb_weight = min(1.0, maxrow / max(1, ow_rows_max))
-
         # Thumb shrinks/grows according to the ratio of <number of visible lines> / <number of total lines>
         thumb_height = max(1, round(thumb_weight * maxrow))  # pylint: disable=possibly-used-before-assignment
 
@@ -570,7 +562,7 @@ class ScrollBar(WidgetDecoration[WrappedWidget]):
         top_weight = float(pos) / max(1, posmax)  # pylint: disable=possibly-used-before-assignment
         top_height = int((maxrow - thumb_height) * top_weight)
         if top_height == 0 and top_weight > 0:
-            top_height = 1
+            top_height = min(1, maxrow - thumb_height)
 
         # Bottom part is remaining space
         bottom_height = maxrow - thumb_height - top_height

urwid/widget/solid_fill.py

@@ -22,7 +22,7 @@ class SolidFill(Widget):
         :param fill_char: character to fill area with
         :type fill_char: bytes or unicode
 
-        >>> SolidFill(u'8')
+        >>> SolidFill("8")
         <SolidFill box widget '8'>
         """
         super().__init__()
@@ -39,9 +39,9 @@ class SolidFill(Widget):
         """
         Render the Fill as a canvas and return it.
 
-        >>> SolidFill().render((4,2)).text # ... = b in Python 3
+        >>> SolidFill().render((4, 2)).text  # ... = b in Python 3
         [...'    ', ...'    ']
-        >>> SolidFill('#').render((5,3)).text
+        >>> SolidFill("#").render((5, 3)).text
         [...'#####', ...'#####', ...'#####']
         """
         maxcol, maxrow = size

urwid/widget/text.py

@@ -61,9 +61,9 @@ class Text(Widget):
         :param layout: defaults to a shared :class:`StandardTextLayout` instance
         :type layout: text layout instance
 
-        >>> Text(u"Hello")
+        >>> Text("Hello")
         <Text fixed/flow widget 'Hello'>
-        >>> t = Text(('bold', u"stuff"), 'right', 'any')
+        >>> t = Text(("bold", "stuff"), "right", "any")
         >>> t
         <Text fixed/flow widget 'stuff' align='right' wrap='any'>
         >>> print(t.text)
@@ -73,6 +73,7 @@ class Text(Widget):
         """
         super().__init__()
         self._cache_maxcol: int | None = None
+        self._layout: text_layout.TextLayout = layout or text_layout.default_layout
         self.set_text(markup)
         self.set_layout(align, wrap, layout)
 
@@ -108,13 +109,13 @@ class Text(Widget):
         :param markup: see :class:`Text` for description.
         :type markup: text markup
 
-        >>> t = Text(u"foo")
+        >>> t = Text("foo")
         >>> print(t.text)
         foo
-        >>> t.set_text(u"bar")
+        >>> t.set_text("bar")
         >>> print(t.text)
         bar
-        >>> t.text = u"baz"  # not supported because text stores text but set_text() takes markup
+        >>> t.text = "baz"  # not supported because text stores text but set_text() takes markup
         Traceback (most recent call last):
         AttributeError: can't set attribute
         """
@@ -132,11 +133,11 @@ class Text(Widget):
               run length encoded display attributes for *text*, eg.
               ``[('attr1', 10), ('attr2', 5)]``
 
-        >>> Text(u"Hello").get_text() # ... = u in Python 2
+        >>> Text("Hello").get_text()  # ... = u in Python 2
         (...'Hello', [])
-        >>> Text(('bright', u"Headline")).get_text()
+        >>> Text(("bright", "Headline")).get_text()
         (...'Headline', [('bright', 8)])
-        >>> Text([('a', u"one"), u"two", ('b', u"three")]).get_text()
+        >>> Text([("a", "one"), "two", ("b", "three")]).get_text()
         (...'onetwothree', [('a', 3), (None, 3), ('b', 5)])
         """
         return self._text, self._attrib
@@ -165,16 +166,16 @@ class Text(Widget):
         :param mode: typically ``'left'``, ``'center'`` or ``'right'``
         :type mode: text alignment mode
 
-        >>> t = Text(u"word")
-        >>> t.set_align_mode('right')
+        >>> t = Text("word")
+        >>> t.set_align_mode("right")
         >>> t.align
         'right'
-        >>> t.render((10,)).text # ... = b in Python 3
+        >>> t.render((10,)).text  # ... = b in Python 3
         [...'      word']
-        >>> t.align = 'center'
+        >>> t.align = "center"
         >>> t.render((10,)).text
         [...'   word   ']
-        >>> t.align = 'somewhere'
+        >>> t.align = "somewhere"
         Traceback (most recent call last):
         TextError: Alignment mode 'somewhere' not supported.
         """
@@ -191,18 +192,18 @@ class Text(Widget):
         :param mode: typically ``'space'``, ``'any'``, ``'clip'`` or ``'ellipsis'``
         :type mode: text wrapping mode
 
-        >>> t = Text(u"some words")
-        >>> t.render((6,)).text # ... = b in Python 3
+        >>> t = Text("some words")
+        >>> t.render((6,)).text  # ... = b in Python 3
         [...'some  ', ...'words ']
-        >>> t.set_wrap_mode('clip')
+        >>> t.set_wrap_mode("clip")
         >>> t.wrap
         'clip'
         >>> t.render((6,)).text
         [...'some w']
-        >>> t.wrap = 'any'  # Urwid 0.9.9 or later
+        >>> t.wrap = "any"  # Urwid 0.9.9 or later
         >>> t.render((6,)).text
         [...'some w', ...'ords  ']
-        >>> t.wrap = 'somehow'
+        >>> t.wrap = "somehow"
         Traceback (most recent call last):
         TextError: Wrap mode 'somehow' not supported.
         """
@@ -227,8 +228,8 @@ class Text(Widget):
         :param layout: defaults to a shared :class:`StandardTextLayout` instance
         :type layout: text layout instance
 
-        >>> t = Text(u"hi")
-        >>> t.set_layout('right', 'clip')
+        >>> t = Text("hi")
+        >>> t.set_layout("right", "clip")
         >>> t
         <Text fixed/flow widget 'hi' align='right' wrap='clip'>
         """
@@ -255,9 +256,9 @@ class Text(Widget):
 
         See :meth:`Widget.render` for parameter details.
 
-        >>> Text(u"important things").render((18,)).text
+        >>> Text("important things").render((18,)).text
         [b'important things  ']
-        >>> Text(u"important things").render((11,)).text
+        >>> Text("important things").render((11,)).text
         [b'important  ', b'things     ']
         >>> Text("demo text").render(()).text
         [b'demo text']
@@ -277,9 +278,9 @@ class Text(Widget):
 
         See :meth:`Widget.rows` for parameter details.
 
-        >>> Text(u"important things").rows((18,))
+        >>> Text("important things").rows((18,))
         1
-        >>> Text(u"important things").rows((11,))
+        >>> Text("important things").rows((11,))
         2
         """
         (maxcol,) = size
@@ -332,14 +333,25 @@ class Text(Widget):
         :param focus: widget is focused on
         :type focus: bool
 
-        >>> Text(u"important things").pack()
+        >>> Text("important things").pack()
         (16, 1)
-        >>> Text(u"important things").pack((15,))
+        >>> Text("important things").pack((15,))
         (9, 2)
-        >>> Text(u"important things").pack((8,))
+        >>> Text("important things").pack((8,))
         (8, 2)
-        >>> Text(u"important things").pack(())
+        >>> Text("important things").pack(())
         (16, 1)
+        >>> not_common_separated_text = "Line feed\\nLine Separator\\u2028Paragraph Separator\\u2029"
+        >>> # \u2028 (Line Separator) and \u2029 (Paragraph Separator) are not splitted by StandardTextLayout
+        >>> not_common_separated = Text(not_common_separated_text)
+
+        >>> not_common_separated.pack()
+        (33, 2)
+        >>> not_common_separated_canv = not_common_separated.render(())
+        >>> not_common_separated_canv.cols()
+        33
+        >>> not_common_separated_canv.rows()
+        2
         """
         text, attr = self.get_text()
 
@@ -356,8 +368,10 @@ class Text(Widget):
             if isinstance(text, bytes):
                 text = text.decode(get_encoding())
 
+            split_text = text.split("\n")
+
             return (
-                max(calc_width(line, 0, len(line)) for line in text.splitlines(keepends=False)),
-                text.count("\n") + 1,
+                max(calc_width(line, 0, len(line)) for line in split_text),
+                len(split_text),
             )
         return 0, 1

urwid/widget/treetools.py

@@ -27,7 +27,6 @@ Features:
 - custom list walker for displaying widgets in a tree fashion
 """
 
-
 from __future__ import annotations
 
 import typing
@@ -107,8 +106,8 @@ class TreeWidget(WidgetWrap[Padding[typing.Union[Text, Columns]]]):
     def next_inorder(self) -> TreeWidget | None:
         """Return the next TreeWidget depth first from this one."""
         # first check if there's a child widget
-        first_child = self.first_child()
-        if first_child is not None:
+
+        if (first_child := self.first_child()) is not None:
             return first_child
 
         # now we need to hunt for the next sibling
@@ -131,24 +130,21 @@ class TreeWidget(WidgetWrap[Padding[typing.Union[Text, Columns]]]):
     def prev_inorder(self) -> TreeWidget | None:
         """Return the previous TreeWidget depth first from this one."""
         this_node = self._node
-        prev_node = this_node.prev_sibling()
-        if prev_node is not None:
+
+        if (prev_node := this_node.prev_sibling()) is not None:
             # we need to find the last child of the previous widget if its
             # expanded
             prev_widget = prev_node.get_widget()
-            last_child = prev_widget.last_child()
-            if last_child is None:
-                return prev_widget
+            if (last_child := prev_widget.last_child()) is not None:
+                return last_child
 
-            return last_child
+            return prev_widget
 
         # need to hunt for the parent
-        depth = this_node.get_depth()
-        if prev_node is None and depth == 0:
+        if this_node.get_depth() == 0:
             return None
-        if prev_node is None:
-            prev_node = this_node.get_parent()
-        return prev_node.get_widget()
+
+        return this_node.get_parent().get_widget()
 
     def keypress(
         self,
@@ -212,11 +208,10 @@ class TreeWidget(WidgetWrap[Padding[typing.Union[Text, Columns]]]):
         else:
             return None
         # recursively search down for the last descendant
-        last_descendant = last_child.last_child()
-        if last_descendant is None:
-            return last_child
+        if (last_descendant := last_child.last_child()) is not None:
+            return last_descendant
 
-        return last_descendant
+        return last_child
 
 
 class TreeNode:
@@ -372,32 +367,18 @@ class ParentNode(TreeNode):
 
     def next_child(self, key: Hashable) -> TreeNode | None:
         """Return the next child node in index order from the given key."""
-
-        index = self.get_child_index(key)
-        # the given node may have just been deleted
-        if index is None:
-            return None
-        index += 1
-
-        child_keys = self.get_child_keys()
-        if index < len(child_keys):
+        if (index := self.get_child_index(key)) is not None and (index + 1) < len(child_keys := self.get_child_keys()):
             # get the next item at same level
-            return self.get_child_node(child_keys[index])
+            return self.get_child_node(child_keys[index + 1])
 
+        # the given node may have just been deleted
         return None
 
     def prev_child(self, key: Hashable) -> TreeNode | None:
         """Return the previous child node in index order from the given key."""
-        index = self.get_child_index(key)
-        if index is None:
-            return None
-
-        child_keys = self.get_child_keys()
-        index -= 1
-
-        if index >= 0:
-            # get the previous item at same level
-            return self.get_child_node(child_keys[index])
+        if (index := self.get_child_index(key)) is not None and index >= 1:
+            # get the previous item at the same level
+            return self.get_child_node(self.get_child_keys()[index - 1])
 
         return None
 
@@ -435,18 +416,16 @@ class TreeWalker(ListWalker):
 
     # pylint: disable=arguments-renamed  # its bad, but we should not change API
     def get_next(self, start_from) -> tuple[TreeWidget, TreeNode] | tuple[None, None]:
-        target = start_from.get_widget().next_inorder()
-        if target is None:
-            return None, None
+        if (target := start_from.get_widget().next_inorder()) is not None:
+            return target, target.get_node()
 
-        return target, target.get_node()
+        return None, None
 
     def get_prev(self, start_from) -> tuple[TreeWidget, TreeNode] | tuple[None, None]:
-        target = start_from.get_widget().prev_inorder()
-        if target is None:
-            return None, None
+        if (target := start_from.get_widget().prev_inorder()) is not None:
+            return target, target.get_node()
 
-        return target, target.get_node()
+        return None, None
 
     # pylint: enable=arguments-renamed
 
@@ -525,8 +504,8 @@ class TreeListBox(ListBox):
 
         maxrow, _maxcol = size
         _widget, pos = self.body.get_focus()
-        lastwidget = pos.get_root().get_widget().last_child()
-        if lastwidget:
+
+        if lastwidget := pos.get_root().get_widget().last_child():
             lastnode = lastwidget.get_node()
 
             self.change_focus(size, lastnode, maxrow - 1)

urwid/widget/widget.py

@@ -41,7 +41,7 @@ WrappedWidget = typing.TypeVar("WrappedWidget")
 LOGGER = logging.getLogger(__name__)
 
 
-class WidgetMeta(MetaSuper, signals.MetaSignals):
+class WidgetMeta(signals.MetaSignals, MetaSuper):
     """
     Bases: :class:`MetaSuper`, :class:`MetaSignals`
 
@@ -105,8 +105,8 @@ def cache_widget_render(cls):
     @functools.wraps(fn)
     def cached_render(self, size, focus=False):
         focus = focus and not ignore_focus
-        canv = CanvasCache.fetch(self, cls, size, focus)
-        if canv:
+
+        if canv := CanvasCache.fetch(self, cls, size, focus):
             return canv
 
         canv = fn(self, size, focus=focus)
@@ -174,8 +174,8 @@ def cache_widget_rows(cls):
     @functools.wraps(fn)
     def cached_rows(self, size: tuple[int], focus: bool = False) -> int:
         focus = focus and not ignore_focus
-        canv = CanvasCache.fetch(self, cls, size, focus)
-        if canv:
+
+        if canv := CanvasCache.fetch(self, cls, size, focus):
             return canv.rows()
 
         return fn(self, size, focus)
@@ -565,133 +565,16 @@ class Widget(metaclass=WidgetMeta):
         raise NotImplementedError
 
 
-class FlowWidget(Widget):
-    """
-    Deprecated.  Inherit from Widget and add:
-
-        _sizing = frozenset(['flow'])
-
-    at the top of your class definition instead.
-
-    Base class of widgets that determine their rows from the number of
-    columns available.
-    """
-
-    _sizing = frozenset([Sizing.FLOW])
-
-    def __init__(self, *args, **kwargs):
-        warnings.warn(
-            """
-            FlowWidget is deprecated. Inherit from Widget and add:
-
-                _sizing = frozenset(['flow'])
-
-            at the top of your class definition instead.""",
-            DeprecationWarning,
-            stacklevel=3,
-        )
-        super().__init__()
-
-    def rows(self, size: tuple[int], focus: bool = False) -> int:
-        """
-        All flow widgets must implement this function.
-        """
-        raise NotImplementedError()
-
-    def render(self, size: tuple[int], focus: bool = False) -> Canvas:  # type: ignore[override]
-        """
-        All widgets must implement this function.
-        """
-        raise NotImplementedError()
-
-
-class BoxWidget(Widget):
-    """
-    Deprecated.  Inherit from Widget and add:
-
-        _sizing = frozenset(['box'])
-        _selectable = True
-
-    at the top of your class definition instead.
-
-    Base class of width and height constrained widgets such as
-    the top level widget attached to the display object
-    """
-
-    _selectable = True
-    _sizing = frozenset([Sizing.BOX])
-
-    def __init__(self, *args, **kwargs):
-        warnings.warn(
-            """
-            BoxWidget is deprecated. Inherit from Widget and add:
-
-                _sizing = frozenset(['box'])
-                _selectable = True
-
-            at the top of your class definition instead.""",
-            DeprecationWarning,
-            stacklevel=3,
-        )
-        super().__init__()
-
-    def render(self, size: tuple[int, int], focus: bool = False) -> Canvas:  # type: ignore[override]
-        """
-        All widgets must implement this function.
-        """
-        raise NotImplementedError()
-
-
 def fixed_size(size: tuple[()]) -> None:
     """
     raise ValueError if size != ().
 
     Used by FixedWidgets to test size parameter.
     """
-    if size != ():
+    if size:
         raise ValueError(f"FixedWidget takes only () for size.passed: {size!r}")
 
 
-class FixedWidget(Widget):
-    """
-    Deprecated.  Inherit from Widget and add:
-
-        _sizing = frozenset(['fixed'])
-
-    at the top of your class definition instead.
-
-    Base class of widgets that know their width and height and
-    cannot be resized
-    """
-
-    _sizing = frozenset([Sizing.FIXED])
-
-    def __init__(self, *args, **kwargs):
-        warnings.warn(
-            """
-            FixedWidget is deprecated. Inherit from Widget and add:
-
-                _sizing = frozenset(['fixed'])
-
-            at the top of your class definition instead.""",
-            DeprecationWarning,
-            stacklevel=3,
-        )
-        super().__init__()
-
-    def render(self, size: tuple[()], focus: bool = False) -> Canvas:  # type: ignore[override]
-        """
-        All widgets must implement this function.
-        """
-        raise NotImplementedError()
-
-    def pack(self, size: tuple[()] = (), focus: bool = False) -> tuple[int, int]:  # type: ignore[override]
-        """
-        All fixed widgets must implement this function.
-        """
-        raise NotImplementedError()
-
-
 def delegate_to_widget_mixin(attribute_name: str) -> type[Widget]:
     """
     Return a mixin class that delegates all standard widget methods
@@ -795,12 +678,12 @@ class WidgetWrap(delegate_to_widget_mixin("_wrapped_widget"), typing.Generic[Wra
         only by subclasses.
 
         >>> size = (10,)
-        >>> ww = WidgetWrap(Edit("hello? ","hi"))
-        >>> ww.render(size).text # ... = b in Python 3
+        >>> ww = WidgetWrap(Edit("hello? ", "hi"))
+        >>> ww.render(size).text  # ... = b in Python 3
         [...'hello? hi ']
         >>> ww.selectable()
         True
-        >>> ww._w = Text("goodbye") # calls _set_w()
+        >>> ww._w = Text("goodbye")  # calls _set_w()
         >>> ww.render(size).text
         [...'goodbye   ']
         >>> ww.selectable()
@@ -815,19 +698,19 @@ class WidgetWrap(delegate_to_widget_mixin("_wrapped_widget"), typing.Generic[Wra
         only by subclasses.
         >>> from urwid import Edit, Text
         >>> size = (10,)
-        >>> ww = WidgetWrap(Edit("hello? ","hi"))
-        >>> ww.render(size).text # ... = b in Python 3
+        >>> ww = WidgetWrap(Edit("hello? ", "hi"))
+        >>> ww.render(size).text  # ... = b in Python 3
         [...'hello? hi ']
         >>> ww.selectable()
         True
-        >>> ww._w = Text("goodbye") # calls _set_w()
+        >>> ww._w = Text("goodbye")  # calls _set_w()
         >>> ww.render(size).text
         [...'goodbye   ']
         >>> ww.selectable()
         False
         """
         warnings.warn(
-            "_set_w is deprecated. Please use 'WidgetWrap._w' property directly",
+            "_set_w is deprecated. Please use 'WidgetWrap._w' property directly. API will be removed in version 5.0.",
             DeprecationWarning,
             stacklevel=2,
         )