python - 如何记录作为函数的参数字符串

Question

我有两个问题

1. 如何对作为函数的参数进行文档字符串
2. 当我有几行代码(例如 print('xxxx') )但我需要相同的函数(time.sleep(5))时，使用 lambda 是个好主意吗？ code>) 在它们之间执行

<小时/>

#method 1
time.sleep(5)
print('i am first')
time.sleep(5)
print('i am 2nd')
time.sleep(5)
print('i am 3rd')
time.sleep(5)
print('i am 4th')
time.sleep(5)
print('i am 5th')


#method 2
import time
def add_delay_between_action(func):
    time.sleep(5)
    func()
    time.sleep(5)
add_delay_between_action(lambda: print('i am first'))
add_delay_between_action(lambda: print('i am 2nd'))
add_delay_between_action(lambda: print('i am 3rd'))
add_delay_between_action(lambda: print('i am 4th'))
add_delay_between_action(lambda: print('i am 5th'))

Answer 1

传达预期参数类型的文档字符串的替代方法是使用 typing模块。在你的情况下，对于一个函数 typing.Callable .

import time
import typing

def add_delay_between_action(func: typing.Callable[[], None]):
    time.sleep(5)
    func()
    time.sleep(5)