kcov - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

kcov - Phân tích phạm vi mã cho các chương trình đã biên dịch và tập lệnh Python

SYNOPSIS

kcov [lựa chọn] vượt mặt thực thi được [ args. cho thực thi được ]

MÔ TẢ

Trang hướng dẫn sử dụng này tài liệu ngắn gọn về kcov chỉ huy. kcov là một trình kiểm tra độ phủ mã cho
Mã nhị phân ELF, tập lệnh Python và tập lệnh shell. Nó cho phép thu thập phạm vi bảo hiểm của mã
thông tin từ các tệp thực thi mà không có chỉ thị trình biên dịch đặc biệt và liên tục
tạo ra kết quả đầu ra từ các ứng dụng chạy lâu.

LỰA CHỌN

-p, - lipid=PID
Theo dõi PID thay vì thực thi tệp thực thi, tệp thực thi là tùy chọn trong trường hợp này.

-l, --Hạn mức=Cao thấp
Thiết lập giới hạn cho vùng phủ sóng thấp / cao (mặc định: 16,50).

--bao gồm đường dẫn=P1[, P2...]
Danh sách các đường dẫn được phân tách bằng dấu phẩy để đưa vào báo cáo.

--loại trừ-đường dẫn=P1[, P2...]
Danh sách các đường dẫn được phân tách bằng dấu phẩy để loại trừ khỏi báo cáo.

--bao gồm-mẫu=P1[, P2...]
Danh sách các mẫu đường dẫn được phân tách bằng dấu phẩy để đưa vào báo cáo.

--loại trừ-mẫu=P1[, P2...]
Danh sách các mẫu đường dẫn được phân tách bằng dấu phẩy để loại trừ khỏi báo cáo.

- chỉ thu thập
Chỉ thu thập dữ liệu về phạm vi, không tạo đầu ra HTML / Cobertura

- chỉ báo cáo
Chỉ báo cáo đầu ra HTML / Cobertura, không thu thập dữ liệu

--quần yếm-id=id
Tải dữ liệu lên coveralls.io bằng cách sử dụng ID công việc dịch vụ repo_token hoặc Travis CI bí mật id.
ID được coi là repo_token nếu nó dài hơn hoặc bằng 32 ký tự.

KHÔNG PHỔ BIẾN LỰA CHỌN

--path-dải-cấp=N
Số cấp độ đường dẫn để hiển thị cho các đường dẫn chung (mặc định: 2).

--skip-solibs
Bỏ qua bộ sưu tập phạm vi cho các thư viện được chia sẻ (cải thiện hiệu suất)

--exit-first-tiến trình
thoát khi tiến trình đầu tiên thoát ra, tức là tôn trọng hành vi của daemon. Mặc định
hành vi là quay trở lại bảng điều khiển khi quá trình cuối cùng thoát.

--python-trình phân tích cú pháp=BỘ PHẬN
Đặt trình phân tích cú pháp python để sử dụng cho các chương trình Python (mặc định là python). Có thể
được sử dụng để chạy với Python 3 trên các hệ thống mà Python 2 là mặc định.

--bash-trình phân tích cú pháp=BỘ PHẬN
Đặt trình phân tích cú pháp bash để sử dụng cho các tập lệnh shell (mặc định là / bin / bash).

--replace-src-path=P1:P2
Thay thế đường dẫn tệp nguồn P1 bằng P2, nếu tìm thấy.

VÍ DỤ

Kiểm tra mức độ phù hợp cho ./frodo và tạo đầu ra HTML trong / tmp / kcov và đầu ra cobertura trong
/tmp/kcov/frodo/cobertura.xml

kcov / tmp / kcov ./frodo

Kiểm tra mức độ phù hợp cho ./frodo nhưng chỉ bao gồm tên tệp nguồn với chuỗi src / frodo

kcov --include-pattern = src / frodo / tmp / kcov ./frodo

Tương tự như trên nhưng thu thập và báo cáo chia nhỏ (có thể trên hai máy tính khác nhau)

kcov --collect-only / tmp / kcov ./frodo

kcov - chỉ báo cáo --include-pattern = src / frodo / tmp / kcov ./frodo

HTML OUTPUT

Đầu ra HTML hiển thị các dòng được thực thi và không được thực thi của mã nguồn. Một số dòng có thể
ánh xạ tới nhiều điểm thiết bị, ví dụ cho các chức năng nội tuyến (trong đó mọi
nội tuyến của chúng sẽ tạo ra một điểm đo đạc riêng biệt). Điều này được thể hiện trong
cột bên trái là 1/3 chẳng hạn, có nghĩa là một trong ba điểm thiết bị đo
đã được thực hiện.

Một liên kết đầu ra đặc biệt được [hợp nhất], hiển thị liên kết của tất cả các chương trình được bảo hiểm. Cái này
có thể hữu ích, chẳng hạn như khi bạn có các bài kiểm tra đơn vị trong nhiều tệp nhị phân chia sẻ
tập hợp con của các tệp nguồn.

PHỦ SÓNG OUTPUT

Kcov cũng xuất dữ liệu ở định dạng Cobertura XML, cho phép tích hợp đầu ra kcov
ở Jenkins (xem http://cobertura.sf.net và http://jenkins-ci.org).

Đầu ra Cobertura được đặt trong một tệp có tên là out-path / Operating-filename / cobertura.xml.

Sử dụng kcov trực tuyến bằng các dịch vụ onworks.net