一个穷人的 Python 调试器。
项目描述
PySnooper - 不再使用打印进行调试
PySnooper是一个穷人的调试器。如果您使用过 Bash,它就像set -xPython 一样,只是它更高级。
你的故事:你试图弄清楚为什么你的 Python 代码没有做你认为应该做的事情。您会喜欢使用带有断点和监视功能的成熟调试器,但您现在不必费心设置一个。
您想知道哪些行正在运行,哪些没有运行,以及局部变量的值是什么。
大多数人会print在战略位置使用线,其中一些显示变量的值。
PySnooper可以让你做同样的事情,除了不是仔细制作正确的print行,你只需向你感兴趣的函数添加一个装饰器行。你会得到你的函数的播放日志,包括哪些行运行以及更改局部变量的时间和确切时间。
是什么让PySnooper从所有其他代码智能工具中脱颖而出?你可以在你糟糕的、庞大的企业代码库中使用它,而无需进行任何设置。只需打开装饰器,如下所示,并通过将其路径指定为第一个参数来将输出重定向到专用日志文件。
例子
我们正在编写一个通过返回位列表将数字转换为二进制的函数。@pysnooper.snoop()让我们通过添加装饰器来窥探它:
import pysnooper
@pysnooper.snoop()
def number_to_bits(number):
if number:
bits = []
while number:
number, remainder = divmod(number, 2)
bits.insert(0, remainder)
return bits
else:
return [0]
number_to_bits(6)
stderr 的输出是:
或者,如果您不想跟踪整个函数,可以将相关部分包装在一个with块中:
import pysnooper
import random
def foo():
lst = []
for i in range(10):
lst.append(random.randrange(1, 1000))
with pysnooper.snoop():
lower = min(lst)
upper = max(lst)
mid = (lower + upper) / 2
print(lower, mid, upper)
foo()
输出类似:
New var:....... i = 9
New var:....... lst = [681, 267, 74, 832, 284, 678, ...]
09:37:35.881721 line 10 lower = min(lst)
New var:....... lower = 74
09:37:35.882137 line 11 upper = max(lst)
New var:....... upper = 832
09:37:35.882304 line 12 mid = (lower + upper) / 2
74 453.0 832
New var:....... mid = 453.0
09:37:35.882486 line 13 print(lower, mid, upper)
Elapsed time: 00:00:00.000344
特征
如果您无法轻松访问 stderr,您可以将输出重定向到文件:
@pysnooper.snoop('/my/log/file.log')
您也可以改为传递流或可调用对象,它们将被使用。
查看一些不是局部变量的表达式的值:
@pysnooper.snoop(watch=('foo.bar', 'self.x["whatever"]'))
显示函数调用的函数的监听行:
@pysnooper.snoop(depth=2)
有关更多选项,请参阅高级用法。<------
使用 Pip 安装
安装PySnooper的最佳方式是使用 Pip:
$ pip install pysnooper
其他安装选项
带有 conda-forge 通道的 Conda:
$ conda install -c conda-forge pysnooper
Arch Linux:
$ yay -S python-pysnooper
Fedora Linux:
$ dnf install python3-pysnooper
执照
版权所有 (c) 2019 Ram Rachum 和合作者,根据 MIT 许可发布。
媒体报道
黑客新闻线程 和/r/Python Reddit 线程(2019 年 4 月 22 日)