deps-infer

Infer mvn deps from sources.

Status

Proof of concept, subject to change. Improvements welcome!

Use cases

This tool can be used to:

Make implicit deps explicit
Check which deps you are not using by comparing the output with your existing deps.edn
Port a lein project.clj or boot build.boot to deps.edn
Port scripts (e.g. babashka scripts) to a deps.edn project.
Migrate from git deps to mvn deps
Check if there is a newer version available

Run

$ clojure -M -m deps-infer.main

This will index your .m2/repository and will analyze your sources under src and test.

By default it will write the analysis output on a .deps-infer/ inside the --repo directory. You can change the location using the --cache-dir option.

After that it will suggest a list of dependencies that you can add to your deps.edn. It will always pick the newest version that is available in your .m2 repo.

For this project it will print:

babashka/fs {:mvn/version "0.0.1"}
clj-kondo/clj-kondo {:mvn/version "2021.02.13"}
org.clojure/clojure {:mvn/version "1.10.3-rc1"}
org.clojure/tools.cli {:mvn/version "1.0.194"}
version-clj/version-clj {:mvn/version "2.0.1"}

Namespaces that cannot be resolved will cause a warning to be printed:

$ cat corpus/non_existing.clj
(ns non-existing
  (:require [foo.bar :as x]))

$ clojure -M -m deps-infer.main --analyze corpus/non_existing.clj
WARNING: no dep found for foo.bar

CLI options

--repo: The location of the mvn repo.
--analyze: The file, directory or directories of sources to analyze. You can combine multiple files and directories using the OS-specific path separator: src:test.
--snapshots: Suggest SNAPSHOT versions.

Possible improvements

PRs welcome.

Download an index of all of Clojars for inferencing of deps that are not in your local .m2/repository. This index must be kept up to date, e.g. daily, and be committed to some git repo where we can then fetch it.

Troubleshooting

To re-index your repo, remove the index of namespaces to jars, run:

$ rm -rf .work/index.edn

and then run this tool again.

Credits

hiredman for coming up with the idea.

License

Distributed under the EPL License. See LICENSE.

borkdude/deps-infer