Il existe une très large gamme de bibliothèques, toutes plus utiles et intéressantes les unes que les autres, et bien souvent distribuées sous la forme d’une gem—sinon, en tant que fichier compressé .zip our .tar.gz. Comment trouver et installer ces bibliothèques ?

Trouver des bibliothèques

RubyForge est un des sites principaux—sinon le site principal. Vous pouvez commencer par jeter un œil à la carte des logiciels, qui regroupe les bibliothèques par thématiques. Si vous êtes vous-même l’auteur d’une bibliothèque et souhaitez la faire héberger sur RubyForge, inscrivez-vous pour avoir un accès Subversion, un espace perso et des listes de diffusion.

Ruby Application Archive (RAA) recense tout type de programmes Ruby, organisés selon leur fonction opérationnelle. Très riche.

Utiliser RubyGems

Bien que l’installateur Windows de Ruby propose d’emblée RubyGems, ce n’est pas forcément le cas partout. Voyez donc pour commencer la section Installer RubyGems ci-dessous dans le cas où vous n’auriez pas encore RubyGems.

Rechercher des gems

La commande search permet de retrouver des gems selon leurs noms. Ainsi, une recherche sur le mot « audio » :

gem search audio --remote

*** REMOTE GEMS ***

audioscrobbler (0.0.1)
    Library to submit music playlists to Last.fm

Le mot-clé --remote ordonne d’effectuer la recherche directement dans le catalogue officiel des gems hébergées sur Rubyforge.

Installer une gem

Une fois que vous avez choisi une bilbiothèque à installer, utilisez install :

 $ gem install audioscrobbler

Vous pouvez par ailleurs ordonner l’installation d’une bibliothèque dans une version précise :

 $ gem install html-sample --version 1.0

Lister toutes les gems

Pour récupérer la liste complète des gems disponibles sur RubyForge :

 $ gem list --remote

Pour afficher uniquement les gems que vous avez installées :

 $ gem list

Pour plus d’informations sur l’usage de RubyGems, reportez-vous à la documentation officielle, qui donne notamment des exemples sur l’utilisation de RubyGems dans vos programmes.

Installer RubyGems

Pour pouvoir utiliser RubyGems, récupérez la dernière version du programme (0.9.0) sur la page Téléchargement du projet. Décompressez l’archive et lancez setup.rb. Sur certains systèmes *nix, il vous faudra les droits d’administrateur pour procéder à l’installation complète.

Ainsi, sous Linux :

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

Si vous avez besoin d’informations complémentaires sur l’installation de Ruby, voyez le chapitre Installation du manuel RubyGems.