--- book: - chapter: - title: Basic Questions page: - body: | Because we needed it! And needed it badly. title: Why did you create this thing? - body: "No. It is based on the same idea, but the code was written from scratch (initially) at RubyConf 2003. " title: Is this the same RubyGems that was presented at RubyConf 2001? - body: |- p((. Doesn't this open a huge security hole? How can I trust the Gems which are automatically downloaded from the net? The same way you can trust all other code you install. (I.e. ultimately, you can't.) : Gems are not automatically downloaded from the 'net, they are manually downloaded from the 'net. It's essentially the same as grabbing a tarball from the RAA or RubyForge, but easier. The "automatic dependency" resolution prompts you for confirmation before installing anything. title: Security Issues - body: | p((. It'd be nice to package code as a Gem, and then have it easily portable to many packaging systems (e.g. manual, RubyGems, dpkg/apt-get and other distro specific packaging). A quick glance at RubyGems suggests that installation of a package as a Gem requires all of its dependencies to be gems also (due to require_gem). Thoughts on this? It would not be too difficult to create a convertor to auto-generate dpkg or rpm files out of gems. It has been on the TODO list since day 1, but it hasn't yet made it to the top of anyone's priority list. Anyone who would like to do this for one or more packaging systems is more than welcome! From Eivind Eklund: p((((. I believe this is undoable inside the required structures for most other packaging systems (based on the Filesystem Hierarchy Standard). FreeBSD and Debian at least requires following a structure that is different from and not compatible with one directory per gem. I believe the same requirements exists for other package repositories (Fedora, NetBSD, OpenBSD, at least), but have not looked at them in detail recently enough to remember with certainity. Automatic repackaging for RPA is undoable because RPA requires that the packages can be re-exported in the formats required by other packaging systems. (Oh, and I would LOVE to be proved wrong on this.) title: How well does RubyGems play with other packaging systems? - body: | p((. Is it possible (or is there a plan) to use RubyGems with "AllInOneRuby":http://www.rubygarden.org/ruby?AllInOneRuby or "RubyScript2Exe":http://www.rubygarden.org/ruby?RubyScript2Exe? It would seem so. Erik has been hard at work adding RubyGems support for both of those tools, and the current versions have both been successfully used with some gems. title: AllInOneRuby and RubyScript2Exe Compatibility - body: |- RubyGems no longer uses YAML for metadata. `gem help generate_index` shows the structure of a RubyGems source. http://rubygems.org no longer generates a yaml index, but the Marshal full index is still generated nightly. title: Where I can get the latest yaml metadata used by rubygems? - body: | Here are a couple of resources: * "RubyConf 2004 Presentation":http://onestepback.org/articles/rubygemsfacets * "RubyGems chapter in Pickaxe II"://www.pragmaticprogrammer.com/titles/ruby/index.html title: Where can I find out more about RubyGems? - title: Installation Questions page: - body: |- p((. I installed rubygems 0.8.3 and get the following error when trying to run the gem command: Could not find RubyGem sources (> 0.0.0). What's wrong? You may have been bitten by a 0.8.3 install bug. Try installing 0.8.7 or above. title: "Error: Could not find RubyGem sources (> 0.0.0)" - body: | p((. During a fresh install of RubyGems, I get the following error ... "in 'require': No such file to load -- rubygems/builder (LoadError)". What's wrong? Check to see that you have all the libraries needed by rubygems/builder. Missing libzlib-ruby or libyaml-ruby in particular can cause this error. Debian Linux users may also need to apt-get install libdrb-ruby and liberb-ruby and rdoc. title: Error "No such file to load -- rubygems/builder (LoadError)" - body: | p((. How can I install a gem from behind a Windows proxy that requires authentication? I've tried username(colon)password(at)proxyaddress in the --http-proxy url but that doesn't seem to work. This suggests you're behind an MS Proxy that does NTLM authentication. The proxy support in Ruby is currently only for Basic authentication. A workaround is to install "http://apserver.sourceforge.net apserver":http://apserver.sourceforge.net on your local machine, configure it and run gems through this proxy. * Install: Just download apserver 097 (and not the experimental 098!) and unpack. * Configure: Edit the server.cfg file and put the values for your MS proxy in PARENT_PROXY and PARENT_PROXY_PORT. Enter the values for DOMAIN and USER. Leave PASSWORD blank (nothing after the colon) - you will be prompted when launching it. * Run apserver: cd aps097; python main.py * Run Gems: gem install --http-proxy http://localhost:5865/ library title: Authenticating Windows Proxy Problems - body: |- 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. title: Installing gems in a non-standard directory. - title: Trouble Shooting Questions page: - body: |- Not every library has a strict mapping between the name of the gem and the name of the file you need to require. First you should check to see if the files match correctly: 
        $ gem list RedCloth
        
        *** LOCAL GEMS ***
        
        RedCloth (4.1.1)
        $ ruby -rubygems -e 'require "RedCloth"'
        /Library/Ruby/Site/1.8/rubygems/custom_require.rb:31:in `gem_original_require': no such file to load -- RedCloth (LoadError)
        	from /Library/Ruby/Site/1.8/rubygems/custom_require.rb:31:in `require'
        	from -e:1
        $ gem contents --no-prefix RedCloth | grep lib
        lib/case_sensitive_require/RedCloth.rb
        lib/redcloth/erb_extension.rb
        lib/redcloth/formatters/base.rb
        lib/redcloth/formatters/html.rb
        lib/redcloth/formatters/latex.rb
        lib/redcloth/formatters/latex_entities.yml
        lib/redcloth/textile_doc.rb
        lib/redcloth/version.rb
        lib/redcloth.rb
        $ ruby -rubygems -e 'require "redcloth"'
        $ # success!
If you're requiring the correct file, maybe `gem` is using a different ruby than `ruby`: 
$ which ruby
        /usr/local/bin/ruby
        $ gem env | grep 'RUBY EXECUTABLE'
           - RUBY EXECUTABLE: /usr/local/bin/ruby1.9
In this instance we've got two ruby installations so that `gem` uses a different version than `ruby`. You can probably fix this by adjusting a symlink: 
$ ls -l /usr/local/bin/ruby*
        lrwxr-xr-x  1 root  wheel       76 Jan 20  2010 /usr/local/bin/ruby@ -> /usr/local/bin/ruby1.8
        -rwxr-xr-x  1 root  wheel  1213160 Jul 15 16:36 /usr/local/bin/ruby1.8*
        -rwxr-xr-x  1 root  wheel  2698624 Jul  6 19:30 /usr/local/bin/ruby1.9*
        $ ls -l /usr/local/bin/gem*
        lrwxr-xr-x  1 root  wheel   76 Jan 20  2010 /usr/local/bin/gem@ -> /usr/local/bin/gem1.9
        -rwxr-xr-x  1 root  wheel  550 Jul 15 16:36 /usr/local/bin/gem1.8*
        -rwxr-xr-x  1 root  wheel  550 Jul  6 19:30 /usr/local/bin/gem1.9*
You may also need to give `irb` the same treatment. title: Why does require 'some_gem' fail? - body: | 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. title: Why does require return false when loading a file from a gem? - body: |- 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. title: No such file to load -- rubygems - body: |- You can submit bug reports in the "RubyGems bug tracker":http://rubyforge.org/tracker/?func=add&group_id=126&atid=575 You will need a RubyForge account. If you take a look at the "RubyGems bug list":http://rubyforge.org/tracker/?func=browse&group_id=126&atid=575 to see if the bug has already been filed the maintainers will really appreciate it. title: I think I found a bug - body: | p{font-style: italic}. I have a problem with RubyGems. It doesn't matter what I try to install with, it freezes. p{font-style: italic}. Particulary I tried to execute: gem install rails --include-dependencies p{font-style: italic}. but the command freezes at the following message: "Updating Gem source index for: http://gems.rubyforge.org" h3. Answer You'll need to upgrade RubyGems to a modern version. You can find instructions in the Downloads link at the top of this page. title: RubyGems hangs while updating the source index. - title: Advanced Questions page: - body: |- The simpliest way is to run the command: gem server This will serve all your installed gems from your local machine. The URL for the server will be @http://YOURHOSTNAME:8808@. Use the @--help@ option on @gem_server@ for a complete list of options. title: How do I run my own gem server? - body: | Don't forget to check out the "easy answer":http://docs.rubygems.org/read/chapter/18#page80 for running a simple gem server. But is is also fairly easy to serve gems from static files on an existing web server. Here's what you need to do. # Create a directory in the public files area of your web server (we will call that directory _BASEDIR_ in the following instructions). # Create the subdirectory _BASEDIR_/@gems@. # Copy any gems you wish to serve into the _BASEDIR_/@gems@ subdirectory. # Run the @generate_index@ gem command in order to generate the @yaml@ and @yaml.Z@ files needed by the RubyGems client. The command will look something like this: 
gem generate_index -d BASEDIR
That's it. The URL for the server will be whatever URL references _BASEDIR_. Just rerun the @generate_index@ gem command whenever you add (or remove) gems from the server. title: How do I run a gem server like rubyforge? body: "" title: RubyGems Frequently Asked Questions