ATLAS(1)

NAME
atlas - Atlas

DESCRIPTION
atlas - Nim Package Cloner Version 0.10.1 (sha: ff1f4289482dce94ba9f95b3b0ae16d16e21eb3d)

    (c) 2021 Andreas Rumpf

  Usage:

    atlas [options] [command] [arguments]

  Command:

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

extract <file.nimble> extract the requirements and custom commands from
    the given Nimble file

tag [major|minor|patch]
    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 the projects according to the lock file

changed <atlas.lock>
    list any packages that differ from the lock file

outdated
    list the packages that are outdated

build|test|doc|tasks
    currently delegates to `nimble build|test|doc`

task <taskname>
    currently delegates to `nimble <taskname>`

env <nimversion>
    setup a Nim virtual environment

--keep
    keep the c_code subdirectory

OPTIONS

--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)

--keepCommits
    do not perform any `git checkouts`

--project=path
    use the project at the given path

--confdir=path
    use the atlas.config at the given path

--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

--resolver=minver|semver|maxver
    which resolution algorithm to use, default is semver

--no-lazy-deps
    disable lazy dependency loading and use eager loading for all transitive dependencies during SAT solving

--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)

--showGraph
    show the dependency graph

--list
    list all available and installed versions

--version
    show the version

--ignoreUrls
    don't error on mismatching urls

--colors=on|off
    turn on|off colored output

--verbosity=info|warning|error|trace|debug
    set verbosity level to info, warning, error, trace, debug the default level is warning

--help
    show this help