Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/terlar/fry
Simple ruby version manager for fish
https://github.com/terlar/fry
Last synced: 3 months ago
JSON representation
Simple ruby version manager for fish
- Host: GitHub
- URL: https://github.com/terlar/fry
- Owner: terlar
- License: mit
- Created: 2013-03-15T01:15:10.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2016-05-19T11:59:17.000Z (over 8 years ago)
- Last Synced: 2024-08-01T17:37:02.985Z (6 months ago)
- Language: Shell
- Homepage:
- Size: 167 KB
- Stars: 62
- Watchers: 3
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-ruby - fry - Simple ruby version manager for fish. (Environment Management)
README
# fry [](https://travis-ci.org/terlar/fry)
A simple ruby version manager for [fish](https://github.com/fish-shell/fish-shell).
## Installation
### User
```sh
git clone https://github.com/terlar/fry.git
cd fry
make user-install
```
#### [fisherman](https://github.com/fisherman/fisherman)
```fish
fisher terlar/fry
```
#### [plug](https://github.com/terlar/fish-plug)
```fish
plug terlar/fry
```
### System-wide
```sh
git clone https://github.com/terlar/fry.git
cd fry
make install
```
#### Arch Linux
`fry` is also available for Arch Linux in the [AUR](https://aur.archlinux.org) as the package [fry](https://aur.archlinux.org/packages/fry/) or [fry-git](https://aur.archlinux.org/packages/fry-git/).
To install, use your favorite AUR helper (`yaourt`, `aura`, etc.).
```sh
yaourt -S fry
```
#### OS X
`fry` is also available for OS X in the [homebrew](http://brew.sh) as the
formula `fry` via [tap](https://github.com/igas/homebrew-fry).
```sh
brew tap igas/fry
brew install fry
```
If you want to install `master` version, add `--HEAD` to install command.
## Rubies
By default `fry` will look for rubies in `~/.rubies`. This can be configured as you like.
### Install (with ruby-install or ruby-build)
If you have [ruby-install](https://github.com/postmodern/ruby-install) or
[ruby-build](https://github.com/sstephenson/ruby-build) installed, `fry` provides a wrapper
with auto-completion and building to the correct destination.
To install rubies this way, run the following command:
```fish
# To see available rubies
fry install
# To install a specific ruby version
fry install jruby-1.7.9
```
## Configuration
To see which configuration options are available and your current configuration,
you can execute the command `fry config`.
### Path (Rubies)
This option determines where `fry` looks for rubies.
```fish
# To see the path
fry config path
# To set the path
fry config path /opt/rubies
```
#### Prepend path
This option determines if your ruby path should be prepended or not. However it will never be at the end of your `PATH` since we are using `fish_user_paths` which is prepended to `PATH`. However if you have specified other paths inside your `fish_user_paths` then those will have higher priority. To change this behavior you can toggle this. The default behavior is append.
```fish
# To prepend to the fish_user_paths
fry config prepend on
# To append to the fish_user_paths
fry config prepend off
```
### Auto-Switch
If you want `fry` to look for a [.ruby-version](https://gist.github.com/fnichol/1912050) file and
automatically switch ruby on directory change then you can enable auto-switching. This is off by default.
```fish
# To see the auto-switch status
fry config auto
# To enable auto-switch
fry config auto on
# To disable auto-switch
fry config auto off
```
#### Prax/Pow
If you are using [prax](https://github.com/ysbaddaden/prax) or
[pow](https://github.com/basecamp/pow) you can make it utilize the
auto-switching capability.
When you have a `.ruby-version` file in your home directory this will be
used used by default. If you want it to pickup the custom ruby-version
per project you have to create a `.praxconfig` in your home directory or
for pow, you need to create a `.powenv` inside every project folder.
Run the following commands:
```fish
# If you have auto-switch, it will use whatever is specified in your .ruby-version
fry env > ~/.praxconfig
# Specify a specific ruby to run
fry env rbx-2.2.6 > ~/ruby_project/.praxenv
```
### Installer
If you want to select which installer `fry` should use, you can do it
through this option. There are currently support for `ruby-install` and
`ruby-build`. But you could easily define your own wrapper if you use
some other tool.
```fish
# To list available installer wrappers
fry installers
# To see the installer used
fry config installer
# To set the desired installer
fry config installer ruby-install
```
### Default Ruby
If you wish to set a default Ruby, simply call `fry` in `~/.config/fish/config.fish`:
```fish
fry ruby-1.9
```
If you have enabled auto-switching, simply create a `.ruby-version` file in your home directory:
```fish
echo 'ruby-1.9' > ~/.ruby-version
```
## Examples
List available rubies:
```fish
fry
system
* 1.9.3-p392
2.0.0-p0
jruby-1.7.3
```
Install ruby:
```fish
fry install
fry install 2.0.0-p247
fry use 2.0.0-p247
```
Get help:
```fish
fry help
```