combine-aliases

Usage: (combine-aliases deps alias-kws)

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

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 {:keys [classpath-overrides extra-paths], :as 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: (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?

print-tree

Usage: (print-tree lib-map)

Print lib-map tree to the console

resolve-deps

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

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

settings is an optional map of settings:
  :trace - boolean. If true, the returned lib map will have metadata with :trace log

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

Specs:
  Args: (cat
         :deps :clojure.tools.deps.alpha.specs/deps-map
         :options :clojure.tools.deps.alpha.specs/resolve-args)
  Ret:  (map-of
          :clojure.tools.deps.alpha.specs/lib
          :clojure.tools.deps.alpha.specs/resolved-coord)

canonicalize

No usage documentation available

Takes a lib and coordinate and returns a canonical form.
For example, a Maven coordinate might resolve LATEST to a version or a Git
coordinate might resolve a partial sha to a full sha. Returns [lib coord].

compare-versions

No usage documentation available

Given two coordinates, use this as a comparator returning a negative number, zero,
or positive number when coord-x is logically 'less than', 'equal to', or 'greater than'
coord-y. The dispatch occurs on the type of x and y.

coord-deps

No usage documentation available

Return coll of immediate [lib coord] external deps for this library.

coord-paths

No usage documentation available

Return coll of classpath roots for this library on disk.

coord-summary

No usage documentation available

Takes a coord, and returns a concise description, used when printing tree

coord-type

Usage: (coord-type coord)

The namespace (as a keyword) of the only qualified key in the coordinate,
excluding the reserved deps namespace.

dep-id

No usage documentation available

Returns an identifier value that can be used to detect a lib/coord cycle while
expanding deps. This will only be called after canonicalization so it can rely
on the canonical form.

detect-manifest

Usage: (detect-manifest dir)

Given a directory, detect the manifest type and return the manifest info.

lib-location

No usage documentation available

Takes a coordinate and returns the location where the lib would be
installed locally. Location keys:

:base     local repo base directory path
:path     path within base dir
:type     coordinate type

manifest-type

No usage documentation available

Takes a lib, a coord, and the root config. Dispatch based on the
coordinate type. Detect and return the manifest type and location
for this coordinate.

find-pom

Usage: (find-pom jar-file)

Find path of pom file in jar file, or nil if it doesn't exist

clojure-env

Returns a map describing the environment known to clj/clojure:
{:config-files [ ... ]}.

DEPRECATED - use (reader/default-deps) instead!

default-deps

Usage: (default-deps)

Use the same logic as clj to build the set of deps.edn files to load.
These can be passed to read-deps to replicate what clj does.

install-deps

Usage: (install-deps)

Read the install deps.edn resource from the classpath

install-deps-path

Resource path to the install deps.edn resource

merge-deps

Usage: (merge-deps deps-maps)

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

read-deps

Usage: (read-deps deps-files)

Read the built-in clojure/tools/deps/deps.edn resource, and a set of deps-files,
and merge them left to right into a single deps map.

slurp-deps

Usage: (slurp-deps dep-file)

Read a single deps.edn file from disk and canonicalize symbols,
return a deps map.

user-deps-location

Usage: (user-deps-location)

Use the same logic as clj to return the expected location of the user
config path. Note that it's possible no file may exist at this location.

-main

Usage: (-main & args)

Main entry point for generating a manifest file.

Required:
  --config-files DEP_FILES - comma-delimited list of deps.edn files to merge
  --config-data={...} - deps.edn as data
  --gen TYPE - manifest type to generate (currently only pom)

Options:
  -Raliases - concated resolve-deps alias names, applied to the :deps
  -Aaliases - concatenated generic alias names

-main

Usage: (-main & args)

Main entry point for generating a manifest file.

Required:
  --config-user PATH - User deps.edn location
  --config-project PATH - Project deps.edn location
  --config-data={...} - deps.edn as data
  --gen TYPE - manifest type to generate (currently only pom)

Options:
  -Raliases - concated resolve-deps alias names, applied to the :deps
  -Aaliases - concatenated generic alias names

-main

Usage: (-main & args)

Main entry point for make-classpath script.

Options:
  --config-files=/install/deps.edn,... - comma-delimited list of deps.edn files to merge
  --config-data={...} - deps.edn as data
  --libs-file=path - libs cache file to write
  --cp-file=path - cp cache file to write
  --jvm-file=path - jvm opts file to write
  --main-file=path - main opts file to write
  -Rresolve-aliases - concatenated resolve-deps alias names
  -Cmakecp-aliases - concatenated make-classpath alias names
  -Jjvmopt-aliases - concatenated jvm-opt alias names
  -Mmain-aliases - concatenated main-opt alias names
  -Aaliases - concatenated generic alias names

Resolves the dependencies and updates the lib, classpath, etc files.
The libs file is at <cachedir>/<resolve-aliases>.libs
The cp file is at <cachedir>/<resolve-aliases>/<cpaliases>.cp

combine-deps-files

Usage: (combine-deps-files {:keys [config-files config-data], :as opts})

Given a configuration for config-files and optional config-data, read
and merge into a combined deps map.

create-classpath

Usage: (create-classpath deps-map {:keys [resolve-aliases makecp-aliases aliases], :as opts})

Given parsed-opts describing the input config files, and aliases to use,
return the output lib map and classpath.

parse-opts

Usage: (parse-opts args)

Parse the command line opts to make-classpath

run

Usage: (run {:keys [libs-file cp-file jvm-file main-file skip-cp resolve-aliases makecp-aliases jvmopt-aliases main-aliases aliases], :as opts})

Run make-classpath script. See -main for details.

-main

Usage: (-main & args)

Main entry point for make-classpath script.

Options:
  --config-user=path - user deps.edn file (usually ~/.clojure/deps.edn)
  --config-project=path - project deps.edn file (usually ./deps.edn)
  --config-data={...} - deps.edn as data (from -Sdeps)
  --libs-file=path - libs cache file to write
  --cp-file=path - cp cache file to write
  --jvm-file=path - jvm opts file to write
  --main-file=path - main opts file to write
  -Rresolve-aliases - concatenated resolve-deps alias names
  -Cmakecp-aliases - concatenated make-classpath alias names
  -Jjvmopt-aliases - concatenated jvm-opt alias names
  -Mmain-aliases - concatenated main-opt alias names
  -Aaliases - concatenated generic alias names

Resolves the dependencies and updates the lib, classpath, etc files.
The libs file is at <cachedir>/<hash>.libs
The cp file is at <cachedir>/<hash>.cp
The main opts file is at <cachedir>/<hash>.main (if needed)
The jvm opts file is at <cachedir>/<hash>.jvm (if needed)

check-aliases

Usage: (check-aliases deps aliases)

Check that all aliases are known and warn if aliases are undeclared

create-classpath

Usage: (create-classpath deps-map {:keys [resolve-aliases makecp-aliases aliases trace], :as _opts})

Given parsed-opts describing the input config files, and aliases to use,
return the output lib map and classpath.

parse-opts

Usage: (parse-opts args)

Parse the command line opts to make-classpath

run

Usage: (run {:keys [config-user config-project libs-file cp-file jvm-file main-file skip-cp], :as opts})

Run make-classpath script. See -main for details.

run-core

Usage: (run-core {:keys [install-deps user-deps project-deps config-data resolve-aliases makecp-aliases jvmopt-aliases main-aliases aliases], :as opts})

Run make-classpath script from/to data (no file stuff)

parse-config

Usage: (parse-config s)

Parses a string of edn into a deps map.

parse-files

Usage: (parse-files s)

Parses a string of comma-delimited files into a collection of
Files, filtering only those that exist.

parse-kws

Usage: (parse-kws s)

Parses a concatenated string of keywords into a collection of keywords
Ex: (parse-kws ":a:b:c") ;; returns: (:a :b :c)

-main

Usage: (-main & args)

Main entry point for print-tree script.

Required:
  --libs-file=path - libs file

Prints the tree from libs file

run

Usage: (run {:keys [libs-file], :as _options})

Run print-tree script. See -main for details.

-main

Usage: (-main & args)

Main entry point for resolve-tags script.

Required:
  --deps-file deps.edn - deps.edn files in which to resolve git tags

Read deps.edn, find git coordinates with :tag but without :sha, resolve those
tags to shas, and over-write the deps.edn.

map-keys

Usage: (map-keys m f)

Apply f to each key in m

*the-dir*

Thread-local directory context for resolving relative directories.
Defaults to current directory. Should always hold an absolute directory
java.io.File, never null.

as-canonical

Usage: (as-canonical dir)

As canonical File in terms of the current directory context

canonicalize

Usage: (canonicalize f)

Make canonical File in terms of the current directory context.
f may be either absolute or relative.

with-dir

Usage: (with-dir dir & body)

Push directory into current directory context for execution of body.

printerrln

Usage: (printerrln & msgs)

println to *err*

read-edn

Usage: (read-edn reader)

Read the edn file from the specified `reader`.
This file should contain a single edn value. Empty files return nil.
The reader will be read to EOF and closed.

slurp-edn

Usage: (slurp-edn f)

Read the edn file specified by f, a string or File.
An empty file will return nil.

write-file

Usage: (write-file f s)

Write the string s to file f. Creates parent directories for f if they don't exist.

CustomProvider

->CustomProvider

Usage: (->CustomProvider)

Positional factory function for class clojure.tools.deps.alpha.util.maven.CustomProvider.

lib->names

Usage: (lib->names lib)

Split lib symbol into [group-id artifact-id classifier]

retrieve

Usage: (retrieve key)
       (retrieve key if-absent-fn)

Read the current value of key from the session. If absent, and if-absent-fn
is supplied, invoke the fn, set it in the session (if there is one),
and return the value.

with-session

Usage: (with-session & body)

Create a new empty session and execute the body