Skip to content

Add setting clippy_output_diagnostics to match rustc_output_[...] #3528

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions rust/private/BUILD.bazel
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ bzl_library(
":rules_cc_bzl_lib",
"//rust/platform:bzl_lib",
"@bazel_skylib//lib:paths",
"@bazel_skylib//lib:structs",
"@bazel_skylib//rules:common_settings",
],
)
Expand Down
51 changes: 48 additions & 3 deletions rust/private/clippy.bzl
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,15 @@

"""A module defining clippy rules"""

load("@bazel_skylib//lib:structs.bzl", "structs")
load("//rust/private:common.bzl", "rust_common")
load("//rust/private:providers.bzl", "CaptureClippyOutputInfo", "ClippyInfo", "LintsInfo")
load(
"//rust/private:providers.bzl",
"CaptureClippyOutputInfo",
"ClippyInfo",
"ClippyOutputDiagnosticsInfo",
"LintsInfo",
)
load(
"//rust/private:rustc.bzl",
"collect_deps",
Expand Down Expand Up @@ -146,6 +153,13 @@ def _clippy_aspect_impl(target, ctx):
"_clippy_error_format" if use_clippy_error_format else "_error_format",
)

clippy_diagnostics = None
if ctx.attr._clippy_output_diagnostics[ClippyOutputDiagnosticsInfo].output_diagnostics:
clippy_diagnostics = ctx.actions.declare_file(ctx.label.name + ".clippy.diagnostics", sibling = crate_info.output)
crate_info_dict = structs.to_dict(crate_info)
crate_info_dict["rustc_output"] = clippy_diagnostics
crate_info = rust_common.create_crate_info(**crate_info_dict)

args, env = construct_arguments(
ctx = ctx,
attr = ctx.rule.attr,
Expand All @@ -165,6 +179,7 @@ def _clippy_aspect_impl(target, ctx):
build_flags_files = build_flags_files,
emit = ["dep-info", "metadata"],
skip_expanding_rustc_env = True,
use_json_output = bool(clippy_diagnostics),
error_format = error_format,
)

Expand Down Expand Up @@ -217,7 +232,7 @@ def _clippy_aspect_impl(target, ctx):
ctx.actions.run(
executable = ctx.executable._process_wrapper,
inputs = compile_inputs,
outputs = [clippy_out],
outputs = [clippy_out] + [x for x in [clippy_diagnostics] if x],
env = env,
tools = [toolchain.clippy_driver],
arguments = args.all,
Expand All @@ -226,8 +241,12 @@ def _clippy_aspect_impl(target, ctx):
toolchain = "@rules_rust//rust:toolchain_type",
)

output_group_info = {"clippy_checks": depset([clippy_out])}
if clippy_diagnostics:
output_group_info["clippy_output"] = depset([clippy_diagnostics])

return [
OutputGroupInfo(clippy_checks = depset([clippy_out])),
OutputGroupInfo(**output_group_info),
ClippyInfo(output = depset([clippy_out])),
]

Expand Down Expand Up @@ -255,6 +274,10 @@ rust_clippy_aspect = aspect(
doc = "Arguments to pass to clippy",
default = Label("//rust/settings:clippy_flags"),
),
"_clippy_output_diagnostics": attr.label(
doc = "Value of the `clippy_output_diagnostics` build setting",
default = "//rust/settings:clippy_output_diagnostics",
),
"_config": attr.label(
doc = "The `clippy.toml` file used for configuration",
allow_single_file = True,
Expand Down Expand Up @@ -395,3 +418,25 @@ capture_clippy_output = rule(
implementation = _capture_clippy_output_impl,
build_setting = config.bool(flag = True),
)

def _clippy_output_diagnostics_impl(ctx):
"""Implementation of the `clippy_output_diagnostics` rule

Args:
ctx (ctx): The rule's context object

Returns:
list: A list containing the CaptureClippyOutputInfo provider
"""
return [ClippyOutputDiagnosticsInfo(output_diagnostics = ctx.build_setting_value)]

clippy_output_diagnostics = rule(
doc = (
"Setting this flag from the command line with `--@rules_rust//rust/settings:clippy_output_diagnostics` " +
"makes rules_rust save lippy json output (suitable for consumption by rust-analyzer) in a file, " +
"available from the `clippy_output` output group. This is the clippy equivalent of " +
"`@rules_rust//settings:rustc_output_diagnostics`."
),
implementation = _clippy_output_diagnostics_impl,
build_setting = config.bool(flag = True),
)
5 changes: 5 additions & 0 deletions rust/private/providers.bzl
Original file line number Diff line number Diff line change
Expand Up @@ -135,6 +135,11 @@ CaptureClippyOutputInfo = provider(
fields = {"capture_output": "Value of the `capture_clippy_output` build setting"},
)

ClippyOutputDiagnosticsInfo = provider(
doc = "Value of the `clippy_output_diagnostics` build setting",
fields = {"output_diagnostics": "Value of the `clippy_output_diagnostics` build setting"},
)

ClippyInfo = provider(
doc = "Provides information on a clippy run.",
fields = {
Expand Down
3 changes: 3 additions & 0 deletions rust/settings/BUILD.bazel
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ load(
"clippy_error_format",
"clippy_flag",
"clippy_flags",
"clippy_output_diagnostics",
"clippy_toml",
"codegen_units",
"error_format",
Expand Down Expand Up @@ -58,6 +59,8 @@ clippy_flag()

clippy_flags()

clippy_output_diagnostics()

clippy_toml()

codegen_units()
Expand Down
15 changes: 15 additions & 0 deletions rust/settings/settings.bzl
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ load(
_capture_clippy_output = "capture_clippy_output",
_clippy_flag = "clippy_flag",
_clippy_flags = "clippy_flags",
_clippy_output_diagnostics = "clippy_output_diagnostics",
)
load("//rust/private:lto.bzl", "rust_lto_flag")
load(
Expand Down Expand Up @@ -331,6 +332,20 @@ def rustc_output_diagnostics():
visibility = ["//visibility:public"],
)

# buildifier: disable=unnamed-macro
def clippy_output_diagnostics():
"""A flag to enable the `clippy_output_diagnostics` setting.

If this flag is true, rules_rust will save clippy json output (suitable for consumption
by rust-analyzer) in a file, available from the `clippy_output` output group. This is the
clippy equivalent of `rustc_output_diagnostics`.
"""
_clippy_output_diagnostics(
name = "clippy_output_diagnostics",
build_setting_default = False,
visibility = ["//visibility:public"],
)

# buildifier: disable=unnamed-macro
def clippy_flags():
"""This setting may be used to pass extra options to clippy from the command line.
Expand Down
23 changes: 21 additions & 2 deletions test/unit/clippy/clippy_test.bzl
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@

load("@bazel_skylib//lib:unittest.bzl", "analysistest")
load("//rust:defs.bzl", "rust_clippy_aspect")
load("//test/unit:common.bzl", "assert_argv_contains", "assert_list_contains_adjacent_elements")
load("//test/unit:common.bzl", "assert_argv_contains", "assert_argv_contains_prefix_suffix", "assert_list_contains_adjacent_elements")

def _find_clippy_action(actions):
for action in actions:
if action.mnemonic == "Clippy":
return action
fail("Failed to find Clippy action")

def _clippy_aspect_action_has_flag_impl(ctx, flags):
def _clippy_aspect_action_has_flag_impl(ctx, flags, *, prefix_suffix_flags = []):
env = analysistest.begin(ctx)
target = analysistest.target_under_test(env)

Expand All @@ -23,6 +23,8 @@ def _clippy_aspect_action_has_flag_impl(ctx, flags):
clippy_action,
flag,
)
for (prefix, suffix) in prefix_suffix_flags:
assert_argv_contains_prefix_suffix(env, clippy_action, prefix, suffix)

clippy_checks = target[OutputGroupInfo].clippy_checks.to_list()
if len(clippy_checks) != 1:
Expand Down Expand Up @@ -123,6 +125,17 @@ clippy_aspect_with_clippy_error_format_test = make_clippy_aspect_unittest(
},
)

clippy_aspect_with_output_diagnostics_test = make_clippy_aspect_unittest(
lambda ctx: _clippy_aspect_action_has_flag_impl(
ctx,
["--error-format=json", "--output-file"],
prefix_suffix_flags = [("", "/ok_library.clippy.diagnostics")],
),
config_settings = {
str(Label("//rust/settings:clippy_output_diagnostics")): True,
},
)

def clippy_test_suite(name):
"""Entry-point macro called from the BUILD file.

Expand Down Expand Up @@ -165,6 +178,11 @@ def clippy_test_suite(name):
target_under_test = Label("//test/clippy:ok_library"),
)

clippy_aspect_with_output_diagnostics_test(
name = "clippy_aspect_with_output_diagnostics_test",
target_under_test = Label("//test/clippy:ok_library"),
)

native.test_suite(
name = name,
tests = [
Expand All @@ -176,5 +194,6 @@ def clippy_test_suite(name):
":test_clippy_aspect_with_explicit_flags_test",
":clippy_aspect_without_clippy_error_format_test",
":clippy_aspect_with_clippy_error_format_test",
":clippy_aspect_with_output_diagnostics_test",
],
)