dh_ruby - Online na nuvem

PROGRAMA:

NOME

dh_ruby - sistema de compilação debhelper7 para software Ruby

SINOPSE

dh_ruby [OPÇÕES]

DESCRIÇÃO

dh_ruby é um sistema de compilação Debhelper 7 para software Ruby. Ele irá construir automaticamente e
instalar arquivos contidos em pacotes Ruby, tentando trabalhar o mais próximo possível do Rubygems
mas respeitando os padrões Debian para pacotes Ruby.

dh_ruby pode executar automaticamente seus testes em todas as versões suportadas de Ruby, consulte o
Seção "ARQUIVOS" abaixo.

Veja dh_ruby --help para detalhes.

FONTE PACKAGE LAYOUT

dh_ruby suporta dois estilos de pacote de origem diferentes: pacotes de origem binária única e
pacotes fonte multi-binários.

Binário único traçado
O layout padrão é o binário único layout. Este é o layout usado pela maioria dos Ruby
pacotes upstream, ou seja, código Ruby em lib/, programas executáveis ​​em caixa/, etc. Pacotes
importado de Rubygems usando gem2deb(1) terá esse layout.

Ao usar este layout, dh_ruby irá instalar arquivos (código Ruby, executáveis, gemspecs) para
que o primeiro binário pacote listados em debian / control.

Multi-binário traçado
gem2deb versão 0.4.0 introduziu suporte para o multi-binário layout. Este layout deve
ser usado quando você tem um conjunto de diferentes pacotes Ruby mantidos upstream em um único
VCS, e você decide que também deseja manter um único pacote fonte no Debian
tendo os diferentes componentes como pacotes binários separados.

Neste layout, o pacote de origem contém os componentes separados em subdiretórios
onde cada um deles usará o layout Ruby padrão (lib/, caixa/, etc.).

Este layout não suporta a criação de pacotes binários separados da mesma raiz
diretório. Para esses casos, consulte a documentação sobre DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
abaixo.

Para indicar que você deseja usar um layout multi-binário, temos que 1) listar seus múltiplos
pacotes binários em debian / control como de costume, e adicione um campo extra chamado Raiz X-DhRuby para
cada estrofe de pacote binário, indicando qual diretório deve ser usado como raiz para aquele
pacote binário.

Um exemplo:

Fonte: mymultibinarypackage
[...]

Pacote: ruby-foo
X-DhRuby-Root: caminho / para / foo
[...]

Pacote: barra de rubi
X-DhRuby-Root: caminho / para / bar

O pacote de origem correspondente deve ter o seguinte formato:

foo /
foo.gemspec
lib /
foo.rb
bin / foo
Barra/
barra.gemspec
lib /
barra.rb
bin /
Barra

Notas importantes sobre pacotes multi-binários e o uso de Raiz X-DhRuby:

· Se o seu pacote usa o layout multi-binário, ele deve incluir `gem2deb (> = 0.4.0 ~) `em
Build-Depende.

Versão 0.4.0 tinha a erro in que o ajuda para nativo extensões em pacotes multi-binários,
então, se o seu pacote usa o recurso multi-binário e pelo menos um dos sub
componentes tem extensões nativas, você deve usar `gem2deb (> = 0.4.1 ~) `em Build-Depende
ao invés.

· O caminho indicado em Raiz X-DhRuby, como você provavelmente já deve ter adivinhado, deve ser
em relação à raiz do pacote de origem.

· Se algum pacote binário declara um Raiz X-DhRuby campo, todos os outros pacotes binários que
não tem um será ignorado por dh_ruby.

OPÇÕES

--limpar, --configurar, --construir, --teste, --instalar
Comandos chamados pelo debhelper em várias etapas do processo de construção.

--suportado para impressão
Imprime as versões de Ruby com suporte.

-h, --Socorro
Displays dh_ruby informações de uso.

-v, --versão
Displays dh_ruby versão informação.

--gem-instalar
Esta opção indica que a construção deve usar o jóia comando para instalar os arquivos,
em vez do instalador local. Pacotes nativos serão instalados em
/ usr / lib /$ ARCH / rubygems-integration / $ RUBY_VERSION, enquanto os pacotes Ruby puros serão
instalado em / usr / share / rubygems-integration / all.

--setuprb
Esta opção indica que a construção deve usar configuração.rb em vez da gema usual
construção baseada. Para ter efeito, esta opção deve vir primeiro!

MEIO AMBIENTE VARIÁVEIS

DH_RUBY
Use esta variável para passar os parâmetros da linha de comando para dh_ruby. Por exemplo em
debian / rules:

exportar DH_RUBY = --gem-install

DH_RUBY_IGNORE_TESTS
Esta é uma lista de testes separados por espaço que dh_ruby irá ignorar durante a construção do pacote.
Os nomes de teste disponíveis são os nomes de todas as versões Ruby suportadas (você pode listar
com `dh_ruby --print-supported`).

Se definido como "all", todos os testes serão ignorados durante a construção do pacote.

DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
Se esta variável for definida (para qualquer coisa), dh_ruby respeitará o diretório informado
by dh_auto_install(1), geralmente debian / tmp. Por padrão, o gem2deb irá instalar arquivos para
debian /pacote, Onde pacote é o primeiro pacote binário listado em debian / control.

Isso é útil para pacotes de origem multi-binários que não estão em conformidade com os
layout (ou seja, subdiretórios separados, cada um com lib/, caixa/ etc). Usando isso, todos os arquivos
será instalado em debian / tmp, e você pode distribuí-los em binários separados
pacotes usando debian / $ package.install arquivos ou chamadas de shell explícitas em
debian / rules.

Misturando DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR e o layout multi-binário não é compatível.

DH_RUBY_GEMSPEC
Determina qual arquivo contém a especificação gem com metadados do pacote. Por
padrão, dh_ruby lerá metadados de um arquivo .gemspec na raiz do pacote de origem
diretório. Você pode usar esta variável para substituir isso se quiser fornecer
metadados para o pacote Debian.

No caso de haver mais de um .gemspec na raiz do pacote fonte, você necessidade
para usar DH_RUBY_GEMSPEC para instruir dh_ruby sobre qual usar.

Use dh_ruby online usando serviços onworks.net