Il existe une très large gamme de bibliothèques, bien souvent distribuées sous la forme d’une gem, sinon en tant qu’archive contenant le code source. Cette page décrit 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
RubyGems est décrit sur son site officiel comme le « système de paquetage principal pour Ruby. Il offre un format standard de distribution des programmes et librairies ruby, les “gems”, et met à disposition un outil en ligne de commande simple à utiliser pour installer et gérer les gems. » D’une certaine manière, RubyGems est un équivalent à, par exemple, apt-get, mais spécifiquement conçu pour les programmes ruby. Le dépôt officiel de gems est RubyGems.org.
Bien que l’installateur Windows de Ruby propose d’emblée RubyGems, ce n’est pas forcément le cas pour tous les systèmes d’exploitation. Voyez donc pour commencer la section Installer RubyGems ci-dessous, dans le cas où vous n’auriez pas encore installé RubyGems.
Rechercher des gems
La commande search permet de retrouver des gems selon leurs noms. Ainsi, une recherche sur le mot « audio » :
$ gem search html --remote
*** REMOTE GEMS ***
html-sample (1.0, 1.1)
Le mot-clé --remote / -r ordonne d’effectuer la recherche directement dans
le catalogue officiel des gems hébergées sur Gemcutter.
Installer une gem
Une fois que vous avez choisi une bibliothèque à installer, utilisez la
commande install:
$ gem install html-sample
Vous pouvez par ailleurs ordonner l’installation d’une version précise
avec l’option --version:
$ gem install html-sample --version 1.0
Lister toutes les gems
Pour récupérer la liste complète des gems disponibles sur Gemcutter :
$ 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 (1.3.7) sur la page Téléchargement du projet.
Décompressez l’archive et lancez setup.rb. Sur certains systèmes
d’exploitation, il vous faudra les droits d’administrateur pour procéder
à l’installation complète.
Ainsi, sous GNU/Linux :
$ tar xzvf rubygems-1.3.7.tar.gz
$ cd rubygems-1.3.7
$ su -
$ ruby setup.rb
Si vous avez besoin d’informations complémentaires sur l’installation de Ruby, voyez le chapitre Installation du manuel RubyGems.