urwid 4.1.6__tar.gz → 4.2.0__tar.gz

{urwid-4.1.6 → urwid-4.2.0}/.github/workflows/documentation.yml

@@ -26,23 +26,14 @@ jobs:
       - uses: actions/checkout@v7
         with:
           fetch-depth: 0  # need for setuptools_scm
-      - name: Set up Python
-        uses: actions/setup-python@v7
-        with:
-          python-version: '3.x'
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.1.0
-      - name: Install Ubuntu dependencies
-        run: |
-          sudo apt-get -qq update
-          sudo apt-get install -y python3-dev python3-gi python3-gi-cairo
-          sudo apt-get install -y gobject-introspection libgirepository-2.0-dev libcairo2-dev
+        uses: astral-sh/setup-uv@v10.2.0
       - name: Create virtual environment
-        run: uv venv --python-preference only-system
+        run: uv venv
       - name: Install python dependencies
         run: uv pip install -U --group pyproject.toml:documentation
       - name: Install main package with all extras
-        run: uv pip install -U -e ".[curses,glib,serial,tornado,trio,twisted,zmq]"
+        run: uv pip install -U -e ".[curses,serial,tornado,trio,twisted,zmq]"
       - name: Build documentation
         run: uv run --no-project sphinx-build docs build/documentation
       - uses: actions/upload-artifact@v7

{urwid-4.1.6 → urwid-4.2.0}/.github/workflows/isolated_mypy.yml

@@ -16,14 +16,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
-      - name: Set up Python
-        uses: actions/setup-python@v7
-        with:
-          python-version: '3.x'
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.1.0
+        uses: astral-sh/setup-uv@v10.2.0
       - name: Create virtual environment
-        run: uv venv --python-preference only-system
+        run: uv venv
       - name: Install package with all extras
         run: uv pip install -e ".[curses,serial,tornado,trio,twisted,zmq]"
       - name: Install dependencies

{urwid-4.1.6 → urwid-4.2.0}/.github/workflows/isolated_pylint.yml

@@ -16,21 +16,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
-      - name: Install Ubuntu dependencies
-        run: |
-          sudo apt-get -qq update
-          sudo apt-get install -y python3-dev python3-gi python3-gi-cairo
-          sudo apt-get install -y gobject-introspection libgirepository-2.0-dev libcairo2-dev
-      - name: Set up Python
-        uses: actions/setup-python@v7
-        with:
-          python-version: '3.x'
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.1.0
+        uses: astral-sh/setup-uv@v10.2.0
       - name: Create virtual environment
-        run: uv venv --python-preference only-system
+        run: uv venv
       - name: Install package with all extras
-        run: uv pip install -e ".[curses,glib,serial,tornado,trio,twisted,zmq]"
+        run: uv pip install -e ".[curses,serial,tornado,trio,twisted,zmq]"
       - name: Install dependencies
         run: uv pip install --upgrade -r pylint-requirements.txt
       - name: Lint with pylint

{urwid-4.1.6 → urwid-4.2.0}/.github/workflows/pythonpackage.yml

@@ -52,21 +52,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
-      - name: Install Ubuntu dependencies
-        run: |
-          sudo apt-get -qq update
-          sudo apt-get install -y python3-dev python3-gi python3-gi-cairo
-          sudo apt-get install -y gobject-introspection libgirepository-2.0-dev libcairo2-dev
-      - name: Set up Python
-        uses: actions/setup-python@v7
-        with:
-          python-version: '3.x'
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.1.0
+        uses: astral-sh/setup-uv@v10.2.0
       - name: Create virtual environment
-        run: uv venv --python-preference only-system
+        run: uv venv
       - name: Install package with all extras
-        run: uv pip install -e ".[curses,glib,serial,tornado,trio,twisted,zmq]"
+        run: uv pip install -e ".[curses,serial,tornado,trio,twisted,zmq]"
       - name: Install dependencies
         run: uv pip install --upgrade -r pylint-requirements.txt
       - name: Lint with pylint
@@ -77,14 +68,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
-      - name: Set up Python
-        uses: actions/setup-python@v7
-        with:
-          python-version: '3.x'
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.1.0
+        uses: astral-sh/setup-uv@v10.2.0
       - name: Create virtual environment
-        run: uv venv --python-preference only-system
+        run: uv venv
       - name: Install package with all extras
         run: uv pip install -e ".[curses,serial,tornado,trio,twisted,zmq]"
       - name: Install dependencies
@@ -102,9 +89,6 @@ jobs:
         # , "macos-latest"
         # enable macOS only if OS specific branch will be added
         python-version: [ "3.9", "3.10", "3.11", "3.12", "3.13", "3.14" ]
-        exclude:
-          - os: "windows-latest"
-            python-version: "3.14"
 
     steps:
       - uses: actions/checkout@v7
@@ -116,24 +100,11 @@ jobs:
           python-version: ${{ matrix.python-version }}
           allow-prereleases: true
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.1.0
-      - name: Install Ubuntu dependencies
-        if: runner.os == 'Linux'
-        run: |
-          sudo apt-get -qq update
-          sudo apt-get install -y python3-dev python3-gi python3-gi-cairo
-          sudo apt-get install -y gobject-introspection libgirepository-2.0-dev libcairo2-dev
-      - name: Install Mac OS X dependencies
-        if: runner.os == 'macOS'
-        run: |
-          brew install gtk+3 gobject-introspection gtk-mac-integration
+        uses: astral-sh/setup-uv@v10.2.0
       - name: Create virtual environment
         run: uv venv --python-preference only-system --python ${{ matrix.python-version }}
       - name: Install dependencies
         run: uv pip install -r pytest_requirements.txt
-      - name: Install PyGObject
-        if: runner.os == 'Linux' || runner.os == 'macOS'
-        run: uv pip install PyGObject
       - name: Install package with all extras
         run: uv pip install -e ".[curses,serial,tornado,trio,twisted,zmq]"
       - name: Test
@@ -165,18 +136,11 @@ jobs:
         with:
           fetch-depth: 0  # need for setuptools_scm
 
-      - uses: actions/setup-python@v7
-        with:
-          python-version: "3.x"
-
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.1.0
-
-      - name: Install dependencies
-        run: uv pip install --system -U build
+        uses: astral-sh/setup-uv@v10.2.0
 
       - name: Build dist
-        run: python -m build
+        run: uv build
 
       - uses: actions/upload-artifact@v7
         with:
@@ -196,15 +160,8 @@ jobs:
     needs: [ build ]
     steps:
       - uses: actions/checkout@v7
-      - name: Set up Python
-        uses: actions/setup-python@v7
-        with:
-          python-version: '3.x'
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.1.0
-      - name: Install dependencies
-        run: |
-          uv pip install --system --upgrade twine
+        uses: astral-sh/setup-uv@v10.2.0
       - uses: actions/download-artifact@v8
         with:
           # unpacks default artifact into dist/
@@ -214,8 +171,7 @@ jobs:
           path: dist
 
       - name: Validate metadata
-        run: |
-          twine check dist/*
+        run: uvx twine check dist/*
 
   upload_pypi:
     needs: [ build, Metadata ]

{urwid-4.1.6 → urwid-4.2.0}/.github/workflows/yamllint.yml

@@ -17,7 +17,7 @@ jobs:
     steps:
       - uses: actions/checkout@v7
       - name: Install uv
-        uses: astral-sh/setup-uv@v10.1.0
+        uses: astral-sh/setup-uv@v10.2.0
       - name: Lint YAML files
         run: uv run --no-project --with-requirements yamllint-requirements.txt yamllint . -f github
 

{urwid-4.1.6 → urwid-4.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: urwid
-Version: 4.1.6
+Version: 4.2.0
 Summary: A full-featured console (xterm et al.) user interface library
 Author-email: Ian Ward <ian@excess.org>
 License-Expression: LGPL-2.1-only
@@ -19,6 +19,7 @@ Classifier: Operating System :: Unix
 Classifier: Operating System :: MacOS :: MacOS X
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: User Interfaces
 Classifier: Topic :: Software Development :: Widget Sets
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
@@ -27,9 +28,13 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Programming Language :: Python :: Implementation :: GraalPy
+Classifier: Programming Language :: Python :: Free Threading :: 2 - Beta
+Classifier: Typing :: Typed
 Requires-Python: >=3.9.0
 Description-Content-Type: text/x-rst
 License-File: COPYING
@@ -71,7 +76,7 @@ It includes many features useful for text console application developers includi
 - Automatic, programmable text alignment and wrapping
 - Simple markup for setting text attributes within blocks of text
 - Powerful list box with programmable content for scrolling all widget types
-- Your choice of event loops: Twisted, Glib, Tornado, asyncio, trio, ZeroMQ or select-based loop
+- Your choice of event loops: Twisted, Glib (deprecated), Tornado, asyncio, trio, ZeroMQ or select-based loop
 - Pre-built widgets include edit boxes, buttons, check boxes and radio buttons
 - Display modules include raw, curses, and experimental LCD and web displays
 - Support for UTF-8, simple 8-bit and CJK encodings

{urwid-4.1.6 → urwid-4.2.0}/README.rst

@@ -14,7 +14,7 @@ It includes many features useful for text console application developers includi
 - Automatic, programmable text alignment and wrapping
 - Simple markup for setting text attributes within blocks of text
 - Powerful list box with programmable content for scrolling all widget types
-- Your choice of event loops: Twisted, Glib, Tornado, asyncio, trio, ZeroMQ or select-based loop
+- Your choice of event loops: Twisted, Glib (deprecated), Tornado, asyncio, trio, ZeroMQ or select-based loop
 - Pre-built widgets include edit boxes, buttons, check boxes and radio buttons
 - Display modules include raw, curses, and experimental LCD and web displays
 - Support for UTF-8, simple 8-bit and CJK encodings

{urwid-4.1.6 → urwid-4.2.0}/classifiers.txt

@@ -7,6 +7,7 @@ Operating System :: Unix
 Operating System :: MacOS :: MacOS X
 Operating System :: Microsoft :: Windows
 Topic :: Software Development :: Libraries :: Python Modules
+Topic :: Software Development :: User Interfaces
 Topic :: Software Development :: Widget Sets
 Programming Language :: Python :: 3
 Programming Language :: Python :: 3.9
@@ -15,6 +16,10 @@ Programming Language :: Python :: 3.11
 Programming Language :: Python :: 3.12
 Programming Language :: Python :: 3.13
 Programming Language :: Python :: 3.14
+Programming Language :: Python :: 3.15
 Programming Language :: Python :: 3 :: Only
 Programming Language :: Python :: Implementation :: CPython
 Programming Language :: Python :: Implementation :: PyPy
+Programming Language :: Python :: Implementation :: GraalPy
+Programming Language :: Python :: Free Threading :: 2 - Beta
+Typing :: Typed

{urwid-4.1.6 → urwid-4.2.0}/conftest.py

@@ -1,3 +1,5 @@
+"""Pytest configuration: skip collecting modules that cannot be imported on this platform."""
+
 from __future__ import annotations
 
 import importlib.util
@@ -52,6 +54,7 @@ def _backend_available(name: str) -> bool:
 
 
 def pytest_ignore_collect(collection_path: Path) -> bool | None:
+    """Skip collecting a platform-only or optional-backend test module that cannot run here."""
     name = collection_path.name
 
     if not _PLATFORM_ONLY.get(name, True):

urwid-4.2.0/pylint-requirements.txt

@@ -0,0 +1 @@
+pylint==4.0.9

{urwid-4.1.6 → urwid-4.2.0}/pyproject.toml

@@ -144,6 +144,7 @@ extend-select = [
   "PL",
   "PERF",
   "RUF",   # tryceratops, pyupgrade, isort, pylint + perflint, Ruff-specific
+  "D",     # pydocstyle
 ]
 extend-ignore = [
   "E221",
@@ -164,12 +165,24 @@ extend-ignore = [
   "SIM108",  # Use ternary operator,
   "TRY003",  # long messages prepare outside, ...
   "PYI063",  # MonitoredList is a list subclass, this expected to change
+  "ISC001",  # conflicts with the formatter, which can produce single-line implicit concatenation
+  # suspicious-xml-*-usage: recommend defusedxml, which is not a dependency
+  "S313",
+  "S314",
+  "S315",
+  "S316",
+  "S317",
+  "S318",
+  "S319",
 ]
 [tool.ruff.lint.isort]
 known-third-party = []
 [tool.ruff.lint.per-file-ignores]
 "__init__.py" = [ "F401", "SIM105" ]
 "urwid/display/curses.py" = [ "A005" ]
+# Shown verbatim in the docs as numbered listings, wcur2.py from a fixed line (`:lines: 7-`).
+"docs/tutorial/*.py" = [ "D100", "D101", "D102", "D103", "D107" ]
+"docs/manual/*.py" = [ "D100", "D101", "D102", "D103", "D107" ]
 [tool.ruff.lint.pydocstyle]
 convention = "pep257"
 [tool.ruff.lint.pylint]
@@ -182,27 +195,22 @@ allow-dunder-method-names = [
 ]
 
 [tool.pylint]
-reports = false
 disable = [
   "arguments-differ",
   "attribute-defined-outside-init",                   # old bad practice, fixed step-by-step
-  "broad-except",
+  "broad-exception-caught",
   "broad-exception-raised",
   "consider-using-assignment-expr",
-  # iterable modification during iteration
-  "consider-using-enumerate",
+  "consider-using-enumerate",                         # iterable modification during iteration
   "cyclic-import",
   "file-ignored",
   "fixme",
   "import-outside-toplevel",
   "invalid-name",
-  # Magic part
-  "invalid-overridden-method",
+  "invalid-overridden-method",                        # Magic part
   "locally-disabled",
   "logging-format-interpolation",
   "logging-fstring-interpolation",
-  "missing-docstring",
-  "redefined-variable-type",                          # makes not happy typechecking, but super common
   "similarities",
   "superfluous-parens",
   "suppressed-message",
@@ -220,12 +228,10 @@ disable = [
   "too-many-statements",
   "unused-argument",
   "unused-private-member",
-  # too complex union
-  "use-implicit-booleaness-not-comparison-to-string",
+  "use-implicit-booleaness-not-comparison-to-string", # too complex union
   "use-implicit-booleaness-not-comparison-to-zero",
 ]
 enable = "all"
-extension-pkg-whitelist = []
 ignore = [ "CVS", "version.py" ]
 # gi (PyGObject) is only installed with the "glib" extra; static checks also run without it.
 ignored-modules = [ "gi" ]
@@ -237,7 +243,6 @@ load-plugins = [
   "pylint.extensions.dunder",
   "pylint.extensions.for_any_all",
   "pylint.extensions.overlapping_exceptions",
-  "pylint.extensions.redefined_variable_type",
   "pylint.extensions.typing",
 ]
 max-line-length = 120

{urwid-4.1.6 → urwid-4.2.0}/urwid/__init__.py

@@ -19,6 +19,8 @@
 # Urwid web site: https://urwid.org/
 
 
+"""Urwid, a console user interface library: the public API re-exported from its submodules."""
+
 from __future__ import annotations
 
 import importlib.util
@@ -517,7 +519,8 @@ class _MovedModule(types.ModuleType):
         self._moved_to = moved_to
 
     def __getattr__(self, name: str) -> typing.Any:
-        """
+        """Resolve `name` by importing the module this one moved to.
+
         :raises AttributeError: *name* is not found, including when *self._moved_to* itself cannot be imported.
         """
         try:

{urwid-4.1.6 → urwid-4.2.0}/urwid/ansi_parser.py

@@ -109,20 +109,20 @@ class SkippedOp:
 
 @dataclasses.dataclass(frozen=True)
 class ParsedLine:
-    """The result of parsing one physical line of ANSI-coloured text.
+    r"""The result of parsing one physical line of ANSI-coloured text.
 
     :ivar text: the resolved, escape-free text of this line. When produced by :class:`AnsiParser` constructed with
-        ``one_line=True`` (or :func:`parse_ansi_line`), this is guaranteed never to contain a ``\\n`` -- line ends
+        ``one_line=True`` (or :func:`parse_ansi_line`), this is guaranteed never to contain a ``\n`` -- line ends
         are structural split points that produce *separate* :class:`ParsedLine` instances. That invariant is
         deliberately **not** upheld when :class:`AnsiParser` is constructed with ``one_line=False`` (or by
         :func:`parse_ansi_text`): since that mode resolves a whole multi-row block into a single :class:`ParsedLine`,
-        its ``text`` legitimately contains embedded ``\\n`` characters, one per row boundary, by design.
+        its ``text`` legitimately contains embedded ``\n`` characters, one per row boundary, by design.
     :ivar attrib: run-length encoded display attributes for :attr:`text`, the same shape as
         :attr:`urwid.Text.attrib`. ``None`` is a valid RLE tag (meaning "no attribute"), matching
         :func:`urwid.util.decompose_tagmarkup`'s convention.
     :ivar last_attr: the SGR/colour state in effect at the end of this line; feed this back in as ``previous_attr``
         to continue the same colour state into a subsequently parsed line.
-    :ivar bel: the number of BEL (``\\a``) characters seen on this line (``0`` if none were seen).
+    :ivar bel: the number of BEL (``\a``) characters seen on this line (``0`` if none were seen).
     :ivar title: the last OSC window-title string seen on this line, or ``None`` if none was seen.
     :ivar leds: the last keyboard-LED state requested on this line (``CSI n q``), or ``None`` if none was seen.
     :ivar skipped: every :class:`SkippedOp` stripped while parsing this line, in encounter order, for programmatic
@@ -139,7 +139,7 @@ class ParsedLine:
 
 
 class AnsiParser:
-    """Incremental ANSI parser that resolves escape sequences against a 2-D cell grid, in one of two modes.
+    r"""Incremental ANSI parser that resolves escape sequences against a 2-D cell grid, in one of two modes.
 
     Feed text in with :meth:`feed` -- any number of times, e.g. as chunks arrive from a subprocess -- and call
     :meth:`finalize` once to retrieve the result. :meth:`finalize` is a one-shot, terminal operation: construct a
@@ -154,18 +154,18 @@ class AnsiParser:
     treated, and in whether the side channels (``bel``, ``title``, ``leds``, ``skipped``) are reset per line or
     aggregated over the whole input:
 
-    * ``one_line=True``: a line-end sequence (``\\n``, ``\\r``, ``\\r\\n`` or ``\\n\\r``, the latter two pairs
+    * ``one_line=True``: a line-end sequence (``\n``, ``\r``, ``\r\n`` or ``\n\r``, the latter two pairs
       collapsing into a single event) is a **structural split point**, not discarded data -- the moment one is
       seen, the current row is completed into a :class:`ParsedLine` and pushed onto an internal completed-lines
       queue, and a fresh row is started for what follows, carrying the SGR/colour state
       (:attr:`ParsedLine.last_attr`) forward but resetting the per-line side channels. Vertical cursor movement
       (``CSI n A/B/E/F/d`` and ``CSI r;c H``/``f``) is meaningless outside a single line, so it is stripped and
       logged as a :class:`SkippedOp` rather than reinterpreted.
-    * ``one_line=False`` (the default): a full newline (``\\n``, or a collapsed ``\\r\\n``/``\\n\\r`` pair) genuinely
+    * ``one_line=False`` (the default): a full newline (``\n``, or a collapsed ``\r\n``/``\n\r`` pair) genuinely
       moves to a fresh row, resetting the column, while everything keeps accumulating in the same persistent grid
-      -- nothing is split off. A **bare** ``\\r`` (not part of a ``\\r\\n``/``\\n\\r`` pair) is carriage-return-only:
+      -- nothing is split off. A **bare** ``\r`` (not part of a ``\r\n``/``\n\r`` pair) is carriage-return-only:
       it resets the column without changing row, letting progress-bar-style in-place redraw sequences
-      (``"progress: 10%\\rprogress: 20%"``) resolve correctly onto a single row, mirroring real terminal behaviour.
+      (``"progress: 10%\rprogress: 20%"``) resolve correctly onto a single row, mirroring real terminal behaviour.
       Vertical cursor movement genuinely repositions the cursor within the grid instead of being stripped. The side
       channels are aggregated over the *entire* input rather than reset per row: ``bel`` is the total BEL count,
       ``title``/``leds`` are the last value seen anywhere, and ``skipped`` lists every :class:`SkippedOp` in
@@ -180,7 +180,7 @@ class AnsiParser:
     :meth:`finalize` returns a uniform ``tuple[ParsedLine, ...]`` in both modes: in ``one_line=True`` mode, every
     line completed since construction (queue plus a final flush of whatever remains, possibly empty or
     unterminated); in ``one_line=False`` mode, always exactly one :class:`ParsedLine` -- built from the whole grid,
-    rows joined with ``"\\n"`` -- wrapped in a 1-tuple.
+    rows joined with ``"\n"`` -- wrapped in a 1-tuple.
 
     :param previous_attr: SGR/colour state to seed the parser with, as if it were carried over from previously
         parsed text.
@@ -188,17 +188,18 @@ class AnsiParser:
         results; if false (the default), resolve the whole input into a single multi-row :class:`ParsedLine`.
 
     >>> parser = AnsiParser(one_line=True)
-    >>> parser.feed("hello\\nworld")
+    >>> parser.feed("hello\nworld")
     >>> [line.text for line in parser.finalize()]
     ['hello', 'world']
 
     >>> parser = AnsiParser()
-    >>> parser.feed("hello\\nworld")
+    >>> parser.feed("hello\nworld")
     >>> parser.finalize()[0].text
-    'hello\\nworld'
+    'hello\nworld'
     """
 
     def __init__(self, previous_attr: AttrSpec | None = None, *, one_line: bool = False) -> None:
+        """Create a parser, as described in the class docstring."""
         self._one_line = one_line
         self._attrspec: AttrSpec | None = previous_attr
 
@@ -285,12 +286,12 @@ class AnsiParser:
             i += 1
 
     def finalize(self) -> tuple[ParsedLine, ...]:
-        """Retrieve the parsed result, in a uniform ``tuple[ParsedLine, ...]`` shape regardless of mode.
+        r"""Retrieve the parsed result, in a uniform ``tuple[ParsedLine, ...]`` shape regardless of mode.
 
         In ``one_line=True`` mode, whatever remains in the current (possibly empty, possibly unterminated) row is
         flushed as one final :class:`ParsedLine`, and every line completed since construction is returned, in
         order. In ``one_line=False`` mode, the whole accumulated grid is resolved into a single :class:`ParsedLine`
-        (its ``text`` joining every resolved row with ``"\\n"``) and returned as a 1-tuple.
+        (its ``text`` joining every resolved row with ``"\n"``) and returned as a 1-tuple.
 
         This is a terminal operation: construct a new :class:`AnsiParser` to parse a fresh "session" of input.
 
@@ -324,10 +325,10 @@ class AnsiParser:
     # -- internal: line/row completion and cursor management -------------
 
     def _handle_line_end(self) -> None:
-        """Complete the current line, aborting any in-flight escape sequence.
+        r"""Complete the current line, aborting any in-flight escape sequence.
 
         Only called in one_line mode: a line end always aborts any in-flight escape sequence, since real escape
-        sequences never legitimately contain a raw \\r or \\n. In screen mode a newline is instead handled directly
+        sequences never legitimately contain a raw \r or \n. In screen mode a newline is instead handled directly
         in :meth:`feed` without touching escape-framing state.
         """
         self._within_escape = False
@@ -587,9 +588,9 @@ class AnsiParser:
 
 
 def parse_ansi_line(text: str, previous_attr: AttrSpec | None = None) -> tuple[ParsedLine, ...]:
-    """Feed ``text`` through a fresh :class:`AnsiParser` (``one_line=True``) and return its finalised result.
+    r"""Feed ``text`` through a fresh :class:`AnsiParser` (``one_line=True``) and return its finalised result.
 
-    Returns one :class:`ParsedLine` per line found in ``text`` (split on ``\\n``/``\\r``/``\\r\\n``/``\\n\\r``), plus
+    Returns one :class:`ParsedLine` per line found in ``text`` (split on ``\n``/``\r``/``\r\n``/``\n\r``), plus
     a trailing entry for a final unterminated fragment, if any -- never fewer than one element, even for empty
     input, and every character of the original data is preserved across the returned lines (line-end characters are
     structural split points, not stripped content).
@@ -599,11 +600,11 @@ def parse_ansi_line(text: str, previous_attr: AttrSpec | None = None) -> tuple[P
         previously parsed line.
     :returns: every :class:`ParsedLine` found in ``text``, in order.
 
-    >>> [line.text for line in parse_ansi_line("one\\ntwo\\nthree")]
+    >>> [line.text for line in parse_ansi_line("one\ntwo\nthree")]
     ['one', 'two', 'three']
     >>> [line.text for line in parse_ansi_line("")]
     ['']
-    >>> [line.text for line in parse_ansi_line("a\\nb")]
+    >>> [line.text for line in parse_ansi_line("a\nb")]
     ['a', 'b']
     """
     parser = AnsiParser(previous_attr, one_line=True)
@@ -612,22 +613,22 @@ def parse_ansi_line(text: str, previous_attr: AttrSpec | None = None) -> tuple[P
 
 
 def parse_ansi_text(text: str, previous_attr: AttrSpec | None = None) -> ParsedLine:
-    """Feed ``text`` through a fresh :class:`AnsiParser` (``one_line=False``) and return its sole resolved line.
+    r"""Feed ``text`` through a fresh :class:`AnsiParser` (``one_line=False``) and return its sole resolved line.
 
     Unlike :func:`parse_ansi_line`, vertical cursor movement and newlines are resolved into real multi-row output
     rather than stripped/split: the returned single :class:`ParsedLine`'s ``text`` joins every resolved row with
-    ``"\\n"``.
+    ``"\n"``.
 
     :param text: the text to parse.
     :param previous_attr: SGR/colour state to seed the parser with, as if it were carried over from previously
         parsed text.
     :returns: a single :class:`ParsedLine` representing the whole resolved block.
 
-    >>> parse_ansi_text("one\\ntwo\\nthree").text
-    'one\\ntwo\\nthree'
+    >>> parse_ansi_text("one\ntwo\nthree").text
+    'one\ntwo\nthree'
     >>> parse_ansi_text("").text
     ''
-    >>> parse_ansi_text("progress: 10%\\rprogress: 20%").text
+    >>> parse_ansi_text("progress: 10%\rprogress: 20%").text
     'progress: 20%'
     """
     parser = AnsiParser(previous_attr, one_line=False)