dh_ruby - Online in de cloud

PROGRAMMA:

NAAM

dh_ruby - debhelper7 bouwsysteem voor Ruby-software

KORTE INHOUD

dh_ruby [OPTIES]

PRODUCTBESCHRIJVING

dh_ruby is een Debhelper 7-buildsysteem voor Ruby-software. Het zal automatisch bouwen en
installeer bestanden in Ruby-pakketten en probeer zo dicht mogelijk bij Rubygems te werken
maar met respect voor de Debian-standaarden voor Ruby-pakketten.

dh_ruby kan uw tests automatisch uitvoeren tegen alle ondersteunde Ruby-versies, zie de
sectie "BESTANDEN" hieronder.

Zie dh_ruby --help voor details.

BRON PAKKET LAYOUT

dh_ruby ondersteunt twee verschillende bronpakketstijlen: enkel-binaire bronpakketten, en
multi-binaire bronpakketten.

Enkel binair lay-out
De standaardindeling is de enkel binair indeling. Dit is de lay-out die door de meeste Ruby wordt gebruikt
pakketten upstream, dat wil zeggen Ruby-code in lib/, uitvoerbare programma's in bak/, enz. Pakketten
geïmporteerd uit Rubygems met behulp van gem2deb(1) zal deze indeling hebben.

Wanneer u deze lay-out gebruikt, dh_ruby zal bestanden (Ruby-code, uitvoerbare bestanden, gemspecs) installeren
de eerste binair pakket opgenomen in debian / control.

Multi-binair lay-out
gem2deb versie 0.4.0 introduceerde ondersteuning voor de multi-binair indeling. Deze indeling zou moeten
kan worden gebruikt als u een reeks verschillende Ruby-pakketten upstream in één pakket hebt
VCS, en u besluit dat u ook één enkel bronpakket in Debian wilt onderhouden
met de verschillende componenten als afzonderlijke binaire pakketten.

In deze lay-out bevat het bronpakket de afzonderlijke componenten in submappen
waarbij elk van hen de standaard Ruby-indeling zal gebruiken (lib/, bak/, enz).

Deze lay-out biedt geen ondersteuning voor het maken van afzonderlijke binaire pakketten vanuit dezelfde root
map. Raadpleeg voor dergelijke gevallen de documentatie op DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
hieronder.

Om aan te geven dat u een multi-binaire lay-out wilt gebruiken, moeten we 1) uw meerdere vermelden
binaire pakketten in debian / control zoals gewoonlijk, en voeg een extra veld toe met de naam X-DhRuby-Root naar
elke strofe van een binair pakket, waarbij wordt aangegeven welke map daarvoor als root moet worden gebruikt
binair pakket.

Een voorbeeld:

Bron: mijnmultibinarypakket
[...]

Pakket: robijn-foo
X-DhRuby-Root: pad/naar/foo
[...]

Pakket: robijn-bar
X-DhRuby-Root: pad/naar/balk

Het corresponderende broncodepakket zou als volgt moeten worden ingedeeld:

foe/
foo.gemspec
lib /
foo.rb
bak/foo
bar/
bar.gemspec
lib /
bar.rb
bak /
bars

Belangrijke opmerkingen over multi-binaire pakketten en het gebruik van X-DhRuby-Root:

· Als uw pakket de multi-binaire lay-out gebruikt, moet het `gem2deb (>= 0.4.0~)` inch
Bouw-afhankelijk.

Versie 0.4.0 HAD a kever in de ondersteuning For inheemse extensies in multi-binaire pakketten,
dus als uw pakket de multi-binaire functie gebruikt en ten minste één van de sub-
componenten native extensies heeft, moet u `gem2deb (>= 0.4.1~)` inch Bouw-afhankelijk
gebruiken.

· Het pad aangegeven in X-DhRuby-Root, zoals je waarschijnlijk al geraden hebt, moet dat zo zijn
relatief ten opzichte van de root van het broncodepakket.

· Als een binair pakket een X-DhRuby-Root veld, alle andere binaire pakketten die
heb er geen, zal worden genegeerd door dh_ruby.

OPTIES

--schoon, --configureren, --bouwen, --toets, --installeren
Commando's die door debhelper worden aangeroepen tijdens verschillende stappen van het bouwproces.

--print-ondersteund
Drukt de ondersteunde Ruby-versies af.

-h, --help
displays dh_ruby gebruiksinformatie.

-v, --versie
displays dh_ruby versie informatie.

--gem-installeren
Deze optie geeft aan dat de build de juweel opdracht om de bestanden te installeren,
in plaats van het installatieprogramma van eigen bodem. Er worden native pakketten geïnstalleerd
/ usr / lib /$ARCH/rubygems-integratie/$RUBY_VERSION, terwijl pure Ruby-pakketten dat wel zullen zijn
geïnstalleerd op /usr/share/rubygems-integration/all.

--setuprb
Deze optie geeft aan dat de build moet gebruiken setup.rb in plaats van de gebruikelijke edelstenen
gebaseerde opbouw. Om van kracht te worden, moet deze optie op de eerste plaats komen!

MILIEU VARIABELEN

DH_RUBY
Gebruik deze variabele om opdrachtregelparameters door te geven aan dh_ruby. Bijvoorbeeld binnen
debian/regels:

export DH_RUBY = --gem-install

DH_RUBY_IGNORE_TESTS
Dit is een door spaties gescheiden lijst met tests die dh_ruby zal negeren tijdens het bouwen van het pakket.
De beschikbare testnamen zijn de namen van alle ondersteunde Ruby-versies (u kunt een lijst maken van
ze met `dh_ruby --print-supported`).

Indien ingesteld op "all", worden alle tests genegeerd tijdens het bouwen van het pakket.

DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR
Als deze variabele is gedefinieerd (voor wat dan ook), zal dh_ruby de geïnformeerde map respecteren
by dh_auto_install(1), meestal debian/tmp. Standaard zal gem2deb bestanden installeren in
debian/pakket, Waar pakket is het eerste binaire pakket vermeld in debian/control.

Dit is handig voor multi-binaire broncodepakketten die niet voldoen aan de ondersteunde
layout (dat wil zeggen afzonderlijke submappen met elk lib/, bak/ enz). Hiermee worden alle bestanden
zal worden geïnstalleerd debian/tmp, en u kunt ze in afzonderlijke binaire bestanden distribueren
pakketten met behulp van debian/$pakket.install bestanden of expliciete shell-aanroepen
debian/regels.

Menging DH_RUBY_USE_DH_AUTO_INSTALL_DESTDIR en multi-binaire lay-out wordt niet ondersteund.

DH_RUBY_GEMSPEC
Bepaalt welk bestand de edelsteenspecificatie met pakketmetagegevens bevat. Door
standaard leest dh_ruby metadata uit een .gemspec-bestand in de root van het bronpakket
map. U kunt deze variabele gebruiken om deze te overschrijven als u maatwerk wilt leveren
metadata voor het Debian-pakket.

In het geval dat er meer dan één .gemspec in de root van het bronpakket zit, zal dat wel het geval zijn genoodzaakt bent
om DH_RUBY_GEMSPEC te gebruiken om dh_ruby te instrueren welke te gebruiken.

Gebruik dh_ruby online met behulp van onworks.net-services