atlas1
Atlas
Overview
atlas - Nim Package Cloner Version 0.14.7 (sha: aa6fb162006f3015aa84c4305e15cb4d230f5ad6)
-
(c) 2021 Andreas Rumpf
Usage:
-
atlas [options] [command] [arguments]
Commands:
- init
-
initializes the current project as an Atlas project
- use <url|pkgname>
-
add package and its dependencies to the project and patch the project's Nimble file
- install
-
use the nimble file to setup the project's dependencies
- update [filter]
-
update every dependency that matches the filter whether by name or URL. All dependencies are updated if no filter is given.
- search <keyA> [keyB ...]
-
search for package that contains the given keywords
- link <path>
-
link an existing project into the current project to share its dependencies
- tag [major|minor|patch|<semver>|a..z]
-
add and push a new tag, input must be one of: ['major'|'minor'|'patch'] or a SemVer tag like ['1.0.3'] or a letter ['a'..'z']: a.b.c.d.e.f.g
- pin [atlas.lock]
-
pin the current checkouts and store them in the lock file
- rep [atlas.lock]
-
replay the state of projects according to the lock file
- replay [atlas.lock]
-
alias of `rep`
- reproduce [atlas.lock]
-
alias of `rep`
- changed [atlas.lock]
-
list any packages that differ from the lock file
- outdated
-
list the packages that are outdated
- deps
-
list the currently selected dependencies
- env <nimversion>
-
setup a Nim virtual environment
Options
-
--help, -h -
show this help
-
--version, -v -
show the version
-
--project=path, -p -
use the project at the given path
-
--deps=path -
override the deps directory
-
--confdir=path -
use the atlas.config at the given path
-
--feature=<feature> -
enables the given feature, pass multiple for multiple features for project specific use: `<project>.<feature>` (note always be passed when you want to use features)
-
--features=<list> -
enables one or more features separated by commas or spaces
-
--allFeatures -
enables every declared feature
-
--keepFeatures, -k -
reuse feature defines from the current nim.cfg
-
--resolver=minver|semver|maxver -
which resolution algorithm to use, default is semver
-
--list[=on|off] -
list all available and installed versions
-
--keepCommits -
do not perform any `git checkouts`
-
--keepworkspace -
keep generated workspace artifacts
-
--ignoreerrors -
continue even when errors were recorded
-
--dumpformular -
dump SAT formula for debugging
-
--dumpgraphs -
dump dependency graphs for debugging
-
--showGraph -
show the dependency graph
-
--tree -
show `atlas deps` output as a dependency tree
-
--update -
for `install`, update dependency repos before solving
-
--noexec -
do not perform any action that may run arbitrary code
-
--autoenv -
detect the minimal Nim $version and setup a corresponding Nim virtual environment
-
--noautoinit -
do not auto initialize an atlas project
-
--no-lazy-deps -
disable lazy dependency loading and use eager loading for all transitive dependencies during SAT solving
-
--parallel[=count], -t[=count] -
clone dependency repositories in parallel, default count is 3
-
--proxy=url -
use the given proxy URL for all git operations
-
--dumbProxy -
use a dumb proxy without smart git protocol
-
--packagesRepo -
use the nim-lang/packages git repo (legacy behavior)
-
--forceGitToHttps -
force git:// URLs to https://
-
--ignoreUrls -
don't error on mismatching urls
-
--colors=on|off -
turn on|off colored output
-
--verbosity=normal|info|warn|warning|error|trace|debug -
set verbosity level to normal/info/warn/warning/error/trace/debug the default level is warning