escape-sequence-in-docstring (D301) reports escaped docstrings within docstrings

[tjkuson]

Running

ruff check --isolated --select D301

on

def foo():
    """
    This docstring contains another docstring.

        def bar():
            \"\"\"Here it is!\"\"\"
    """

returns an escape-sequence-in-docstring (D301) diagnostic, printing

example.py:2:5: D301 Use `r"""` if any backslashes in a docstring
  |
1 |   def foo():
2 |       """
  |  _____^
3 | |     This docstring contains another docstring.
4 | |
5 | |         def bar():
6 | |             \"\"\"Here it is!\"\"\"
7 | |     """
  | |_______^ D301
  |
  = help: Add `r` prefix

However, adding the r prefix and removing the backslashes is a syntax error:

def foo():
    r"""
    This docstring contains another docstring.

        def bar():
            """Here it is!"""
    """

Docstrings in within docstrings can appear when a docstring contains a code snippet (which is how I discovered the issue). I would expect D301 not to be raised, as making the docstring raw doesn't work.

Ruff version 0.5.0

Search terms: D301, backslash, escape

Update: managed to reproduce with

def foo():
    """
    This docstring contains another docstring.

        def bar():
            \"""Here it is!\"""
    """

as well.

[ukyen8]

Hi, I would like to work on this issue. Is anyone already working on it?

[dhruvmanila]

@ukyen8 I don't think so, go for it!

[charliermarsh]

Closed by #12192 (review). Thanks!