Add aliases for built-in linters (#563)

These are equivalent to the aliases for the built-in formatters, and
allow use of these linters without having to use confusing relative repo
names that appear to be relative to the user's module, but are actually
relative to rules_lint.

Ideally the aliases would be `ruff` and `shellcheck`, but those names
are taken by bzl_libraries, hence the 'bin' suffix.

Fixes #551.

Author: calliecameron

docs/ruff.md

@@ -59,7 +59,7 @@ checkstyle = lint_checkstyle_aspect(
 checkstyle_test = lint_test(aspect = checkstyle)
 
 ruff = lint_ruff_aspect(
-    binary = "@multitool//tools/ruff",
+    binary = Label("@aspect_rules_lint//lint:ruff_bin"),
     configs = [
         Label("@//:.ruff.toml"),
         Label("@//src/subdir:ruff.toml"),
@@ -69,7 +69,7 @@ ruff = lint_ruff_aspect(
 ruff_test = lint_test(aspect = ruff)
 
 shellcheck = lint_shellcheck_aspect(
-    binary = "@multitool//tools/shellcheck",
+    binary = Label("@aspect_rules_lint//lint:shellcheck_bin"),
     config = Label("@//:.shellcheckrc"),
 )
 

docs/shellcheck.md

@@ -8,6 +8,17 @@ package(default_visibility = ["//visibility:public"])
 
 exports_files(glob(["*.bzl"]) + ["lint_test.sh"])
 
+# Aliases for the built-in linters
+alias(
+    name = "ruff_bin",
+    actual = "@multitool//tools/ruff",
+)
+
+alias(
+    name = "shellcheck_bin",
+    actual = "@multitool//tools/shellcheck",
+)
+
 # Used as a default for vale_aspect#styles
 filegroup(
     name = "empty_styles",

example/tools/lint/linters.bzl

@@ -2,22 +2,14 @@
 
 Typical usage:
 
-Ruff is provided as a built-in tool by rules_lint. To use the built-in version, first add a dependency on rules_multitool to MODULE.bazel:
-
-```starlark
-bazel_dep(name = "rules_multitool", version = <desired version>)
-
-multitool = use_extension("@rules_multitool//multitool:extension.bzl", "multitool")
-use_repo(multitool, "multitool")
-```
-
-Then create the linter aspect, typically in `tools/lint/linters.bzl`:
+Ruff is provided as a built-in tool by rules_lint. To use the built-in version,
+create the linter aspect, typically in `tools/lint/linters.bzl`:
 
 ```starlark
 load("@aspect_rules_lint//lint:ruff.bzl", "lint_ruff_aspect")
 
 ruff = lint_ruff_aspect(
-    binary = "@multitool//tools/ruff",
+    binary = Label("@aspect_rules_lint//lint:ruff_bin",
     configs = [Label("//:.ruff.toml")],
 )
 ```

lint/BUILD.bazel

@@ -2,22 +2,14 @@
 
 Typical usage:
 
-Shellcheck is provided as a built-in tool by rules_lint. To use the built-in version, first add a dependency on rules_multitool to MODULE.bazel:
-
-```starlark
-bazel_dep(name = "rules_multitool", version = <desired version>)
-
-multitool = use_extension("@rules_multitool//multitool:extension.bzl", "multitool")
-use_repo(multitool, "multitool")
-```
-
-Then create the linter aspect, typically in `tools/lint/linters.bzl`:
+Shellcheck is provided as a built-in tool by rules_lint. To use the built-in version,
+create the linter aspect, typically in `tools/lint/linters.bzl`:
 
 ```starlark
 load("@aspect_rules_lint//lint:shellcheck.bzl", "lint_shellcheck_aspect")
 
 shellcheck = lint_shellcheck_aspect(
-    binary = "@multitool//tools/shellcheck",
+    binary = Label("@aspect_rules_lint//lint:shellcheck_bin",
     config = Label("//:.shellcheckrc"),
 )
 ```