Tài liệu có thể đọc được của con người có thể thực hiện được với Spock không?

Question

Vì vậy, gần đây tôi đã chuyển sang các thông số kỹ thuật và thử nghiệm bằng cách sử dụng các công cụ như FitNesse & Spock.

Tôi đã thực hiện cú đâm đầu tiên tại FitNesse và đó là một thách thức không có giấy tờ này. Thật may mắn là tôi đã vượt qua Spock và yêu nó khá nhanh chóng.

Điều đó đang được nói, một điều tôi ưa thích là tính năng tài liệu kiểu wiki của FitNesse. Nó cung cấp cả mã và tài liệu cho các bài kiểm tra đặc điểm kỹ thuật này.

Có cách nào trong Spock (có plugin?/Ra khỏi hộp không?) Để tạo bất kỳ loại tài liệu nào có thể đọc được của con người để khoe với người quản lý dự án/các bên liên quan?

Answer 1

Spock cho phép bạn thêm mô tả vào khối, ví dụ .:

when: "5 dollars are withdrawn from the account" 
account.withdraw(5) 

then: "3 dollars remain" 
account.balance == 3 

Trong khi chúng tôi không sử dụng thông tin này chưa, thật dễ dàng để truy cập từ một phần mở rộng (xem link bên dưới). Những gì còn lại để làm là biến điều này thành một báo cáo tốt đẹp.

https://github.com/spockframework/spock-uberconf-2011/blob/master/src/test/groovy/extension/custom/ReportExtension.groovy

Answer 2

Vâng, tôi đã sử dụng Strings mô tả mỗi khối Spock trong các thử nghiệm của bạn để tạo các báo cáo HTML. Vui lòng truy cập dự án của tôi và cho tôi biết nếu điều đó giúp:

https://github.com/renatoathaydes/spock-reports

Bạn có thể tải jar từ thư mục reports và sau đó chỉ cần thêm nó vào classpath của bạn. Chạy thử nghiệm của bạn và "kỳ diệu" bạn sẽ có các báo cáo được tạo trong thư mục build/spock-reports!

Bạn thậm chí có thể cung cấp các bản định kiểu CSS của riêng mình nếu bạn muốn tùy chỉnh các báo cáo, như được giải thích trong README.

Here's a blogpost Tôi đã viết về cách viết phần mở rộng Spock này.

CẬP NHẬT

Spock-báo cáo đã thịnh hành trên Maven Central một thời bây giờ, cũng như JCenter.

Answer 3

Có một số câu trả lời tuyệt vời ở đây, nhưng nếu bạn muốn giữ các định nghĩa BDD của mình miễn phí từ bất kỳ hệ thống ống nước nào, bạn có thể xem pease, nó sẽ cho phép bạn sử dụng ngôn ngữ Gherkin với Spock.