NAME
atlas - Atlas
DESCRIPTION
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