Black: Black changes quotes for multiline docstring when string normalization is off

Created on 20 Nov 2020 · 1Comment · Source: psf/black

Describe the bug A clear and concise description of what the bug is.
Black changes docstring quotes from ''' to """ for multiline docstrings when using --skip-string-normalization

To Reproduce Steps to reproduce the behavior:

Take this file:

def a():
    '''The function a'''
    return 'a'


def b():
    '''
    The function b requires more words in the docstring
    and as such uses a slightly different format.
    '''
    return 'b'


def c():
    '''The function c requires more words in the docstring
    but lines are expensive.'''
    return 'c'


def d():
    '''
    The function d requires more words in the docstring
    and does not know how to be consistent.'''
    return 'd'


def e():
    '''The function e requires more words in the docstring
    and is confused by d.
    '''
    return 'e'

Run _Black_ on it with these arguments '--skip-string-normalization'
The file is changed to this:

def a():
    '''The function a'''
    return 'a'


def b():
    """
    The function b requires more words in the docstring
    and as such uses a slightly different format.
    """
    return 'b'


def c():
    """The function c requires more words in the docstring
    but lines are expensive."""
    return 'c'


def d():
    """
    The function d requires more words in the docstring
    and does not know how to be consistent."""
    return 'd'


def e():
    """The function e requires more words in the docstring
    and is confused by d.
    """
    return 'e'

Expected behavior A clear and concise description of what you expected to happen.
Without string normalization the file should not have changed.

Environment (please complete the following information):