err / antq

Point out your outdated dependencies.

Antq

Point out your outdated dependencies.

Supported files

• deps.edn (Clojure CLI)

• shadow-cljs.edn (Shadow-cljs)

• project.clj (Leiningen)

• build.boot (Boot)

• pom.xml (Maven)

• .github/workflows/*.yml (GitHub Actions)

Usage

Clojure CLI Tool

Run the following command for trial.

clojure -Sdeps '{:deps {antq/antq {:mvn/version "RELEASE"}}}' -m antq.core

Or add following alias to your $HOME/.clojure/deps.edn.

{
 :aliases
 {:outdated {:extra-deps {antq/antq {:mvn/version "RELEASE"}}
             :main-opts ["-m" "antq.core"]}}
 }

Then, run clojure -A:outdated.

Leiningen

Add following dependency and alias to your $HOME/.lein/profiles.clj.

{
 :user
 {:dependencies [[antq/antq "RELEASE"]]
  :aliases {"outdated" ["run" "-m" "antq.core"]}
  }
 }

Then, run lein outdated.

GitHub Actions

Antq can work with GitHub Actions. See antq’s workflow for concrete example.

• .github/workflows/dependencies.yml

• To show errors as annotations, please set this option: --error-format="::error file={{file}}::{{message}}"

Options

--exclude=ARTIFACT_NAME

Skip version cheking for specified artifacts. E.g. --exclude=antq/antq

Note	You must specify groupId/artifactId for Java dependencies.

--error-format=ERROR_FORMAT

Customize outputs for outdated dependencies. E.g. --error-format="::error file={{file}}::{{message}}"

You can use following variables:

Variable Name	Description
{{file}}	A filename containing outdated dependencies.
{{name}}	The artifact name.
{{version}}	The current version.
{{latest-version}}	The latest version.
{{message}}	Default error message.

--reporter=REPORTER

Reporter Name	Description
table (default)	Report results in a table.
format	Report results with a custom format. When you use --error-format option, this reporter will be used automatically.
json	Report resulta as a JSON format.
edn	Report resulta as a EDN format.

Tips

Maven S3 repos

Antq supports Maven S3 repositories as same as tools.deps. To use Maven S3 repositories, add repositories to your project configration.

Please see tools.deps documents documents for AWS S3 credentials.

Clojure CLI Tool (deps.edn)

{:deps {...}
 :mvn/repos {"my-private-repo" {:url "s3://my-bucket/maven/releases"}}

Leiningen (project.clj)

(defproject foo "0.1.0-SNAPSHOT"
  :dependencies [...]
  :repositories [["my-private-repo" {:url "s3://my-bucket/maven/releases"}]])

Boot (build.boot)

(set-env!
  :repositories #(conj % '["my-private-repo" {:url "s3://my-bucket/maven/releases"}]))

Avoid SLF4J warnings

antq does not load org.slf4j.impl.StaticLoggerBinder by default, so you may get following messages depending on the project.

SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

To avoid this message, add the following to your dependency.

org.slf4j/slf4j-nop {:mvn/version "RELEASE"}

License

Copyright © 2020 Masashi Iizuka

This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which is available at http://www.eclipse.org/legal/epl-2.0.

This Source Code may also be made available under the following Secondary Licenses when the conditions for such availability set forth in the Eclipse Public License, v. 2.0 are satisfied: GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version, with the GNU Classpath Exception which is available at https://www.gnu.org/software/classpath/license.html.