cargo-semver-checks 0.43.0

Scan your Rust crate for semver violations.
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

SemverQuery(
    id: "safe_inherent_method_requires_more_target_features",
    human_readable_name: "safe method requires more target features",
    description: "A safe method or associated function now requires additional CPU target features compared to the previous version.",
    required_update: Major,
    lint_level: Deny,
    reference_link: Some("https://doc.rust-lang.org/reference/attributes/codegen.html#the-target_feature-attribute"),
    query: r#"
    {
        CrateDiff {
            current {
                item {
                    ... on ImplOwner {
                        visibility_limit @filter(op: "=", value: ["$public"])
                        name @output

                        importable_path {
                            path @output @tag
                            public_api @filter(op: "=", value: ["$true"])
                        }

                        inherent_impl {
                            method {
                                method_visibility: visibility_limit @filter(op: "=", value: ["$public"]) @output
                                method_name: name @output @tag
                                public_api_eligible @filter(op: "=", value: ["$true"])

                                # Don't trigger if the method became unsafe.
                                unsafe @filter(op: "=", value: ["$false"])

                                requires_feature {
                                    explicit @filter(op: "=", value: ["$true"])
                                    globally_enabled @filter(op: "=", value: ["$false"])
                                    new_feature: name @output @tag
                                }

                                # Don't trigger the lint if the function became uncallable on the current target triple.
                                # We have a separate lint for that.
                                requires_feature @fold @transform(op: "count") @filter(op: "=", value: ["$zero"]) {
                                    valid_for_current_target @filter(op: "=", value: ["$false"])
                                }

                                span_: span @optional {
                                    filename @output
                                    begin_line @output
                                    end_line @output
                                }
                            }
                        }
                    }
                }
            }
            baseline {
                item {
                    ... on ImplOwner {
                        visibility_limit @filter(op: "=", value: ["$public"])

                        importable_path {
                            path @filter(op: "=", value: ["%path"])
                            public_api @filter(op: "=", value: ["$true"])
                        }

                        inherent_impl {
                            method {
                                visibility_limit @filter(op: "=", value: ["$public"])
                                name @filter(op: "=", value: ["%method_name"])
                                public_api_eligible @filter(op: "=", value: ["$true"])
                                unsafe @filter(op: "=", value: ["$false"])

                                requires_feature @fold @transform(op: "count") @filter(op: ">", value: ["$zero"]) {
                                    explicit @filter(op: "=", value: ["$true"])
                                }

                                requires_feature @fold @transform(op: "count") @filter(op: "=", value: ["$zero"]) {
                                    name @filter(op: "=", value: ["%new_feature"])
                                }

                                # Don't trigger the lint if the function wasn't callable on the current target triple.
                                # Nothing could have been using it here in the first place, so there's nothing to break.
                                requires_feature @fold @transform(op: "count") @filter(op: "=", value: ["$zero"]) {
                                    valid_for_current_target @filter(op: "=", value: ["$false"])
                                }
                            }
                        }
                    }
                }
            }
        }
    }"#,
    arguments: {
        "public": "public",
        "true": true,
        "false": false,
        "zero": 0,
    },
    error_message: "A method or associated function now requires additional CPU target features to be enabled. Calling it without an unsafe block now requires enabling that additional function.",
    per_result_error_template: Some("{{name}}::{{method_name}} requires {{new_feature}} in {{span_filename}}:{{span_begin_line}}"),
    witness: None,
)