ping-fox 0.1.0

A ping (ICMP) library - simple to use and no root or setuid required.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140

import glob
import os
import subprocess
import sys
from pathlib import Path

html_output_dir = "target/debug/coverage/"


def create_instrumentation_env():
    env = os.environ.copy()
    env["CARGO_INCREMENTAL"] = "0"
    env["RUSTFLAGS"] = (
        # " -Zprofile"
        " -Cinstrument-coverage"
        " -Ccodegen-units=1"
        " -Copt-level=0"
        " -Clink-dead-code"
        " -Coverflow-checks=off"
        " -Zpanic_abort_tests"
        " -Cpanic=abort"
    )
    env["LLVM_PROFILE_FILE"] = "cargo-test-%p-%m.profraw"
    return env


def run_coverage(env):
    print("=== run coverage ===")
    subprocess.run(
        ["cargo", "+nightly", "test", "--lib"],
        env=env,
        check=True,
        stdout=sys.stdout,
        stderr=sys.stderr,
    )
    subprocess.run(
        [
            "cargo",
            "+nightly",
            "test",
            "test_ping_to_localhost_with_dgram_socket",
            "--",
            "--exact",
        ],
        env=env,
        check=True,
        stdout=sys.stdout,
        stderr=sys.stderr,
    )
    print("ok.")


def generate_html_report():
    print("=== generate html report ===")
    Path(html_output_dir).mkdir(parents=True, exist_ok=True)
    subprocess.run(
        [
            "grcov",
            ".",
            "-s",
            ".",
            "--binary-path",
            "./target/debug/",
            "-t",
            "html",
            "--branch",
            "--ignore-not-existing",
            "--ignore",
            "/*",
            "-o",
            html_output_dir,
        ],
        check=True,
        stdout=sys.stdout,
        stderr=sys.stderr,
    )
    print("ok.")


def generate_report():
    print("=== generate report ===")
    Path(html_output_dir).mkdir(parents=True, exist_ok=True)
    subprocess.run(
        [
            "grcov",
            ".",
            "-s",
            ".",
            "--binary-path",
            "./target/debug/",
            "-t",
            "lcov",
            "--branch",
            "--ignore-not-existing",
            "--ignore",
            "/*",
            "--ignore",
            "target/debug/build/*",
            "--ignore",
            "tests/*",
            "-o",
            "./target/debug/lcov.info",
        ],
        check=True,
        stdout=sys.stdout,
        stderr=sys.stderr,
    )
    subprocess.run(
        [
            "genhtml",
            "-o",
            html_output_dir,
            "--show-details",
            "--highlight",
            "--ignore-errors",
            "source",
            "--legend",
            "./target/debug/lcov.info",
        ],
        check=True,
        stdout=sys.stdout,
        stderr=sys.stderr,
    )
    print("ok.")


def cleanup():
    print("=== cleanup ===")
    for file in glob.iglob("./**/*.profraw", recursive=True):
        os.remove(file)
    print("ok.")


if __name__ == "__main__":
    env = create_instrumentation_env()
    run_coverage(env)
    generate_report()
    cleanup()
    print(f"location of html code coverage report: {html_output_dir}")
    exit(0)