rules_eslint

Hermetic eslint runner — lint a workspace's @npm eslint binary under Bazel

bazel_dep(name = "rules_eslint", version = "0.1.0")

View source & releases on GitHub ↗

Hermetic eslint runner — lint a workspace’s @npm eslint binary under Bazel.

eslint is a Node tool whose binary + plugin/config closure live in your pnpm-lock.yaml. So rules_eslint does not fetch eslint. It gives you a small eslint_test macro that runs your own aspect_rules_js-linked eslint binary over a set of sources as a Bazel test — the same “consumer supplies the binary” shape as rules_storybook and rules_nextjs.

Status: v0.1.0

• eslint_test(name, srcs, eslint_bin, config, ...) — a lint-tagged sh_test that runs eslint_bin --config <config> <srcs>.

Install

.bazelrc:

common --registry=https://registry.fastverk.com/
common --registry=https://bcr.bazel.build/

MODULE.bazel:

bazel_dep(name = "rules_eslint", version = "0.1.0")

Use

You already have eslint in your pnpm-lock.yaml and an @npm repo from aspect_rules_js’s npm_translate_lock. Materialize the eslint binary with the bin factory, then point eslint_test at it:

load("@npm//:eslint/package_json.bzl", eslint_bin = "bin")
load("@rules_eslint//eslint:defs.bzl", "eslint_test")

eslint_bin.eslint_binary(name = "eslint")

eslint_test(
    name = "lint",
    srcs = glob(["**/*.ts", "**/*.tsx"]),
    eslint_bin = ":eslint",
    config = "//:eslint.config.mjs",
)

Run one target, or fan out across the repo:

bazel test //:lint
bazel test //... --test_tag_filters=lint

Because eslint, its plugins, and the flat config all come from your own @npm closure + sources, the test is hermetic and reproducible — no reliance on a node_modules/.bin/eslint on the CI runner.

See examples/smoke for a complete, self-contained workspace.

Usage#

load("@rules_eslint//eslint:defs.bzl", "eslint_test")
load("@smoke_npm//:defs.bzl", "npm_link_all_packages")
load("@smoke_npm//examples/smoke:eslint/package_json.bzl", eslint_bin = "bin")

package(default_visibility = ["//visibility:public"])

npm_link_all_packages(name = "node_modules")

exports_files(["pnpm-lock.yaml"])

# The consumer's own @npm eslint binary — what a real workspace passes to
# `eslint_test`. Here it comes from the pinned smoke npm workspace.
eslint_bin.eslint_binary(name = "eslint_cli")

# Release gate: a real `eslint_test` over a clean source, exercising the
# macro (binary + config + srcs → runfiles → eslint) end-to-end. Runs in
# `bazel test //...` on every CI OS.
eslint_test(
    name = "smoke_test",
    srcs = ["clean.js"],
    config = "eslint.config.mjs",
    eslint_bin = ":eslint_cli",
)

Conformance#

Dependencies#

Depends on

Versions#

1 published version, newest first. Each resolves to an immutable, integrity-checked archive.

Changelog#

← All modules