dh_ruby - Online en la nube

PROGRAMA:

NOMBRE

dh_ruby: sistema de compilación debhelper7 para el software Ruby

SINOPSIS

dh_rubí [CAMPUS]

DESCRIPCIÓN

dh_rubí es un sistema de compilación Debhelper 7 para software Ruby. Automáticamente construirá y
instalar archivos contenidos en paquetes de Ruby, tratando de trabajar lo más cerca posible de Rubygems
pero respetando los estándares de Debian para paquetes Ruby.

dh_ruby puede ejecutar automáticamente sus pruebas en todas las versiones de Ruby compatibles, consulte la
Sección "ARCHIVOS" a continuación.

Consulte dh_ruby --help para obtener más detalles.

FUENTE PAQUETE DISPOSICIÓN

dh_rubí admite dos estilos de paquetes fuente diferentes: paquetes fuente binarios únicos y
paquetes fuente multi-binarios.

Binario único diseño
El diseño predeterminado es el binario simple diseño. Este es el diseño utilizado por la mayoría de Ruby
paquetes en sentido ascendente, es decir, código Ruby en lib/, programas ejecutables en papelera/, etc. Paquetes
importado de Rubygems usando gem2deb(1) tendrá este diseño.

Al usar este diseño, dh_rubí instalará archivos (código Ruby, ejecutables, gemspecs) para
las la primera binario paquete enumerado en debian / control.

Multi-binario diseño
gem2deb versión 0.4.0 introdujo soporte para el multibinario diseño. Este diseño debe
ser utilizado cuando tiene un conjunto de diferentes paquetes de Ruby mantenidos aguas arriba en un solo
VCS, y decide que también desea mantener un paquete fuente único en Debian
teniendo los diferentes componentes como paquetes binarios separados.

En este diseño, el paquete fuente contiene los componentes separados en subdirectorios
donde cada uno de ellos usará el diseño estándar de Ruby (lib/, papelera/, etc.).

Este diseño no admite la creación de paquetes binarios separados desde la misma raíz.
directorio. Para esos casos, consulte la documentación en DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
abajo.

Para indicar que desea utilizar un diseño multibinario, tenemos que 1) enumerar sus múltiples
paquetes binarios en debian / control como de costumbre, y agregue un campo adicional llamado X-DhRuby-Raíz a
cada estrofa de paquete binario, indicando qué directorio debe usarse como raíz para ese
paquete binario.

Un ejemplo:

Fuente: mymultibinarypackage
[...]

Paquete: ruby-foo
X-DhRuby-Root: ruta / a / foo
[...]

Paquete: barra de rubí
X-DhRuby-Root: ruta / a / bar

El paquete fuente correspondiente se debe distribuir así:

foo /
foo.gemspec
lib /
foo.rb
bin / foo
bar/
bar.gemspec
lib /
bar.rb
compartimiento/
de caramelos

Notas importantes sobre paquetes multibinarios y el uso de X-DhRuby-Raíz:

· Si su paquete utiliza el diseño multibinario, debe incluir `gem2deb (> = 0.4.0 ~) `en
Depende de la construcción.

Versión 0.4.0 tenido a error in las SOPORTE para nativo extensiones en paquetes multibinarios,
por lo que si su paquete usa la función multibinaria y al menos una de las sub-
componentes tiene extensiones nativas, debe usar `gem2deb (> = 0.4.1 ~) `en Depende de la construcción
preferiblemente.

· El camino indicado en X-DhRuby-Raíz, como probablemente ya habrá adivinado, debe ser
relativo a la raíz del paquete fuente.

· Si algún paquete binario declara un X-DhRuby-Raíz campo, todos los demás paquetes binarios que
no tengo uno será ignorado por dh_rubí.

CAMPUS

--limpio, --configurar, --construir, --prueba, --Instalar en pc
Comandos llamados por debhelper en varios pasos del proceso de construcción.

- compatible con impresión
Imprime las versiones de Ruby compatibles.

-h, --ayuda
Muestra dh_rubí información de uso.

-v, --versión
Muestra dh_rubí información de versión.

--gem-instalar
Esta opción indica que la compilación debe usar el joya comando para instalar los archivos,
en lugar del instalador de cosecha propia. Los paquetes nativos se instalarán en
/ usr / lib /$ ARCH / rubygems-integration / $ RUBY_VERSION, mientras que los paquetes Ruby puros serán
instalado a / usr / share / rubygems-integration / todos.

--setuprb
Esta opción indica que la compilación debe usar configuración.rb en lugar de la gema habitual
construcción basada. ¡Para que surta efecto, esta opción debe ser lo primero!

MEDIO AMBIENTE VARIABLES

DH_RUBY
Utilice esta variable para pasar los parámetros de la línea de comandos a dh_ruby. Por ejemplo en
debian / reglas:

exportar DH_RUBY = --gem-install

DH_RUBY_IGNORE_TESTS
Esta es una lista de pruebas separadas por espacios que dh_ruby ignorará durante la construcción del paquete.
Los nombres de prueba disponibles son los nombres de todas las versiones de Ruby compatibles (puede enumerar
ellos con `dh_ruby --print-supported`).

Si se establece en "todas", todas las pruebas se ignorarán durante la compilación del paquete.

DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
Si esta variable está definida (a algo), dh_ruby respetará el directorio informado
by dh_auto_instalar(1), generalmente debian / tmp. De forma predeterminada, gem2deb instalará archivos en
debian /paquete, Donde paquete es el primer paquete binario listado en debian / control.

Esto es útil para paquetes fuente multibinarios que no se ajustan a los
diseño (es decir, subdirectorios separados cada uno con lib/, papelera/ etc). Usando esto, todos los archivos
se instalará en debian / tmp, y puede distribuirlos en binarios separados
paquetes usando debian / $ paquete.instalar archivos o llamadas de shell explícitas en
debian / reglas.

Mezcla DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR y el diseño multibinario no es compatible.

DH_RUBY_GEMSPEC
Determina qué archivo contiene la especificación de la gema con los metadatos del paquete. Por
por defecto, dh_ruby leerá los metadatos de un archivo .gemspec en la raíz del paquete fuente
directorio. Puede utilizar esta variable para anular eso si desea proporcionar
metadatos para el paquete Debian.

En el caso de que haya más de un .gemspec en la raíz del paquete fuente, necesite
utilizar DH_RUBY_GEMSPEC para indicar a dh_ruby cuál utilizar.

Use dh_ruby en línea usando los servicios de onworks.net