Mailing List: groups.google.com/group/discuss_pik
Bugs/Feature requests: github.com/vertiginous/pik/issues
Pik is a tool to manage multiple versions of ruby on Windows. It can be used from the Windows command line (cmd.exe), Windows PowerShell, or Git Bash. \
>pik help commands add Adds another ruby location to pik. benchmark|bench Runs bencmarks with all versions that pik is aware of. config Adds/modifies configuration options. default Switches to the default ruby. gem Runs the gem command with all versions that pik is aware of. help Displays help information. implode Removes your pik configuration. info Displays information about the current ruby version. install|in Downloads and installs different ruby versions. list|ls Lists ruby versions that pik is aware of. rake Runs the rake command with all versions that pik is aware of. refresh Refreshes the pik configuration file. remove|rm Removes a ruby location from pik. ruby|rb Runs ruby with all versions that pik is aware of. run|exec Executes shell command with all versions of ruby that pik is aware of. system Switches back to initial system environment. uninstall|unin Deletes a ruby version from the filesystem and removes it from Pik. update|up updates pik. use Switches ruby versions by name. For help on a particular command, use 'pik help COMMAND'.
Build dependencies: exerb-mingw, highline, crown
Packaging dependencies upx, wix, uuid gem
Development dependencies: rake, cucumber, rspec, hoe, hoe-git
You can install pik via rubygems, or the Windows installer, or you can update pik with pik
>gem install pik ... Successfully installed pik-0.2.6 1 gem installed
After the gem is installed, you can use the 'pik_install' script to install the pik executable. Install pik to a location that's in your path, but someplace other than your rubybin dir. For instance, the directory C:bin is in my path:
>path PATH=c:\bin;C:\Program Files\Windows Resource Kits\Tools\;c:\ruby\Ruby-186-p383\bin;
So I run:
>pik_install C:\bin Thank you for using pik. Installing to C:\bin ... pik is installed
If you want to install to a machine that doesn't have Ruby installed yet, you can download the latest msi file from github. Or, just run:
>msiexec /i http://github.com/downloads/vertiginous/pik/pik-n.n.n.msi
The MSI installer currently doesn't install the needed files to use Pik from Git Bash. Also, there was a bug in the upgrade code in 0.2.7, so you should uninstall the current version before installing the new one.
If you install to a directory that's not in your path, you'll need to add it to the path yourself. Microsoft has good instructions on that. After that, you should be ready to run pik.
If this is a first-time install, look at pik add, and pik install to set up your environment.
>pik add C:\ruby\IronRuby-091\bin Adding: 091: IronRuby 0.9.1.0 on .NET 126.96.36.199 Located at: C:/ruby/IronRuby-091/bin >pik install ruby ** Downloading: http://rubyforge.org/frs/download.php/66874/ruby-1.9.1-p243-i386-mingw32-rc1.7z to: c:\installs\ruby-1.9.1-p243-i386-mingw32-rc1.7z ...
If you're upgrading from version 0.2.6, you should be able to upgrade with 'pik update'
If you're upgrading from a version <= 0.1.1, you'll want to delete the pik.bat file from all of your ruby versions. Gem uninstall should do the trick.
See the wiki for examples and documentation. If something isn't documented correctly or at all, feel free to fix it yourself, or let me know.
(The MIT License)
Copyright © 2010 Gordon Thiesfeld
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.