Installing scriptcs versions

The svm install command allows you to find and install scriptcs versions from the following source locations:

• stable (Chocolatey)
• nightlies (MyGet)
• local path (folder or .nupkg file)

List versions to install

The following command will list the scriptcs versions that are available to install.

 svm install <-l|-list>

This list is currently hard-coded in svm and only contains the last 5 stable releases (hence the current requirement to create a new release for new scriptcs versions). An api is on the roadmap that will provide svm with an up-to-date list of stable and nightly releases.

Example

 > svm install -l

 scriptcs version manager - 0.3.3

 The following scriptcs versions are available for installation:

   0.12.0
   0.11.0
   0.10.2
   0.10.1
   0.10.0

Install version

The following command will install the scriptcs version indicated by <version>.

 svm install <version>

The versions available are from the hard-coded list in svm that only contains the last 5 stable releases. An api is on the roadmap that will provide svm with an up-to-date list of stable and nightly releases.

Example

 > svm install 0.12.0

 scriptcs version manager - 0.3.3

 Downloading version '0.12.0' from 'http://chocolatey.org/api/v2/package/ScriptCs/0.12.0'.
 Installing version '0.12.0'.
 Version '0.12.0' is now available.
 Consider using svm use <version> to set it as the active scriptcs version.

The following special version of the command will install the latest scriptcs version.

 svm install latest

Example

 > svm install latest

 scriptcs version manager - 0.3.7

 Finding latest available version to install.
 Latest available version found is '0.13.2'.
 Downloading version '0.13.2' from 'http://chocolatey.org/api/v2/package/ScriptCs/0.13.2'.
 Installing version '0.13.2'.
 Version '0.13.2' is now available.
 Active scriptcs version set to '0.13.2'.

If there are no other versions installed, then the version being installed will automatically be made the active version. An example of this can be seen in the preceding example.

Install version from path

The following command will install a scriptcs version from path <path> as version <version>. The path may be a local folder or a local NuGet package. If the path is a local folder, then a soft link to the local folder is created. Use the -snapshot option to create a snapshot of the local folder instead of a soft link.

  svm install <version> <-f|-from> <path> [-s|-snapshot]

Example

This example installs a soft-linked version devbuild-0.13.0 from the local folder C:\scriptcs\artifacts\Release\bin on a Windows box. The JUNCTION (softlink) is visible via the dir command.

 > svm install devbuild-0.13.0 -f 'C:\scriptcs\artifacts\Release\bin'

 scriptcs version manager - 0.3.3

 Obtaining version 'devbuild-0.13.0' from 'C:\scriptcs\artifacts\Release\bin'.
 Installing version 'devbuild-0.13.0'.
 Version 'devbuild-0.13.0' is now available.
 Consider using svm use <version> to set it as the active scriptcs version.

 > dir %HOME%\.svm\versions
 Directory of C:\Users\Paul\.svm\versions

 29/12/2014  08:46 PM    <DIR>          .
 29/12/2014  08:46 PM    <DIR>          ..
 13/12/2014  08:32 AM    <DIR>          0.11.0
 29/12/2014  08:24 PM    <DIR>          0.12.0
 29/12/2014  08:46 PM    <JUNCTION>     devbuild-0.13.0 [C:\scriptcs\artifacts\Release\bin]

This example installs a soft-linked version devbuild-0.13.0 from the local folder ~/Dev/scriptcs/artifacts/Release/bin on a *nix box. The l (softlink) attribute is visible via the ls -la command.

 > svm install devbuild-0.13.0 -f ~/Dev/scriptcs/artifacts/Release/bin

 scriptcs version manager - 0.3.3 

 Obtaining version 'devbuild-0.13.0' from '/home/paul/Dev/scriptcs/artifacts/Release/bin'. 
 Installing version 'devbuild-0.13.0'. 
 Version 'devbuild-0.13.0' is now available. 
 Consider using svm use <version> to set it as the active scriptcs version. 

 > ls -la $HOME/.svm/versions
 total 16
 drwxrwxr-x 4 paul paul 4096 Dec 30 10:28 .
 drwxrwxr-x 6 paul paul 4096 Dec 30 09:45 ..
 drwxrwxr-x 2 paul paul 4096 Dec 30 10:27 0.11.0
 drwxrwxr-x 2 paul paul 4096 Dec 30 10:27 0.12.0
 lrwxrwxrwx 1 paul paul   45 Dec 30 10:28 devbuild-0.13.0 -> /home/paul/Dev/scriptcs/artifacts/Release/bin

Example

This example installs a snapshot version of the devbuild-0.13.0 from the local folder C:\scriptcs\artifacts\Release\bin on a Windows box. There is no JUNCTION (softlink) visible via the dir command.

 > svm install devbuild-0.13.0 -from 'C:\scriptcs\artifacts\Release\bin' -snapshot

 scriptcs version manager - 0.3.3

 Obtaining version 'devbuild-0.13.0' from 'C:\scriptcs\artifacts\Release\bin'.
 Installing version 'devbuild-0.13.0'.
 Version 'devbuild-0.13.0' is now available.
 Consider using svm use <version> to set it as the active scriptcs version.

 > dir %HOME%\.svm\versions
 Directory of C:\Users\Paul\.svm\versions

 29/12/2014  08:57 PM    <DIR>          .
 29/12/2014  08:57 PM    <DIR>          ..
 13/12/2014  08:32 AM    <DIR>          0.11.0
 29/12/2014  08:24 PM    <DIR>          0.12.0
 29/12/2014  08:57 PM    <DIR>          devbuild-0.13.0

This example installs a snapshot version of the devbuild-0.13.0 from the local folder ~/Dev/scriptcs/artifacts/Release/bin on a *nix box. There is no l (softlink) attribute visible via the ls -la command.

 > svm install devbuild-0.13.0 -from ~/Dev/scriptcs/artifacts/Release/bin -snapshot

 scriptcs version manager - 0.3.3 

 Obtaining version 'devbuild-0.13.0' from '/home/paul/Dev/scriptcs/artifacts/Release/bin'. 
 Installing version 'devbuild-0.13.0'. 
 Version 'devbuild-0.13.0' is now available. 
 Consider using svm use <version> to set it as the active scriptcs version. 

 > ls -la $HOME/.svm/versions
 total 20
 drwxrwxr-x 5 paul paul 4096 Dec 30 10:36 .
 drwxrwxr-x 6 paul paul 4096 Dec 30 09:45 ..
 drwxrwxr-x 2 paul paul 4096 Dec 30 10:27 0.11.0
 drwxrwxr-x 2 paul paul 4096 Dec 30 10:27 0.12.0
 drwxrwxr-x 2 paul paul 4096 Dec 30 10:36 devbuild-0.13.0

Example

The following example installs the 0.12.0-nightly-141224 version from the nightly NuGet package downloaded from the scriptcs nightly repository on MyGet.

 > svm install 0.12.0-nightly-141224 -from 'C:\Downloads\scriptcs.0.12.0-nightly-141224.nupkg'

 scriptcs version manager - 0.3.3

 Obtaining version '0.12.0-nightly-141224' from 'C:\Downloads\scriptcs.0.12.0-nightly-141224.nupkg'.
 Installing version '0.12.0-nightly-141224'.
 Version '0.12.0-nightly-141224' is now available.
 Consider using svm use <version> to set it as the active scriptcs version.