Clojure Q&A - Recent questions tagged tools.tools

tools.tools install-latest throws sha error with :coord and never upgrades with :tool

Mon, 13 May 2024 10:24:47 +0000

Thanks for https://clojure.atlassian.net/browse/TDEPS-253, however I noticed it doesn't quite work as expected for a fresh install (with :coord); I get an error due to a missing sha, contrary to the doc string "git coords may omit sha".

clj -Ttools install-latest \
:lib org/tool-name \
:coord '{:git/url "git@gitlab.int.org.com:group/subgroup/tool-name.git"}' \
:as tool-name

=>
Execution error (ExceptionInfo) at clojure.tools.deps.extensions.git/eval1656$fn (git.clj:79).
Library org/tool-name has coord with missing sha

I also found upgrading a tool with saved coordinates (clj -Ttools install-latest :tool tool-name) always results in "Skipping, newest installed" (because passing the coord returned by parse-install-latest-args to install-1 means ext/find-all-versions is never evaluated). Looks like this issue would affect tools with auto resolved git urls too.

install-latest does not use coords to find versions in self-hosted git

Tue, 15 Aug 2023 11:11:52 +0000

clojure.tools.tools.api/install-latest (and clojure.tools.tools.api/install-1) don't pass the coord returned by clojure.tools.deps.tool/resolve-tool to clojure.tools.deps.extensions/find-all-versions.

This means it will never find versions for git libs hosted anywhere that isn't supported by clojure.tools.deps.extensions.git/auto-git-url.

It would be great if this was changed to support updating tools from non-standard git hosts.

Make tools help more discoverable

Wed, 27 Oct 2021 17:17:27 +0000

Although the documentation does mention help/doc and help/dir, it's not obvious for users how to get help on tools unless they read the entire doc page carefully.

It would help users figure out how to use tools if the -Ttools functions were a bit more verbose and suggested how to get help.

I don't think much can be done about this:

$ clojure -Ttools
No function found on command line or in :exec-fn

but adding a help function would mean that the next thing a user might try could work:

$ clojure -Ttools help
Namespace clojure.tools.tools.api loaded but function not found: help

Telling users that the following can be used to get a list of available functions or to get more expansive help would guide them to the next function to use:

$ clojure -A:deps -Ttools help/dir
install
list
remove
show
$ clojure -A:deps -Ttools help/doc
...

In addition, the list function could suggest how to get help on a specific, installed tool:

$ clojure -Ttools list
TOOL     LIB                              TYPE  VERSION
clj-new  com.github.seancorfield/clj-new  :git  v1.2.362
new      io.github.seancorfield/deps-new  :git  v0.4.0
nvd      io.github.rm-hull/nvd-clojure    :git  4b0c448
poly     io.github.polyfy/polylith        :git  768642a
tools    io.github.clojure/tools.tools    :git  v0.2.1
# add the following (arbitrarily picking the first one, perhaps):
For help with a specific tool, e.g., clj-new:
    clojure -A:deps -Tclj-new help/doc

The same could be added to the show function.

List SHA if version tag not available in clj -Ttools list

Mon, 11 Oct 2021 03:29:20 +0000

If I install a clojure tool with a git SHA, in contrast to using a git tag, and then I do clj -Ttools list, the Version column in the output is empty. It would be helpful if the SHA is displayed in the case where there is no version tag.

help/doc would be useful for -Ttools

Wed, 14 Jul 2021 03:26:54 +0000

Although you can clojure -Ttools show :tool something, you don't get much information back about it and you can't use the new -X:deps help/doc on it because it isn't loaded via an alias.

Please add help/doc and help/dir to -Ttools so that it is easier to get help/documentation for the installed tools.