calc-basis

Usage: (calc-basis master-edn)
       (calc-basis master-edn {:keys [resolve-args classpath-args], :as argmaps})

Calculates and returns the runtime basis from a master deps edn map, modifying
 resolve-deps and make-classpath args as needed.

  master-edn - a master deps edn map
  args - an optional map of arguments to constituent steps, keys:
    :resolve-args - map of args to resolve-deps, with possible keys:
      :extra-deps
      :override-deps
      :default-deps
      :threads - number of threads to use during deps resolution
      :trace - flag to record a trace log
    :classpath-args - map of args to make-classpath-map, with possible keys:
      :extra-paths
      :classpath-overrides

Returns the runtime basis, which is the initial deps edn map plus these keys:
  :resolve-args - the resolve args passed in, if any
  :classpath-args - the classpath args passed in, if any
  :libs - lib map, per resolve-deps
  :classpath - classpath map per make-classpath-map
  :classpath-roots - vector of paths in classpath order

combine-aliases

Usage: (combine-aliases edn-map alias-kws)

Find, read, and combine alias maps identified by alias keywords from
a deps edn map into a single args map.

create-basis

Usage: (create-basis {:keys [aliases], :as params})

Create a basis from a set of deps sources and a set of aliases. By default, use
root, user, and project deps and no argmaps (essentially the same classpath you get by
default from the Clojure CLI).

Each dep source value can be :standard, a string path, a deps edn map, or nil.
Sources are merged in the order - :root, :user, :project, :extra.

Aliases refer to argmaps in the merged deps that will be supplied to the basis
subprocesses (tool, resolve-deps, make-classpath-map).

The following subprocess argmap args can be provided:
  Key                  Subproc             Description
  :replace-deps        tool                Replace project deps
  :replace-paths       tool                Replace project paths
  :extra-deps          resolve-deps        Add additional deps
  :override-deps       resolve-deps        Override coord of dep
  :default-deps        resolve-deps        Provide coord if missing
  :extra-paths         make-classpath-map  Add additional paths
  :classpath-overrides make-classpath-map  Replace lib path in cp

Options:
  :root    - dep source, default = :standard
  :user    - dep source, default = :standard
  :project - dep source, default = :standard ("./deps.edn")
  :extra   - dep source, default = nil
  :aliases - coll of aliases of argmaps  to apply to subprocesses

Returns a runtime basis, which is the initial merged deps edn map plus these keys:
 :resolve-args - the resolve args passed in, if any
 :classpath-args - the classpath args passed in, if any
 :libs - lib map, per resolve-deps
 :classpath - classpath map per make-classpath-map
 :classpath-roots - vector of paths in classpath order

create-edn-maps

Usage: (create-edn-maps {:keys [root user project extra], :as params, :or {root :standard, user :standard, project :standard}})

Create a set of edn maps from the standard dep sources and return
them in a map with keys :root :user :project :extra

find-edn-maps

Usage: (find-edn-maps)
       (find-edn-maps project-edn-file)

Finds and returns standard deps edn maps in a map with keys
  :root-edn, :user-edn, :project-edn
If no project-edn is supplied, use the deps.edn in current directory

join-classpath

Usage: (join-classpath roots)

Takes a coll of string classpath roots and creates a platform sensitive classpath

lib-location

Usage: (lib-location lib coord deps-config)

Find the file path location of where a lib/coord would be located if procured
without actually doing the procuring!

make-classpath

Usage: (make-classpath lib-map paths classpath-args)

Takes a lib map, and a set of explicit paths. Extracts the paths for each chosen
lib coordinate, and assembles a classpath string using the system path separator.
The classpath-args is a map with keys that can be used to modify the classpath
building operation:

  :extra-paths - extra classpath paths to add to the classpath
  :classpath-overrides - a map of lib to path, where path is used instead of the coord's paths

Returns the classpath as a string.

Specs:
  Args: (fspec
          :args
          (cat
           :libs :clojure.tools.deps.alpha.specs/lib-map
           :paths :clojure.tools.deps.alpha.specs/paths
           :classpath-args :clojure.tools.deps.alpha.specs/classpath-args)
          :ret
          string?
          :fn
          nil)
  Ret:  (fspec
          :args
          (cat
           :libs :clojure.tools.deps.alpha.specs/lib-map
           :paths :clojure.tools.deps.alpha.specs/paths
           :classpath-args :clojure.tools.deps.alpha.specs/classpath-args)
          :ret
          string?
          :fn
          nil)

make-classpath-map

Usage: (make-classpath-map deps-edn-map lib-map classpath-args)

Takes a merged deps edn map and a lib map. Extracts the paths for each chosen
lib coordinate, and assembles a classpath map. The classpath-args is a map with
keys that can be used to modify the classpath building operation:
  :extra-paths - extra classpath paths to add to the classpath
  :classpath-overrides - a map of lib to path, where path is used instead of the coord's paths

Returns a map:
  :classpath map of path entry (string) to a map describing where its from,  either a :lib-name or :path-key entry.
  :classpath-roots coll of the classpath keys in classpath order

Specs:
  Args: (fspec
          :args
          (cat
           :deps :clojure.tools.deps.alpha.specs/deps-map
           :libs :clojure.tools.deps.alpha.specs/lib-map
           :classpath-args :clojure.tools.deps.alpha.specs/claspath-args)
          :ret
          map?
          :fn
          nil)
  Ret:  (fspec
          :args
          (cat
           :deps :clojure.tools.deps.alpha.specs/deps-map
           :libs :clojure.tools.deps.alpha.specs/lib-map
           :classpath-args :clojure.tools.deps.alpha.specs/claspath-args)
          :ret
          map?
          :fn
          nil)

merge-edns

Usage: (merge-edns deps-edn-maps)

Merge multiple deps edn maps from left to right into a single deps edn map.

prep-libs!

Usage: (prep-libs! lib-map {:keys [action current log], :or {current false}} config)

Takes a lib map and looks for unprepped libs, optionally prepping them.

Options:
  :action - what to do when an unprepped lib is found, one of:
              :prep - if unprepped, prep
              :force - prep regardless of whether already prepped
              :error (default) - don't prep, error
  :current - boolean, default = false. Whether to prep current project
  :log -  print to console based on log level (default, no logging):
            :info  - print only when prepping
            :debug - :info + print for each lib considered

print-tree

Usage: (print-tree lib-map)

Print lib-map tree to the console

resolve-deps

Usage: (resolve-deps deps-map args-map)

Takes a deps configuration map and resolves the transitive dependency graph
from the initial set of deps. args-map is a map with several keys (all
optional) that can modify the results of the transitive expansion:

  :extra-deps - a map from lib to coord of deps to add to the main deps
  :override-deps - a map from lib to coord of coord to use instead of those in the graph
  :default-deps - a map from lib to coord of deps to use if no coord specified
  :trace - boolean. If true, the returned lib map will have metadata with :trace log
  :threads - long. If provided, sets the number of concurrent download threads

Returns a lib map (map of lib to coordinate chosen).

Specs:
  Args: (fspec
          :args
          (cat
           :deps :clojure.tools.deps.alpha.specs/deps-map
           :options :clojure.tools.deps.alpha.specs/resolve-args)
          :ret
          :clojure.tools.deps.alpha.specs/lib-map
          :fn
          nil)
  Ret:  (fspec
          :args
          (cat
           :deps :clojure.tools.deps.alpha.specs/deps-map
           :options :clojure.tools.deps.alpha.specs/resolve-args)
          :ret
          :clojure.tools.deps.alpha.specs/lib-map
          :fn
          nil)

root-deps

Usage: (root-deps)

Read the root deps.edn resource from the classpath at the path
clojure/tools/deps/deps.edn

slurp-deps

Usage: (slurp-deps dep-file)

Read a single deps.edn file from disk and canonicalize symbols,
return a deps map. If the file doesn't exist, returns nil.

tool

Usage: (tool project-edn tool-args)

Transform project edn for tool by applying tool args (keys = :paths, :deps) and
returning an updated project edn.

user-deps-path

Usage: (user-deps-path)

Use the same logic as clj to calculate the location of the user deps.edn.
Note that it's possible no file may exist at this location.

::alias

keyword?

::aliases

(map-of ::alias any?)

::classpath

string?

::classpath-args

(keys :opt-un [::classpath-overrides ::extra-paths])

::classpath-overrides

(map-of ::lib ::path)

::coord

(nilable (or :mvn :mvn/coord :local :local/coord :git :git/coord))

::default-deps

(map-of ::lib ::coord)

::dependents

(coll-of ::lib)

::deps

(map-of ::lib ::coord)

::deps-map

(keys
 :opt [:mvn/repos :mvn/local-repo :tools/usage :deps/prep-lib]
 :opt-un [::paths ::deps ::aliases])

::exec-args

(nilable map?)

::extra-deps

(map-of ::lib ::coord)

::extra-paths

(coll-of ::path-ref :into [] :kind vector?)

::lib

symbol?

::lib-map

(map-of ::lib ::resolved-coord)

::ns-aliases

(map-of simple-symbol? simple-symbol?)

::ns-default

simple-symbol?

::override-deps

(map-of ::lib ::coord)

::path

string?

::path-ref

(or :path ::path :alias ::alias)

::paths

(coll-of ::path-ref :into [] :kind vector?)

::replace-deps

(map-of ::lib ::coord)

::replace-paths

(coll-of ::path-ref :into [] :kind vector?)

::repo

(nilable (keys :opt-un [::url :mvn/releases :mvn/snapshots]))

::repo-id

string?

::resolve-args

(keys :opt-un [::extra-deps ::override-deps ::default-deps])

::resolved-coord

(merge ::coord (keys :opt-un [:aliased/paths ::dependents]))

::threads

pos-int?

::tool-args

(keys :opt-un [::replace-deps ::replace-paths ::deps ::paths])

::trace

boolean?

::url

string?

install-tool

Usage: (install-tool lib coord as)

Procure the lib+coord, install the tool to the user tools dir (with lib, coord)

list-tools

Usage: (list-tools)

Return seq of available tool names

remove-tool

Usage: (remove-tool tool)

Removes tool installation, if it exists. Returns true if it exists and was deleted.

resolve-tool

Usage: (resolve-tool tool)

Resolve a tool by name, look up and return:
{:lib lib
 :coord coord}
Or nil if unknown.

usage

Usage: (usage tool)

Resolve a tool and return it's usage data, which may be nil.
Throws ex-info if tool is unknown.

calc-trace

Usage: (calc-trace)
       (calc-trace opts)

Like calc-basis, but create and return the dep expansion trace. The trace
can be passed to trace->tree to get tree data.

The opts map includes the same opts accepted by clojure.tools.deps.alpha/create-basis.
By default, uses the   root, user, and project deps and no argmaps (essentially the same
classpath you get by default from the Clojure CLI).

Each dep source value can be :standard, a string path, a deps edn map, or nil.
Sources are merged in the order - :root, :user, :project, :extra.

Aliases refer to argmaps in the merged deps that will be supplied to the basis
subprocesses (tool, resolve-deps, make-classpath-map).

Options:
  :root    - dep source, default = :standard
  :user    - dep source, default = :standard
  :project - dep source, default = :standard ("./deps.edn")
  :extra   - dep source, default = nil
  :aliases - coll of aliases of argmaps to apply to subprocesses

print-tree

Usage: (print-tree tree {:keys [indent], :or {indent 2}, :as opts})
       (print-tree {:keys [children], :as tree} indented opts)

Print the tree to the console.
Options:
  :indent    Indent spacing (default = 2)
  :hide-libs Set of libs to ignore as deps under top deps, default = #{org.clojure/clojure}

trace->tree

Usage: (trace->tree trace)

Convert a deps trace data structure into a deps tree.

A deps tree has the structure of the full dependency expansion.
Each node of the tree is a map from lib to coord-info with at least these keys:
  :lib - library symbol
  :coord - the coord map that was used (may not be the original coord if replaced
           due to default-deps or override-deps)
  :include - boolean of whether this node is included in the returned deps
  :reason - why the node was or was not included
  :children - vector of child nodes