dh_ruby - En ligne dans le Cloud

PROGRAMME:

Nom

dh_ruby - système de construction debhelper7 pour le logiciel Ruby

SYNOPSIS

dh_ruby [OPTIONS]

DESCRIPTION

dh_ruby est un système de build Debhelper 7 pour le logiciel Ruby. Il sera automatiquement construit et
installer les fichiers contenus dans les packages Ruby, en essayant de travailler aussi près que possible de Rubygems
mais en respectant les standards Debian pour les paquets Ruby.

dh_ruby peut exécuter automatiquement vos tests sur toutes les versions de Ruby prises en charge, consultez le
section « FILES » ci-dessous.

Voir dh_ruby --help pour plus de détails.

SOURCE RANGEMENT LAYOUT

dh_ruby prend en charge deux styles de package source différents : les packages source à un seul binaire et
paquets de sources multi-binaires.

Simple-binaire disposition
La disposition par défaut est la simple-binaire disposition. C'est la disposition utilisée par la plupart des Ruby
paquets en amont, c'est-à-dire du code Ruby dans lib/, programmes exécutables dans coffre/, etc.
importé de Rubygems en utilisant gem2deb(1) aura cette disposition.

Lorsque vous utilisez cette mise en page, dh_ruby installera les fichiers (code Ruby, exécutables, gemspecs) sur
le premier binaire paquet répertorié dans debian / contrôle.

Multi-binaire disposition
gem2deb version 0.4.0 introduit un soutien à la multi-binaire disposition. Cette disposition doit
être utilisé lorsque vous avez un ensemble de packages Ruby différents maintenus en amont dans un seul
VCS, et vous décidez que vous souhaitez également maintenir un seul paquet source dans Debian
ayant les différents composants sous forme de packages binaires séparés.

Dans cette disposition, le package source contient les composants séparés dans des sous-répertoires
où chacun d'eux utilisera la mise en page Ruby standard (lib/, coffre/, etc).

Cette disposition ne prend pas en charge la création de packages binaires séparés à partir de la même racine
annuaire. Pour ces cas, consultez la documentation sur DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
ci-dessous.

Pour indiquer que vous souhaitez utiliser une mise en page multi-binaire, nous devons 1) lister vos multiples
paquets binaires dans debian / contrôle comme d'habitude, et ajoutez un champ supplémentaire appelé X-DhRuby-Racine à
chaque strophe de package binaire, indiquant quel répertoire doit être utilisé comme racine pour cela
paquet binaire.

Un exemple:

Source : mymultibinarypackage
[...]

Paquet : ruby-foo
X-DhRuby-Root : chemin/vers/foo
[...]

Paquet : ruby-bar
X-DhRuby-Root : chemin/vers/barre

Le package source correspondant doit être présenté comme ceci :

fou/
foo.gemspec
lib /
foo.rb
poubelle/foo
bar/
bar.gemspec
lib /
bar.rb
poubelle/
barre

Remarques importantes sur les packages multi-binaires et l'utilisation de X-DhRuby-Racine:

· Si votre package utilise la mise en page multi-binaire, il doit inclure `gem2deb (>= 0.4.0~)` dans
Dépend de la construction.

Version 0.4.0 ait eu a bug in le Support en indigène extensions dans des packages multi-binaires,
donc si votre package utilise la fonctionnalité multi-binaire et au moins l'un des sous-
composants a des extensions natives, vous devez utiliser `gem2deb (>= 0.4.1~)` dans Dépend de la construction
à la place.

· Le chemin indiqué dans X-DhRuby-Racine, comme vous l'avez probablement deviné maintenant, doit être
par rapport à la racine du paquet source.

· Si un paquet binaire déclare un X-DhRuby-Racine champ, tous les autres packages binaires qui
n'en avez pas sera ignoré par dh_ruby.

OPTIONS

--nettoyer, --configurer, --construire, --test, --installer
Commandes appelées par debhelper à différentes étapes du processus de génération.

--support d'impression
Imprime les versions Ruby prises en charge.

-h, --Aidez-moi
Vitrine dh_ruby informations d'utilisation.

-v, --version
Vitrine dh_ruby information sur la version.

--gem-installer
Cette option indique que la construction doit utiliser le gemme commande pour installer les fichiers,
au lieu de l'installateur local. Les packages natifs seront installés sur
/ usr / lib /$ARCH/rubygems-integration/$RUBY_VERSION, tandis que les packages Ruby purs seront
installé à /usr/share/rubygems-integration/all.

--setuprb
Cette option indique que la compilation doit utiliser configuration.rb plutôt que le joyau habituel-
construction basée. Pour prendre effet, cette option doit venir en premier !

ENVIRONNEMENT VARIABLES

DH_RUBY
Utilisez cette variable pour transmettre des paramètres de ligne de commande à dh_ruby. Par exemple dans
debian/règles :

exporter DH_RUBY = --gem-install

DH_RUBY_IGNORE_TESTS
Il s'agit d'une liste de tests séparés par des espaces que dh_ruby ignorera lors de la construction du paquet.
Les noms de test disponibles sont les noms de toutes les versions de Ruby prises en charge (vous pouvez lister
avec `dh_ruby --print-supported`).

S'il est défini sur "all", tous les tests seront ignorés lors de la construction du package.

DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
Si cette variable est définie (à quoi que ce soit), dh_ruby respectera le répertoire renseigné
by dh_auto_install(1), généralement debian/tmp. Par défaut, gem2deb installera les fichiers sur
debian/paquet, Où paquet est le premier paquet binaire répertorié dans debian/control.

Ceci est utile pour les packages source multi-binaires qui ne sont pas conformes aux
layout (c'est-à-dire des sous-répertoires séparés chacun avec lib/, coffre/ etc). En utilisant cela, tous les fichiers
sera installé à debian/tmp, et vous pouvez les distribuer dans un binaire séparé
paquets en utilisant debian/$paquet.install fichiers ou appels shell explicites dans
debian/règles.

Mixage audio DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR et la disposition multi-binaire n'est pas prise en charge.

DH_RUBY_GEMSPEC
Détermine quel fichier contient la spécification gem avec les métadonnées du package. Par
par défaut, dh_ruby lira les métadonnées d'un fichier .gemspec à la racine du package source
annuaire. Vous pouvez utiliser cette variable pour remplacer cela si vous souhaitez fournir des
métadonnées pour le paquet Debian.

S'il y a plus d'un .gemspec dans la racine du package source, vous devrez need
pour utiliser DH_RUBY_GEMSPEC pour indiquer à dh_ruby lequel utiliser.

Utilisez dh_ruby en ligne en utilisant les services onworks.net