Existe uma miríade útil e fascinante de bibliotecas para Ruby e muitas delas disponíveis através dos cómodos ficheiros gem. Outras são disponibilizadas como arquivos (.zip or .tar.gz) de código fonte. Vejamos como encontrar e instalar bibliotecas para uso próprio.

Encontrar Bibliotecas

O RubyForge(RubyForge) é o famoso lar das bibliotecas de Ruby. Um bom local para explorar é o seu mapa de software, que lista as bibliotecas por tópico. (Se acabar por criar as suas próprias bibliotecas, poderá registar o seu projecto no Rubyforge para obter um repositório em Subversion, espaço para alojamento do sítio do projecto e listas de discussão.)

O Ruby Application Archive(Ruby Application Archive) (ou RAA) é um directório de toda a conduta de software Ruby, categorizado por função. Actualmente a categoria Database é que tem mais entradas vencendo por 1 sobre Net. HTML e XML são também populares. Existem até quatro entradas em Physics.

Utilizando a biblioteca RubyGems

Apesar do programa de instalação em Windows incluir RubyGems, muitos sistemas operativos não as incluem. Se estes comandos não estiverem a funcionar consigo, consulte por favor, Instalando a biblioteca RubyGems.

Procurar por Gemas

O comando de procura pode ser usado para encontrar gemas com determinado nome. Para procurar a palavra “html” no nome da gema:

 $ gem search html --remote

 *** REMOTE GEMS ***

 html-sample (1.0, 1.1)
    A sample Ruby gem, just to illustrate how RubyGems works.

(A flag --remote indica que estamos a procurar nas gemas oficiais do RubyForge)

Instalando uma Gema

Uma vez encontrada a gema que se deseja, instalar:

 $ gem install html-sample

Poderá também instalar uma determinada versão da biblioteca utilizando a flag --version.

 $ gem install html-sample --version 1.0

Listando Todas as Gemas

Para uma lista completa de todas as gemas no Rubyforge:

 $ gem list --remote

Para listar somente as gemas que se instalaram, não use a flag.

 $ gem list

Para mais informações acerca da utilização da biblioteca RubyGems, veja o manual oficial, que inclui exemplos para a gemas nas suas scripts.

Instalando a biblioteca RubyGems

Para instalar a biblioteca RubyGems, descarregue a sua versão 0.9.0 da página de downloads. Descompacte o arquivo e execute setup.rb. Em alguns sistemas operativos será necessário executar esta operação como administrador.

Em Linux, por exemplo:

$ tar xzvf rubygems-0.9.0.tar.gz
$ cd rubygems-0.9.0
$ su -
# ruby setup.rb

Se necessitar mais instruções sobre como o Ruby, veja o capítulo de instalação no manual da biblioteca RubyGems.