Skip to content

AndyObtiva/rvm-tui

Repository files navigation

Ruby enVironment Manager - Text-based User Interface

Gem Version

RVM is the original Ruby enVironment Manager that is used to:

  • Effortlessly install multiple versions of Ruby, including JRuby
  • Isolate projects from each other with gemsets to:
    • Enable higher productivity by being able to work on projects completely worry-free without any concerns about side-effects on other projects
    • Ability to manage a project's gems (including mass deletion) without worrying about affecting other projects
    • Prevent odd bugs that happen when sharing gems with other projects due to making changes in them
    • Simplify gem-related troubleshooting without a domino effect on other projects

Given how practical and often-used RVM is, I am providing a text-based user interface for it that facilitates these tasks:

  • Testing the same project with multiple Rubies (e.g. ensuring it runs on both Ruby and JRuby)
  • Testing the same project with different gem version combinations in different gemsets (e.g. checking if it works with both facets 3 + dependencies and facets 2 + dependencies)

RVM TUI DEMO

Other TUI gems you may be interested in:

Pre-requisites

  • RVM
  • Any version of Ruby installed via RVM (preferably MRI Ruby for a fast startup time)
  • Bash or Zsh (Z Shell) (including Sed)

Setup Instructions

The gem can be installed unto any Ruby/Gemset in RVM and it will be used from there everywhere.

Since it is independent of any particular Ruby project, it is recommended you install unto the default gemset (or optionally into its own gemset if you prefer). Global gemset wouldn't be enough to share it since it does not cross Rubies yet is limited to a specific Ruby version.

Afterwards, run the rvm-tui-setup command from the same RVM Ruby/Gemset you installed the gem at to setup the rvm-tui function source in ~/.bash_profile or ~/.bashrc (whichever is available)

These are the commands you need to run in order to select a Ruby and gemset, install gem, and finally setup gem commands globablly in the shell environment:

rvm use @default # or a different ruby version/gemset like `rvm use ruby-2.7.2@rvm-tui --create`
gem install rvm-tui
rvm-tui-setup

Usage

Simply run this command:

rvmui

Or one of the aliases:

rvmtui
rvm-ui
rvm-tui

Contributing to rvm-tui

  • Make sure you have RVM installed
  • Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
  • Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
  • Fork the project.
  • Start a feature/bugfix branch.
  • bundle
  • Commit and push until you are happy with your contribution.
  • rake install to test (or rake build, rvm use @default, and then gem install pkg/rvm-tui-{version}.gem)
  • Please try not to mess with the Rakefile, version, or change log. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

TODO

TODO.md

Change Log

CHANGELOG.md

License

Apache License, Version 2.0

Copyright (c) 2020-2022 Andy Maleh

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

About

Ruby enVironment Manager - Text-based User Interface

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages