rubygems

Rubygems

Rubygems é uma estrutura de gerenciamento de pacotes para Ruby.

Um pacote (também conhecido como biblioteca) contém um conjunto de funcionalidades que podem ser chamadas por um programa Ruby, como leitura e análise de um arquivo XML. Chamamos esses pacotes de "gemas" e rubygems é uma ferramenta para instalar, criar, gerenciar e carregar esses pacotes em seu ambiente de rubi.

O Rubygems também é um cliente da Rubygems.org, um repositório público de gemas que permite publicar uma jóia que pode ser compartilhada e usada por outros desenvolvedores. Veja nosso guia sobre a publicação de uma jóia em guias.rubygems.org

Começando

Instalar e gerenciar uma gem é feita através do comando gem . Para instalar uma jóia como Nokogiri que permite ler e analisar XML em Ruby:

 $ gem install nokogiri

Rubygems baixará a gema Nokogiri do rubygems.org e a instalará em seu ambiente de rubi.

Finalmente, dentro do seu programa Ruby, carregue a jóia Nokogiri e comece a analisar seu XML:

 require 'nokogiri'

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

Para obter mais informações sobre como usar o Rubygems, consulte nosso Rubygems Basics Guide em guias.rubygems.org

Requisitos

• Rubygems suporta Ruby 3.0 ou posterior.

Instalação

O Rubygems já está instalado em seu ambiente Ruby, você pode verificar a versão que você instalou executando gem --version no seu emulador de terminal.

Em alguns casos, a Ruby & Rubygems pode ser fornecida como pacotes do sistema operacional. Esta não é uma maneira recomendada de usar Ruby & Rubygems. É melhor usar um gerenciador de versão Ruby, como RBENV ou Chruby. Se você ainda deseja usar a versão fornecida pelo seu gerenciador de pacotes do SO, use também o gerenciador de pacotes do OS para atualizar o Rubygems e desconsidere quaisquer outras instruções de instalação fornecidas abaixo.

Se você deseja instalar manualmente os rubygems:

• Download de https://rubygems.org/pages/download, descompactar e cd no SRC de Rubygems
• Ou clonar este repositório e cd no repositório

Instale os rubygems executando:

 $ ruby setup.rb

Para mais detalhes e outras opções, consulte:

 $ ruby setup.rb --help

Atualizando Rubygems

Para atualizar para os mais recentes Rubygems, Run:

 $ gem update --system

Consulte Atualização para obter mais detalhes e instruções alternativas.

Política de liberação

Rubygems e Bundler são lançados em sincronia, embora não compartilhem o número principal da versão. Está planejado que também os números principais da versão sejam sincronizados no futuro.

A política de liberação é um pouco semelhante à política de liberação do próprio Ruby:

• Liberações frequentes de patches (a cada 2-4 semanas), incluindo correções de bugs, aprimoramentos menores, pequenos recursos ou até recursos de tamanho médio declarados como experimentais para testes de batalha.
• Lançamentos menores anuais, incluindo recursos maiores e pequenas mudanças de ruptura (afetando apenas casos de borda e um conjunto muito pequeno de usuários).
• Os principais lançamentos ocasionais (substituindo menores anuais), incluindo grandes mudanças de ruptura.

Documentação

Rubygems usa o RDOC para documentação. Um conjunto compilado dos documentos pode ser visualizado on -line no Rubydoc.

A Rubygems também fornece um conjunto abrangente de guias que abrange vários tópicos, como criar uma nova jóia, práticas de segurança e outros recursos em https://guides.rubygems.org

Obtendo ajuda

Arquivamento de ingressos

Tem um bug e você não tem certeza? Você tem certeza de que tem um bug, mas não sabe o que fazer a seguir? De qualquer forma, deixe -nos saber sobre isso! O melhor lugar para informar a equipe da Rubygems sobre bugs ou problemas que você está tendo está na página Rubygems Issues no Github.

Compatibilidade do Bundler

Consulte https://bundler.io/compatibilidade para questões conhecidas.

Apoio

A Rubygems é gerenciada pela Ruby Central, uma organização sem fins lucrativos que suporta a comunidade Ruby através de projetos como este, bem como Rubyconf, Railsconf e Rubygems.org. Você pode apoiar a Ruby Central participando ou patrocinando uma conferência ou ingressando como membro de apoio.

Contribuindo

Se você deseja contribuir para Rubygems, isso é incrível, e nós <3 você. Confira nosso guia para contribuir para obter mais informações.

Código de Conduta

Todos interagindo nas bases de código do Rubygems Project, rastreadores, salas de bate -papo e listas de discussão devem seguir o código de conduta do colaborador.