Point out your outdated dependencies.
Note
|
Antq requires Clojure 1.9.0 or later. |
File | Tool/Service | Note |
---|---|---|
deps.edn |
||
shadow-cljs.edn |
||
project.clj |
Provides 2 ways of program and plug-in. |
|
build.boot |
||
pom.xml |
||
.github/workflows/*.yml |
||
bb.edn |
||
build.gradle |
Experimental. |
Run the following command for trial.
clojure -Sdeps '{:deps {com.github.liquidz/antq {:mvn/version "RELEASE"}}}' -M -m antq.core
Or add the following alias to your $HOME/.clojure/deps.edn
.
{
:aliases
{:outdated {:extra-deps {com.github.liquidz/antq {:mvn/version "RELEASE"}}
:main-opts ["-m" "antq.core"]}}
}
Then, run clojure -M:outdated
.
(run clojure -A:outdated
for Clojure CLI Tool 1.10.1.645 or earlier).
From Clojure CLI ver 1.10.3.933
, tool installation is supported.
# install
clojure -Ttools install com.github.liquidz/antq '{:git/tag "1.3.1"}' :as antq
# uninstall
clojure -Ttools remove :tool antq
# execute
clojure -Tantq outdated
# execute with parameter
clojure -Tantq outdated :upgrade true
# help
clojure -A:deps -Tantq help/doc
Add the following dependency and alias to your $HOME/.lein/profiles.clj
.
{
:user
{:dependencies [[com.github.liquidz/antq "RELEASE"]]
:aliases {"outdated" ["run" "-m" "antq.core"]}
}
}
Then, run lein outdated
.
The Leiningen plugin is a newer offering. It tends to be more accurate (since it won’t parse your project.clj, having it evaluated by Leiningen instead).
However the :upgrade
option will not be supported (since the plugin cannot always know if a given dependency came from a specific profile, middleware, etc).
In order to use it, add the following plugin to your project.clj
(or $HOME/.lein/profiles.clj
):
:plugins [[com.github.liquidz/antq "RELEASE"]]
;; optional - you can add antq options here:
:antq {}
Then, run lein antq
.
Antq can work with GitHub Actions. See antq’s workflow for concrete example.
-
To show errors as annotations, please set this option:
--error-format="::error file={{file}}::{{message}}"
In another way, you can use the following action.
Upgrade outdated versions interactively.
You can use --force
option for upgrading without confirmation.
Warning
|
For now,
|
Skip version checking for specified artifacts or versions.
E.g.
# Exclude all versions of specified artifact
--exclude=com.github.liquidz/antq
# Exclude specific version of specified artifact
--exclude=com.github.liquidz/[email protected]
When you specified a version number, antq will report the latest version excluding only the specified version.
Note
|
You must specify groupId/artifactId for Java dependencies.
|
Add search path for projects.
Current directory(.
) is added by default.
E.g. -d foo --directory=bar:baz
will search "foo", "baz" and "bar" directories.
Focus version checking for specified artifacts.
E.g. --focus=com.github.liquidz/antq
Note
|
You must specify groupId/artifactId for Java dependencies.
|
Warning
|
focus option is prefer than exclude option.
|
Skip to search specified project files.
Must be one of boot
, clojure-cli
, github-action
, pom
, shadow-cljs
and leiningen
.
E.g. --skip=pom
Customize outputs for outdated dependencies.
E.g. --error-format="::error file={{file}}::{{message}}"
You can use following variables:
Variable Name | Description |
---|---|
|
A filename containing outdated dependencies. |
|
The artifact name. |
|
The current version. |
|
The latest version. |
|
The latest artifact name. See details: Clojars Verified Group Names policy. |
|
The diff URL for Version Control System. (Nullable) |
|
Default error message. |
-
clojure-dependency-update-action: A simple GitHub Actions to create Pull Requests for outdated tools.deps dependencies
Copyright © 2020-2021 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.