setop/pyenv
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Rewrite the readme pitch

Browse Source
This commit is contained in:
Sam Stephenson 2013-01-02 18:56:23 -06:00
parent 44c2378f2a
commit 3ec34448fa
2 changed files with 40 additions and 47 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
LICENSE
View File

@ -1,4 +1,4 @@
Copyright (c) 2011 Sam Stephenson Copyright (c) 2013 Sam Stephenson
Permission is hereby granted, free of charge, to any person obtaining Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the a copy of this software and associated documentation files (the

73
README.md
View File

@ -1,40 +1,34 @@
# Simple Ruby Version Management: rbenv # Simple Ruby Version Management: rbenv
rbenv lets you easily switch between multiple versions of Ruby. It's rbenv lets you lock your application to a specific version of Ruby,
simple, unobtrusive, and follows the UNIX tradition of single-purpose ensuring a consistent runtime environment during development and in
tools that do one thing well. production. Use it in conjunction with
[Bundler](http://gembundler.com/) to facilitate painless Ruby upgrades
and bulletproof deployments.
<img src="http://i.sstephenson.us/rbenv2.png" width="894" height="464"> **Powerful in development.** Easily specify the Ruby version
dependency for your application with a single file and keep all your
teammates on the same page. Transparently run multiple applications
on different versions of Ruby from the command line or with app
servers like [Pow](http://pow.cx). Override the specified Ruby
version at any time just by setting an environment variable.
### rbenv _does…_ **Rock-solid in production.** Your application's executables are its
interface with ops. With rbenv and [Bundler
binstubs](http://yehudakatz.com/2011/05/30/gem-versioning-and-bundler-doing-it-right/)
you'll never again need to `cd` in a cron job or Chef recipe to
ensure you've selected the right runtime. The Ruby version
dependency information lives in one place—your app's directory—so
upgrades and rollbacks can be atomic.
* Let you **change the global Ruby version** on a per-user basis. **One thing well.** rbenv is concerned solely with switching Ruby
* Provide support for **per-project Ruby versions**. versions, but a rich plugin ecosystem lets you tailor it to suit
* Allow you to **override the Ruby version** with an environment your needs. Compile your own Ruby versions, or use the
variable. [ruby-build](https://github.com/sstephenson/ruby-build) plugin to
automate the process. Specify per-application environment variables
### In contrast with rvm, rbenv _does not…_ with [rbenv-vars](https://github.com/sstephenson/rbenv-vars). See
more [plugins on the
* **Need to be loaded into your shell.** Instead, rbenv's shim wiki](https://github.com/sstephenson/rbenv/wiki/Plugins).
approach works by adding a directory to your `$PATH`.
* **Override shell commands like `cd`.** That's dangerous and
error-prone.
* **Have a configuration file.** There's nothing to configure except
which version of Ruby you want to use.
* **Install Ruby.** You can build and install Ruby yourself, or use
[ruby-build][] to automate the process.
* **Manage gemsets.** [Bundler](http://gembundler.com/) is a better
way to manage application dependencies. If you have projects that
are not yet using Bundler you can install the
[rbenv-gemset](https://github.com/jamis/rbenv-gemset) plugin.
* **Require changes to Ruby libraries for compatibility.** The
simplicity of rbenv means as long as it's in your `$PATH`,
[nothing](https://rvm.io/integration/bundler/)
[else](https://rvm.io/integration/capistrano/)
needs to know about it.
* **Prompt you with warnings when you switch to a project.** Instead
of executing arbitrary code, rbenv reads just the version name
from each project. There's nothing to "trust."
## Table of Contents ## Table of Contents
@ -128,8 +122,9 @@ easy to fork and contribute any changes back upstream.
$ exec $SHELL -l $ exec $SHELL -l
~~~ ~~~
5. Install [ruby-build][], which provides an `rbenv install` 5. Install [ruby-build](https://github.com/sstephenson/ruby-build),
command that simplifies the process of installing new Ruby versions. which provides an `rbenv install` command that simplifies the
process of installing new Ruby versions.
~~~ ~~~
$ rbenv install 1.9.3-p327 $ rbenv install 1.9.3-p327
@ -171,7 +166,9 @@ $ git checkout v0.2.0
### Homebrew on Mac OS X ### ### Homebrew on Mac OS X ###
You can also install rbenv using the [Homebrew][] on Mac OS X. You can also install rbenv using the
[Homebrew](http://mxcl.github.com/homebrew/) package manager on Mac OS
X.
~~~ ~~~
$ brew update $ brew update
@ -416,7 +413,7 @@ tracker](https://github.com/sstephenson/rbenv/issues).
(The MIT license) (The MIT license)
Copyright (c) 2011 Sam Stephenson Copyright (c) 2013 Sam Stephenson
Permission is hereby granted, free of charge, to any person obtaining Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the a copy of this software and associated documentation files (the
@ -436,7 +433,3 @@ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
[ruby-build]: https://github.com/sstephenson/ruby-build
[homebrew]: http://mxcl.github.com/homebrew/