Hieraki recent changes

Jim Weirich: Installing a remote gem

Sun, 20 May 2007 10:23:21 EDT

When you run (as root, if appropriate and necessary)

gem install --remote progressbar
# shortcut: gem i -r progressbar

the _progressbar_ gem will be installed on your computer. Notice that you don't need to specify the version, but you can if you want to. It will default to the last version available.

gem ins -r progressbar-0.0.3

gem ins -r progressbar --version '> 0.0.1'

In both cases, the output is simply: Attempting remote installation of 'progressbar' Successfully installed progressbar, version 0.0.3 RubyGems allows you to have multiple versions of a library installed and choose in your code which version you wish to use. Useful extra options for installation are --gen-rdoc for generating the gem's RDoc API documentation, and --run-tests to run the gem's unit tests, if any. Note too that when you remotely install a gem, it will download and install any specified dependencies. Try installing *copland* and see that it prompts you to accept *log4r* as well (if it's not already installed).

Jim Weirich: Searching remotely installable gems

Sun, 20 May 2007 10:22:07 EDT

When you run

  gem query --remote --name-matches doom
  # shortcut: gem q -R -n doom

you will see a detailed list of _matching_ gems on the remote server. Sample output:

*** REMOTE GEMS ***

ruby-doom (0.8, 0.0.7)
    Ruby-DOOM provides a scripting API for creating DOOM
    maps. It also provides higher-level APIs to make map
    creation easier.

When you run

  gem query --remote --name-matches doom
  # shortcut: gem q -R -n doom

you will see a detailed list of matching gems on the remote server.

Sample output:

*** REMOTE GEMS ***

ruby-doom (0.8, 0.0.7)
    Ruby-DOOM provides a scripting API for creating DOOM
    maps. It also provides higher-level APIs to make map
    creation easier.

Jim Weirich: Installing gems in a non-standard directory.

Wed, 8 Nov 2006 00:52:31 EST

p((. How do I install gems in a non-standard location, such as my home directory? You have to redefine the location of the GEM_HOME variable and add the paths to the gem repositories in the RUBYLIB variable before launching the installation into a custom directory. GEM_HOME should point to $PREFIX/lib/ruby/gems/1.8 if it used with the 1.8 version of ruby. RUBYLIB should point to the $PREFIX/lib/ruby and $PREFIX/lib/site_ruby/1.8 Here is a shell script that runs in the rubygems distribution directory to install into /home/user : PREFIX=$HOME export GEM_HOME=$PREFIX/lib/ruby/gems/1.8 export RUBYLIB=$PREFIX/lib/ruby:$PREFIX/lib/site_ruby/1.8 ruby setup.rb all --prefix=$PREFIX You may add GEM_HOME and RUBYLIB into your ~/.profile file to automatically load on login.

Jim Weirich: Installing gems in a non-standard directory.

Wed, 8 Nov 2006 00:49:12 EST

p((. How do I install gems in a non-standard location, such as my home directory? You have to redefine the location of the GEM_HOME variable and add the paths to the gem repositories in the RUBYLIB variable before launching the installation into a custom directory. GEM_HOME should point to $PREFIX/lib/ruby/gems/1.8 if it used with the 1.8 version of ruby. RUBYLIB should point to the $PREFIX/lib/ruby and $PREFIX/lib/site_ruby/1.8 Here is a shell script that runs in the rubygems distribution directory to install into /home/user : PREFIX=/home/user export GEM_HOME=$PREFIX/lib/ruby/gems/1.8 export RUBYLIB=$PREFIX/lib/ruby:PREFIX/lib/site_ruby/1.8 ruby setup.rb all --prefix=$PREFIX You may add GEM_HOME and RUBYLIB into your ~/.profile file to automatically load on login.

Jim Weirich: Q: How do I install gems in my home directory?

Wed, 8 Nov 2006 00:47:27 EST

A: You have to redefine the location of the GEM_HOME variable and add the paths to the gem repositories in the RUBYLIB variable before launching the installation into a custom directory. GEM_HOME should point to $PREFIX/lib/ruby/gems/1.8 if it used with the 1.8 version of ruby. RUBYLIB should point to the $PREFIX/lib/ruby and $PREFIX/lib/site_ruby/1.8 Here is a shell script that runs in the rubygems distribution directory to install into /home/user : PREFIX=/home/user export GEM_HOME=$PREFIX/lib/ruby/gems/1.8 export RUBYLIB=$PREFIX/lib/ruby:PREFIX/lib/site_ruby/1.8 ruby setup.rb all --prefix=$PREFIX You may add GEM_HOME and RUBYLIB into your ~/.profile file to automatically load on login.

Jim Weirich: Q1

Wed, 8 Nov 2006 00:46:44 EST

Chad Fowler: Using a gem in your code

Fri, 22 Sep 2006 15:46:40 EDT

Here we demonstrate the use of the *progressbar* gem. This library may use terminal features that are not available in your system. If you wish, enter the following code into a file and run it. (Note that you must require the rubygems library before executing this code, as detailed in chapter 3 of this manual.)

require 'progressbar'

bar = ProgressBar.new("Example progress", 50)
total = 0
until total >= 50
  sleep(rand(2)/2.0)
  increment = (rand(6) + 3)
  bar.inc(increment)
  total += increment
end

Here is a "screenshot" of the partially complete progress bar. Example progr: 29% |ooooooooooo | ETA: 00:00:04 The first line of the program requires the progressbar library file. RubyGems will look for the @progressbar.rb@ file in the standard library locations. If not found, it will look through its gem repository for a gem that contains @progressbar.rb@. If a gem is used, RubyGems attempts to use the latest installed version by default. Note that the program was able to use the latest available installed gem by default _without_ any explicit action in the code. The developer may develop a library without worrying about using RubyGems. However, to _run_ the code, the environment does need to be "gem enabled". See "Setting Up the RubyGems Environment":http://docs.rubygems.org/read/chapter/3#page70 for details on how to make this happen.

Jim Weirich: Why does require return false when loading a file from a gem?

Thu, 6 Apr 2006 01:06:49 EDT

p{font-style: italic}. Require returns false when loading a file from a gem. Usually require will return true when it has loaded correctly. What's wrong? h3. Answer Nothing. Well, something. But nothing you need to worry about. A false return from the require method does _not_ indicate an error. It just means that the file has already been loaded. RubyGems has a feature that allows a file to be automatically loaded when a gem is activated (i.e. selected). When you require a file that is in an inactive gem, the RubyGems software will activate that gem for you. During that activation, any autoloaded files will be loaded for you. So, by the time your require statement actually does the work of loading the file, it has already been autoloaded via the gem activation, and therefore it returns false. As we said, it is not a problem, but it sure is confusing to folks doing requires in an irb session. Future versions of RubyGems will correct this behavior.

Jim Weirich: Why does require return false when loading a file from a gem?

Thu, 6 Apr 2006 00:58:38 EDT

p{font-style: italic}. Require returns false when loading a file from a gem. Usually require will return true when its loaded correctly. What's wrong? h3. Answer Nothing. Well, something. But nothing you need to worry about. A false return from the require method does not indicate an error. It means that the file is already loaded. Proabably the file was listed as an auto-required file in the gem, so when the gem was activated, the file was already loaded. So when you explicitly require the file, the file has already been loaded, so require returns false. I repeat, there is nothing wrong. The only time this causes concern is when someone requires the file in an irb session and notices the return type. However, the next version of RubyGems will correct this problem so that newcomers wont be surprised by the result.

Jim Weirich: Why does require return false when loading a file from a gem?

Thu, 6 Apr 2006 00:58:19 EDT

p{font-style: italic}. Require returns false when loading a file from a gem. Usually requrie will return true when its loaded correctly. What's wrong? h3. Answer Nothing. Well, something. But nothing you need to worry about. A false return from the require method does not indicate an error. It means that the file is already loaded. Proabably the file was listed as an auto-required file in the gem, so when the gem was activated, the file was already loaded. So when you explicitly require the file, the file has already been loaded, so require returns false. I repeat, there is nothing wrong. The only time this causes concern is when someone requires the file in an irb session and notices the return type. However, the next version of RubyGems will correct this problem so that newcomers wont be surprised by the result.

Jim Weirich: Why does returns false when loading a file from a gem?

Thu, 6 Apr 2006 00:57:52 EDT

Jim Weirich: `gemlock` script

Tue, 4 Apr 2006 16:20:31 EDT

  $ gemlock rails-1.0.0
  require "rubygems"
  require_gem 'rails', '= 1.0.0'
  require_gem 'rake', '= 0.7.0.1'
  require_gem 'activesupport', '= 1.2.5'
  require_gem 'activerecord', '= 1.13.2'
  require_gem 'actionpack', '= 1.11.2'
  require_gem 'actionmailer', '= 1.1.5'
  require_gem 'actionwebservice', '= 1.0.0'

@gemlock@ will find all the direct and indirect gems required by rails-1.0.0 and specify the most recent, currently installed version of those gems. The output should be place in the application (or library) will it will be run *before* any other require statement in the program. If your application depends on more than one gem, just list all the gems in the command line and @gemlock@ will display the locking commands for all of them. h3. Usage

  Usage: bin/gemlock [options] GEM_NAME-VERSION...

  Where options are:
    -v, --verbose                    Verbose output
    -s, --[no-]strict                Fail if unable to satisfy a dependency
    -h, --help                       Show this message
    -V, --version                    Show version

Jim Weirich: `gemlock` script

Tue, 4 Apr 2006 16:19:28 EDT

(new in version 0.9.0) The @gemlock@ script will generate a series of @require_gem@ commands that will lock down an application or library to a particular version of their dependent gems. For example, if you wish to lock down a particular version of the Rails library, use: $ gemlock rails-1.0.0 require "rubygems" require_gem 'rails', '= 1.0.0' require_gem 'rake', '= 0.7.0.1' require_gem 'activesupport', '= 1.2.5' require_gem 'activerecord', '= 1.13.2' require_gem 'actionpack', '= 1.11.2' require_gem 'actionmailer', '= 1.1.5' require_gem 'actionwebservice', '= 1.0.0' @gemlock@ will find all the direct and indirect gems required by rails-1.0.0 and specify the most recent, currently installed version of those gems. The output should be place in the application (or library) will it will be run *before* any other require statement in the program. If your application depends on more than one gem, just list all the gems in the command line and @gemlock@ will display the locking commands for all of them. h3. Usage Usage: bin/gemlock [options] GEM_NAME-VERSION... Where options are: -v, --verbose Verbose output -s, --[no-]strict Fail if unable to satisfy a dependency -h, --help Show this message -V, --version Show version

Jim Weirich: `gemlock` script

Tue, 4 Apr 2006 16:18:16 EDT

The @gemlock@ script will generate a series of @require_gem@ commands that will lock down an application or library to a particular version of their dependent gems. For example, if you wish to lock down a particular version of the Rails library, use: $ gemlock rails-1.0.0 require "rubygems" require_gem 'rails', '= 1.0.0' require_gem 'rake', '= 0.7.0.1' require_gem 'activesupport', '= 1.2.5' require_gem 'activerecord', '= 1.13.2' require_gem 'actionpack', '= 1.11.2' require_gem 'actionmailer', '= 1.1.5' require_gem 'actionwebservice', '= 1.0.0' @gemlock@ will find all the direct and indirect gems required by rails-1.0.0 and specify the most recent, currently installed version of those gems. The output should be place in the application (or library) will it will be run *before* any other require statement in the program. If your application depends on more than one gem, just list all the gems in the command line and @gemlock@ will display the locking commands for all of them. h3. Usage

Jim Weirich: `gemlock` script

Tue, 4 Apr 2006 16:08:52 EDT

The @gemlock@ script will generate a series of @require_gem@ commands that will lock down an application or library to a particular version of their dependent gems.

Jim Weirich: No such file to load -- rubygems

Thu, 29 Dec 2005 10:03:09 EST

p{font-style: italic}. When I run the gem command, I get the following error message:

 ruby: No such file to load -- rubygems (LoadError)

p{font-style: italic}. What's wrong? h3. Answer It looks like executing copy of Ruby does not have the RubyGems library installed. RubyGems was probably installed at one time (because the gem command is recognized), but it may have been installed on a different installation of Ruby than the one you are currently running. h4. Things to check * Check that the installation of Ruby that is running is the same one that has RubyGems installed. On a unix system, the which command (or type command) will help figure this out. * Verify that the currently running installation of Ruby does indeed have the RubyGems library installed. You should find a "rubygems.rb" file in the site_ruby/1.8 directory of the Ruby installation. These mixup can easily happen after installing a new instance of Ruby, but the old instance preceeds the new one in the PATH list.

Jim Weirich: No such file to load -- rubygems

Thu, 29 Dec 2005 10:02:21 EST

p{font-style: italic}. When I run the gem command, I get the following error message: ruby:

No such file to load -- rubygems (LoadError)

Jim Weirich: No such file to load -- rubygems

Thu, 29 Dec 2005 09:54:38 EST

p{font-style: italic}. When I run the gem command, I get the following error message: ruby:

No such file to load -- rubygems (LoadError)

p{font-style: italic}. What's wrong? h3. Answer

Jim Weirich: RubyGems hangs while updating the source index.

Tue, 20 Dec 2005 14:24:25 EST

p{font-style: italic}. I have a problem with RubyGems. It doesn't matter what I try to install with, it freezez. p{font-style: italic}. Particulary I tried to execute: gem install rails --include-dependencies p{font-style: italic}. but the command freezez at the following message: "Updating Gem source index for: http://gems.rubyforge.org" h3. Answer [I lost my internet connection while composing the answer to this question. Unfortunately, I now no longer recall what I intended to write. The answer (or at least part of the answer) is buried deep in the RubyGems mail archive. I'll try to update this after a bit of research. Sorry for leaving this question hanging.]

Jim Weirich: RubyGems hangs while updating the source index.

Tue, 20 Dec 2005 14:23:55 EST

Hieraki recent changes

Jim Weirich: Installing a remote gem

Jim Weirich: Searching remotely installable gems

Jim Weirich: Installing gems in a non-standard directory.

Jim Weirich: Installing gems in a non-standard directory.

Jim Weirich: Q: How do I install gems in my home directory?

Jim Weirich: Q1

Chad Fowler: Using a gem in your code

Jim Weirich: Why does require return false when loading a file from a gem?

Jim Weirich: Why does require return false when loading a file from a gem?

Jim Weirich: Why does require return false when loading a file from a gem?

Jim Weirich: Why does returns false when loading a file from a gem?

Jim Weirich: gemlock script

Jim Weirich: gemlock script

Jim Weirich: gemlock script

Jim Weirich: gemlock script

Jim Weirich: No such file to load -- rubygems

Jim Weirich: No such file to load -- rubygems

Jim Weirich: No such file to load -- rubygems

Jim Weirich: RubyGems hangs while updating the source index.

Jim Weirich: RubyGems hangs while updating the source index.

Jim Weirich: `gemlock` script

Jim Weirich: `gemlock` script

Jim Weirich: `gemlock` script

Jim Weirich: `gemlock` script