rubygems

Rubygems

Rubygems est un cadre de gestion des packages pour Ruby.

Un package (également appelé bibliothèque) contient un ensemble de fonctionnalités qui peuvent être invoquées par un programme Ruby, tel que la lecture et l'analyse d'un fichier XML. Nous appelons ces packages "Gems" et RubyGems est un outil pour installer, créer, gérer et charger ces packages dans votre environnement Ruby.

Rubygems est également un client de RubyGems.org, un référentiel public de gemmes qui vous permet de publier un joyau qui peut être partagé et utilisé par d'autres développeurs. Voir notre guide sur la publication d'un joyau à guides.rubygems.org

Commencer

L'installation et la gestion d'un joyau se font via la commande gem . Pour installer un joyau tel que Nokogiri qui vous permet de lire et d'analyser XML dans Ruby:

 $ gem install nokogiri

Rubygems téléchargera le gemme NoKogiri de Rubygems.org et l'installera dans votre environnement Ruby.

Enfin, à l'intérieur de votre programme Ruby, chargez la gemme NoKogiri et commencez à analyser votre XML:

 require 'nokogiri'

Nokogiri.XML('<h1>Hello World</h1>')

Pour plus d'informations sur la façon d'utiliser Rubygems, consultez notre guide de base RubyGems sur guides.rubygems.org

Exigences

• Rubygems prend en charge Ruby 3.0 ou version ultérieure.

Installation

Rubygems est déjà installé dans votre environnement Ruby, vous pouvez vérifier la version que vous avez installée en exécutant gem --version dans votre émulateur de terminal.

Dans certains cas, Ruby et Rubygems peuvent être fournis comme packages OS. Ce n'est pas un moyen recommandé d'utiliser Ruby et Rubygems. Il est préférable d'utiliser un gestionnaire de version Ruby, comme RBENV ou Chruby. Si vous souhaitez toujours utiliser la version fournie par votre gestionnaire de packages OS, veuillez également utiliser votre gestionnaire de packages OS pour mettre à niveau RubyGems et ne pas tenir compte de toute autre instruction d'installation ci-dessous.

Si vous souhaitez installer manuellement RubyGems:

• Télécharger depuis https://rubygems.org/pages/download, déballer et cd dans SRC de RubyGems
• Ou cloner ce référentiel et cd dans le référentiel

Installez Rubygems en fonctionnant:

 $ ruby setup.rb

Pour plus de détails et d'autres options, voir:

 $ ruby setup.rb --help

Mise à niveau de Rubygems

Pour passer aux derniers rubygems, exécutez:

 $ gem update --system

Voir la mise à niveau pour plus de détails et des instructions alternatives.

Politique de libération

Rubygems et Bundler sont publiés en synchronisation, bien qu'ils ne partagent pas leur numéro de version majeur. Il est prévu que leurs principaux numéros de version seront également synchronisés à l'avenir.

La politique de publication est quelque peu similaire à la politique de publication de Ruby elle-même:

• Des rejets de correctifs fréquents (toutes les 2 à 4 semaines), y compris des corrections de bogues, des améliorations mineures, de petites fonctionnalités ou même des fonctionnalités de taille moyenne déclarées expérimentales pour les tests de bataille.
• Des versions mineures annuelles, y compris des fonctionnalités plus importantes et des changements de rupture mineurs (affectant uniquement les cas de bord et un très petit ensemble d'utilisateurs).
• Des versions majeures occasionnelles (remplaçant les mineurs annuelles), y compris des changements de rupture majeurs.

Documentation

RubyGems utilise RDOC pour la documentation. Un ensemble compilé des documents peut être consulté en ligne sur Rubydoc.

Rubygems fournit également un ensemble complet de guides qui couvre de nombreux sujets tels que la création d'un nouveau joyau, des pratiques de sécurité et d'autres ressources sur https://guides.rubygems.org

Obtenir de l'aide

Billets de classement

Vous avez un bug et vous n'êtes pas sûr? Vous êtes sûr d'avoir un bug, mais vous ne savez pas quoi faire ensuite? En tout cas, faites-le nous savoir! Le meilleur endroit pour informer l'équipe de Rubygems sur les bogues ou les problèmes que vous rencontrez est sur la page des problèmes Rubygems chez GitHub.

Compatibilité du bundler

Voir https://bundler.io/compatibilité pour les problèmes connus.

Justificatif

Rubygems est géré par Ruby Central, une organisation à but non lucratif qui soutient la communauté Ruby à travers des projets comme celui-ci, ainsi que RumbyConf, RailsConf et Rubygems.org. Vous pouvez soutenir Ruby Central en assistant ou en parrainant une conférence, ou en vous joignant en tant que membre de soutien.

Contributif

Si vous souhaitez contribuer à Rubygems, c'est génial, et nous <3 vous. Consultez notre guide pour contribuer pour plus d'informations.

Code de conduite

Tout le monde interagit dans les bases de code, les trackers de problèmes, les salles de discussion et les listes de diffusion du Rubygems, devrait suivre le code de conduite des contributeurs.