Use antq as a library

[tengstrand]

Hi!

I'm considering using antq within the poly tool.

If we let the poly tool execute the libs command, it returns all the used libraries in the workspace, e.g.:

My idea is to allow the user to also show the column outdated that will be populated if the library is out of date, by using antq internally.

I haven't digged into the code so much yet, but is it possible to use antq as a library, and let it return a data structure with all the outdated libraries, when called?

[liquidz]

@tengstrand Sorry for late reaction.

is it possible to use antq as a library

Unfortunately no for now.
But it should be, so I'd like to add some APIs :)

[pmonks]

@tengstrand I'm (ab)using antq as a library here. It seems to work ok, despite being a little kludgy due to the entry points and args not being as well-defined as one might expect in a "real" library.

[liquidz]

antq.core/antq is available, but it has not been organized as an API as you know.
So, I'm considering a new interface based on this function.

[pmonks]

@liquidz I suspect it won't take much, given how close the functionality already is! 🤞

[liquidz]

@tengstrand @pmonks
Now I'm considering the API as follows.

antq/src/antq/api.clj

Lines 31 to 32 in 9c7cc46

	(outdated-deps '{org.clojure/clojure {:mvn/version "1.8.0"}}
	{:no-changes? true}))

The first argument deps-map is a map of the same form as :deps in deps.edn, so it seems easy to specify when used as a library in my opinion.
How about this interface?

[pmonks]

@liquidz from my perspective that looks like a good start, though I think some of the other CLI options may also be handy to have available via the opts map second argument? For example all of the following seem useful:

• ignore-locals
• check-clojure-tools
• transitive - if/when enhancement Option to scan, and report on, outdated transitive dependencies #204 is implemented

I think there also needs to be a separate API that's equivalent to the upgrade CLI option (imvho it makes more sense to implement this as a separate fn in the API, rather than as an opt to outdated-deps - obvs that's not possible via a CLI, but an API can be more expressive).

[liquidz]

@pmonks Thanks for your advice :)

I think some of the other CLI options may also be handy to have available via the opts map second argument

Supported.

antq/src/antq/api.clj

Line 16 in 3414e7e

A CLI options map including additional API options.

I think there also needs to be a separate API that's equivalent to the upgrade CLI option

Added.

antq/src/antq/api.clj

Line 33 in 3414e7e

(defn upgrade-deps!

Could you try dev branch?

[tengstrand]

The new api works really well! Thanks @liquidz

[liquidz]

@tengstrand Thanks for your confirmation!
I just released v2.3.1043 :)

[tengstrand]

Switched to that version. Thanks @liquidz!