[Fix]fix cleandoc with a first blank line

[megemini]

PR types

Bug fixes

PR changes

Others

Description

修复 extract_code_blocks_from_docstr 里面的 inspect.cleandoc 不能正确处理 code-block 第一行的缩进问题。

参考 PEP 257 – Docstring Conventions

inspect.cleandoc 这个方法本来不是为 code 准备的，而是为 docstring 使用的。

而，docstring 中，默认第一行的缩进是无意义的：

Docstring processing tools will strip a uniform amount of indentation from the second and further lines of the docstring, equal to the minimum indentation of all non-blank lines after the first line. Any indentation in the first line of the docstring (i.e., up to the first newline) is insignificant and removed. Relative indentation of later lines in the docstring is retained.

也就是说，这个方法是按照第二行的缩进进行删减的，从而导致，如下的代码块可以正常解析：

In [80]: f
Out[80]: 
['            import paddle',
 '            with paddle.static.program_guard(main_program, startup_program):',
 "                data = paddle.static.data(name='image', shape=[None, 784, 784], dtype='float32')"]

In [81]: print(inspect.cleandoc('\n'.join(f)))
import paddle
with paddle.static.program_guard(main_program, startup_program):
    data = paddle.static.data(name='image', shape=[None, 784, 784], dtype='float32')

而，如下的代码块缩进会出问题：

In [82]: e
Out[82]: 
['            with paddle.static.program_guard(main_program, startup_program):',
 "                data = paddle.static.data(name='image', shape=[None, 784, 784], dtype='float32')"]

In [83]: print(inspect.cleandoc('\n'.join(e)))
with paddle.static.program_guard(main_program, startup_program):
data = paddle.static.data(name='image', shape=[None, 784, 784], dtype='float32')

修改后，默认添加一个空行，由此可以正常解析：

In [106]: print(inspect.cleandoc('\n' + '\n'.join(e)))
with paddle.static.program_guard(main_program, startup_program):
    data = paddle.static.data(name='image', shape=[None, 784, 784], dtype='float32')

关联 PR ：

• 修改 COPY-FROM No.6 metric
• [Fix]fix cleandoc with a first blank line

单测在 docs 那边的 PR 里面，这里就不放了～

@SigureMo 请评审！

[paddle-bot]

你的PR提交成功，感谢你对开源项目的贡献!
请关注后续CI自动化测试结果，详情请参考Paddle-CI手册。
Your PR has been submitted. Thanks for your contribution!
Please wait for the result of CI firstly. See Paddle CI Manual for details.

[SigureMo]

单测在 docs 那边的 PR 里面，这里就不放了～

我的意思是在这个 PR 里加上 #54879 python/paddle/metric/metrics.py 这个文件的修改，如果这个 PR CI 通过了，那么就说明改动是没问题的，docs 那边不用加单测的 😂，这边改一下吧

[SigureMo]

如果这边通过了，会同步 merge docs 下的相应 PR

[megemini]

好了， 看看行不～

[SigureMo]

好了， 看看行不～

嗯嗯，没什么问题，不过这些代码块最好和上面一样统一修改成四缩进吧～

[megemini]

已修改缩进，请评审！

@RedContritio @SigureMo

[SigureMo]

LGTM

相关流水线已过 🎉

[SigureMo]

merge 一下 develop 吧，PR-CI-Windows-Inference 问题 develop 已解决