Bibliotecas

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 flag --remote / -r 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.