dh_ruby - En ligne dans le Cloud

PROGRAMME:

Nom

dh_ruby - système de compilation debhelper7 pour les logiciels Ruby

SYNOPSIS

dh_ruby [OPTIONS]

DESCRIPTION

dh_ruby est un système de compilation Debhelper 7 pour les logiciels Ruby. Il compile et
installer les fichiers contenus dans les packages Ruby, en essayant de travailler aussi près que possible de Rubygems
mais respectant les standards Debian pour les paquets Ruby.

dh_ruby peut exécuter automatiquement vos tests sur toutes les versions Ruby prises en charge, voir le
Section « FICHIERS » ci-dessous.

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

SOURCE RANGEMENT LAYOUT

dh_ruby prend en charge deux styles de packages sources différents : les packages sources binaires uniques et
paquets sources multi-binaires.

Binaire unique disposition
La disposition par défaut est la binaire unique disposition. C'est la disposition utilisée par la plupart des langages Ruby
packages en amont, c'est-à-dire le code Ruby dans lib/, programmes exécutables dans coffre/, etc. Paquets
importé depuis 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 support pour le multibinaire mise en page. Cette mise en page devrait
être utilisé lorsque vous avez un ensemble de différents packages Ruby 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 distincts à partir de la même racine
répertoire. Pour ces cas, consultez la documentation sur DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
ci-dessous.

Pour indiquer que vous souhaitez utiliser une disposition multibinaire, nous devons 1) lister vos multiples
paquets binaires dans debian / contrôle comme d'habitude, et ajoutez un champ supplémentaire appelé Racine X-DhRuby à
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
bin/foo
bar/
barre.gemspec
lib /
bar.rb
poubelle/
Bar

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

· Si votre package utilise la disposition multibinaire, il doit inclure `gem2deb (>= 0.4.0~)` dans
Dépend de la construction.

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

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

· Si un package binaire déclare un Racine X-DhRuby champ, tous les autres packages binaires qui
ne pas en avoir sera ignoré par dh_ruby.

OPTIONS

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

--print-pris en charge
Imprime les versions Ruby prises en charge.

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

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

--gem-install
Cette option indique que la construction doit utiliser le gemme commande pour installer les fichiers,
au lieu de l'installateur maison. Les paquets 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 construction doit utiliser configuration.rb plutôt que la gemme habituelle-
Build basé. Pour être effective, cette option doit être activée en premier !

ENVIRONNEMENT VARIABLES

DH_RUBY
Utilisez cette variable pour transmettre des paramètres de ligne de commande à dh_ruby. Par exemple,
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 package.
Les noms de test disponibles sont les noms de toutes les versions de Ruby prises en charge (vous pouvez les lister
avec `dh_ruby --print-supported`).

Si défini sur « all », tous les tests seront ignorés pendant la construction du package.

DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
Si cette variable est définie (sur n'importe quoi), dh_ruby respectera le répertoire informé
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 sources multi-binaires qui ne sont pas conformes aux normes prises en charge.
mise en page (c'est-à-dire des sous-répertoires séparés, chacun avec lib/, coffre/ etc). Grâce à cela, tous les fichiers
sera installé sur debian/tmp, et vous pouvez les distribuer dans des fichiers binaires séparés
paquets en utilisant debian/$package.install fichiers ou appels shell explicites dans
debian/règles.

Mixage audio DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR et la disposition multibinaire n'est pas prise en charge.

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

Dans le cas où il y a plus d'un .gemspec dans la racine du paquet source, vous devrez need
d'utiliser DH_RUBY_GEMSPEC pour indiquer à dh_ruby lequel utiliser.

Utilisez dh_ruby en ligne avec les services onworks.net