RubyGems - Utilitário de pacote Ruby

RubyGems é um utilitário de pacote para Ruby, que instala pacotes de software Ruby e os mantém atualizados.

Sintaxe de uso

$ gem command [arguments...] [options...]

Exemplo

Verifique se RubyGems está instalado -

$ gem --version
0.9.0

Comandos RubyGems

Aqui está uma lista de todos os comandos importantes para RubyGems -

Sr. Não. Comando e Descrição
1

build

Constrói uma joia a partir de uma gemspec.

2

cert

Ajusta as configurações do certificado RubyGems.

3

check

Verifica gemas instaladas.

4

cleanup

Limpa versões antigas de joias instaladas no repositório local.

5

contents

Exibe o conteúdo das joias instaladas.

6

dependency

Mostra as dependências de uma gem instalada.

7

environment

Exibe informações ambientais do RubyGems.

8

help

Fornece ajuda no comando 'gem'.

9

install

Instala uma gema no repositório local.

10

list

Exibe todas as joias cujo nome começa com STRING.

11

query

Consulta informações de gem em repositórios locais ou remotos.

12

rdoc

Gera RDoc para gemas pré-instaladas.

13

search

Exibe todas as joias cujo nome contém STRING.

14

specification

Exibe a especificação da gema (em yaml).

15

uninstall

Desinstala uma gema do repositório local.

16

unpack

Descompacta uma gem instalada para o diretório atual.

17

update

Atualiza a gema nomeada (ou todas as gemas instaladas) no repositório local.

Opções de comando comuns do RubyGems

A seguir está a lista de opções comuns -

Sr. Não. Comando e Descrição
1

--source URL

Usa URL como fonte remota de joias.

2

-p, --[no-]http-proxy [URL]

Usa proxy HTTP para operações remotas.

3

-h, --help

Obtém ajuda neste comando.

4

--config-file FILE

Usa este arquivo de configuração em vez do padrão.

5

--backtrace

Mostra o backtrace da pilha em erros.

6

--debug

Ativa a depuração Ruby.

Opções de comando de instalação do RubyGems

Esta é uma lista de opções, que usa na maioria das vezes quando você usa RubyGems ao instalar qualquer pacote Ruby -

Sr. Não. Comando e Descrição
1

-v, --version VERSION

Especifica a versão do gem a ser instalada.

2

-l, --local

Restringe as operações ao domínio LOCAL (padrão).

3

-r, --remote

Restringe as operações ao domínio REMOTE.

4

-b, --both

Permite operações LOCAL e REMOTA.

5

-i, --install-dir DIR

Onde instalar.

6

-d, --[no-]rdoc

Gera documentação RDoc para o gem na instalação.

7

-f, --[no-]force

Força a instalação do gem, ignorando as verificações de dependência.

8

-t, --[no-]test

Executa testes de unidade antes da instalação.

9

-w, --[no-]wrappers

Usa bin wrappers para executáveis.

10

-P, --trust-policy POLICY

Especifica a política de confiança da gema.

11

--ignore-dependencies

Não instale nenhuma joia dependente necessária.

12

-y, --include-dependencies

Instala incondicionalmente as gemas dependentes necessárias.

Exemplos

Isso instalará 'SOAP4R', tanto do diretório local quanto do servidor remoto, incluindo todas as dependências -

gem install soap4r --include-dependencies

Isso irá instalar o 'rake', apenas do servidor remoto -

gem install rake --remote

Isso instalará o 'rake' do servidor remoto, executará testes de unidade e gerará RDocs -

gem install --remote rake --test --rdoc --ri

Leituras adicionais

  • o RubyGems User Guide oferece quase tudo que você precisa saber sobre como usar RubyGems.

  • o RubyGems Command Reference para RubyGems.