Swift Version Manager

swiftenv allows you to easily install, and switch between multiple versions of Swift.

This project was heavily inspired by pyenv.

swiftenv allows you to:

Change the global Swift version, per user.
Set a per-project Swift version.
Allows you to override the Swift version with an environmental variable.

## Installation

NOTE: If you're on OS X, consider installing with Homebrew.

Via a Git clone

Check out swiftenv, we recommend ~/.swiftenv (but it can be installed elsewhere as long as you set SWIFTENV_ROOT).
```
$ git clone https://github.com/kylef/swiftenv.git ~/.swiftenv
```

Configure environment.

For Bash:

$ echo 'export SWIFTENV_ROOT="$HOME/.swiftenv"' >> ~/.bash_profile
$ echo 'export PATH="$SWIFTENV_ROOT/bin:$PATH"' >> ~/.bash_profile
$ echo 'eval "$(swiftenv init -)"' >> ~/.bash_profile

NOTE: On some platforms, you may need to modify ~/.bashrc instead of ~/.bash_profile.

For ZSH:

$ echo 'export SWIFTENV_ROOT="$HOME/.swiftenv"' >> ~/.zshenv
$ echo 'export PATH="$SWIFTENV_ROOT/bin:$PATH"' >> ~/.zshenv
$ echo 'eval "$(swiftenv init -)"' >> ~/.zshenv

For Fish:

$ echo 'setenv SWIFTENV_ROOT "$HOME/.swiftenv"' >> ~/.config/fish/config.fish
$ echo 'setenv PATH "$SWIFTENV_ROOT/bin" $PATH' >> ~/.config/fish/config.fish
$ echo 'status --is-interactive; and . (swiftenv init -|psub)' >> ~/.config/fish/config.fish

Restart your shell so the changes take effect.

Via Homebrew

You can install swiftenv using the Homebrew package manager on OS X.

$ brew install kylef/formulae/swiftenv

Usage

Commands

`version`

Displays the current active Swift version and why it was chosen.

$ swiftenv version
swift-2.2-SNAPSHOT-2015-12-10-a (set by /home/kyle/.swiftenv/version)

`versions`

Lists all installed Swift versions, showing an asterisk next to the currently active version.

$ swiftenv versions
  swift-2.2-SNAPSHOT-2015-12-01-b
* swift-2.2-SNAPSHOT-2015-12-10-a (set by /home/kyle/.swiftenv/version)

`global`

Sets the global version of Swift to be used by writing to the ~/.swiftenv/version file. This version can be overridden by application-specific .swift-version file, or by setting the SWIFT_VERSION environment variable.

$ swiftenv global swift-2.2-SNAPSHOT-2015-12-10-a
$ swiftenv global
swift-2.2-SNAPSHOT-2015-12-10-a

`local`

Sets the local application-specific Swift version by writing the version to a .swift-version file in the current directory. This version overrides the global version and can also be overridden by th SWIFTENV_VERSION environment variable.

$ swiftenv local swift-2.2-SNAPSHOT-2015-12-10-a
$ swiftenv local
swift-2.2-SNAPSHOT-2015-12-10-a

`install`

Installs a version of Swift. Currently this will download the Swift binaries from apple for Ubuntu or OS X. You may also install Swift on OS X via the guides on the Swift website or from Xcode.

$ swiftenv install swift-2.2-SNAPSHOT-2015-12-10-a
Downloading swift-2.2-SNAPSHOT-2015-12-10-a from https://swift.org/builds/ubuntu1510/swift-2.2-SNAPSHOT-2015-12-10-a/swift-2.2-SNAPSHOT-2015-12-10-a-ubuntu15.10.tar.gz

You may also manually install Swift and make it accessible to swiftenv. Custom Swift installations can either be placed in a directory using the correct version number at ~/.swiftenv/versions/VERSION, or can be symbolic linked into the version directory.

It is expected that all dependencies are already installed for running Swift, please consult the Swift website for more information.

NOTE: After manually installing a version of Swift, it's recommended that you run swiftenv rehash to update the shims.

`uninstall`

Uninstalls a specific Swift version.

$ swiftenv uninstall swift-2.2-SNAPSHOT-2015-12-10-a

`rehash`

Installs shims for the Swift binaries. This command should be ran after you manually install new versions of Swift.

$ swiftenv rehash

`which`

Displays the full path to the executable that would be invoked for the selected version for the given command.

$ swiftenv which swift
/home/kyle/.swiftenv/versions/swift-2.2-SNAPSHOT-2015-12-10-a/usr/bin/swift

$ swiftenv which lldb
/home/kyle/.swiftenv/versions/swift-2.2-SNAPSHOT-2015-12-10-a/usr/bin/lldb

NachoSoto / swiftenv