Skip to content
BETAGuardrails are in beta. The library, the configuration format and the CLI command can still change.

Guardrails / clojure

No dependencies on a local root

clojure/no-local-dependencies@v1

No dependency is taken from a :local/root, so the build resolves everything from this commit rather than from the machine it runs on.

Idclojure/no-local-dependencies
Versionv1
Categoryclojure
Default severitywarning
Interpreterpython3
Timeout30 seconds
Violations tolerated0
Collectsclojure

Collectors

This guardrail gathers nothing itself. It depends on the collectors below, which the CLI runs once per build before any check, and reads what they found out of GUARDRAIL_FACTS. A collector that collects nothing skips this guardrail rather than failing it.

CollectorGathersInputs it is given
clojureThe Clojure build in the project directory: which tool it uses, the Clojure version it depends on, the source paths and aliases it declares, the repositories it resolves from, and every dependency with its alias, origin and whether it is pinned.projectDir

The inputs above are this guardrail's own, passed straight through. Configuring one in buildnote.json changes what is collected, and two guardrails configured the same way share the one collection.

Configuration

json
{
  "guardrails": {
      "failOn": "error",
      "comment": true,
      "checks": [
          {
              "use": "clojure/no-local-dependencies@v1",
              "severity": "warning",
              "with": {
                  "projectDir": "."
              },
              "exemptions": []
          }
      ]
  }
}

Inputs

InputDescriptionDefaultEnvironment variable
projectDirDirectory holding the project, relative to the directory the CLI runs in..GUARDRAIL_INPUT_PROJECTDIR

How to fix

Publish the library and depend on the published coordinates, or bring its source into the checkout:

clojure
{:deps {acme/queue {:mvn/version "1.4.0"}}}

A :local/root builds from a directory outside the checkout, so the build works on the laptop that happens to have that directory beside it and either fails or compiles different code anywhere else.

More in clojure

  • clojure/dependencies-pinned. Every dependency the manifests declare names one released version, or the exact commit a git dependency builds from.
  • clojure/repositories-allowed. Every Maven repository the manifest adds beyond the defaults resolves from a host on the allowed list.
  • clojure/version-declared. The project depends on the Clojure release it is built against, and that release is no older than the configured floor.

All 4 clojure guardrails

Buildnote Limited
Registered in England and Wales, Reg: 16140412