6
Tôi nghĩ rằng tôi đang thiếu một cái gì đó về phần mở rộng nhân sư cho doctest.Tự động tạo ra đầu ra doctest với phần mở rộng Sphinx
Các ví dụ điển hình trong tài liệu là: không có
.. doctest::
>>> print 1
1
phải là một cách để cho nhân sư tạo ra các đầu ra (ở đây: 1) tự động?
Theo như tôi hiểu, nó có thể chạy:
$ make doctest
mà có tác dụng để kiểm tra các đoạn mã, và so sánh sản lượng thực tế với sản lượng dự kiến. Ví dụ, nếu bạn có
.. doctest::
>>> print 1
3
doctest sẽ cảnh báo bạn rằng nó đã 1 trong khi nó đã mong 3.
Thay vào đó, tôi muốn nhân sư chèn đầu ra thực một mình vào chuỗi tài liệu của tôi hoặc trong tệp .rst của tôi. Ví dụ, nếu chúng ta có một cái gì đó như:
.. doctest::
>>> print 1
>>> print [2*x for x in range(3)]
Tôi muốn rằng khi chúng ta chạy make doctest với một lựa chọn, nó thay đổi docstring tới:
.. doctest::
>>> print 1
1
>>> print [2*x for x in range(3)]
[0,2,4]
tôi chắc chắn rằng nó có thể, và sẽ rất tiện lợi!
Cảm ơn! Tôi nhận ra tôi đã hiểu lầm mục đích của phần mở rộng nhân sư này. Tôi nghĩ đó là cách viết tài liệu nhanh hơn, nhưng giờ tôi đã hiểu toàn bộ ý tưởng đằng sau doctest. – user1283990