gitpkg - Online in de cloud

PROGRAMMA:

NAAM

gitpkg - exporteer een Debian-broncodepakket van genomineerde git-revisies

KORTE INHOUD

gitpkg tak [oorsprongstak]

PRODUCTBESCHRIJVING

If gitpkg wordt gereden in een git(1) repo met een enkele 'branch' gespecificeerd, dan zal het een git-
archief export van die tak naar de DEB_DIR map. Als het pakket Debian native is
het zal er gewoon een broncodepakket van maken. Als het pakket een Debian-versie heeft, dan
er wordt verwacht dat er al een orig tarball voor bestaat. Als een originele tarball dat niet doet
bestaan, hangt wat er daarna gebeurt af van de waarde van de gitpkg.create-fake-orig
configuratieoptie (hieronder beschreven).

If gitpkg wordt aangeroepen met twee gespecificeerde branches, dan zal de eerste branch worden geëxporteerd
als de uitgepakte volledige broncode, terwijl de tweede tak wordt geëxporteerd voor de
orig.tar.gz. Hierdoor kunnen alle lokale wijzigingen aan de bron worden opgenomen in het resultaat
diff.gz als er een ongerepte stroomopwaartse vertakking bestaat in de repository. Als een originele tarball
bestaat al voor de versie bij 'branch', wat daarna gebeurt hangt af van de waarde van
de gitpkg.force-overwrite-orig configuratieoptie (hieronder beschreven).

De 'tak' moet altijd een debian/ dir en kan elk zijn boomachtig voorwerp dat is
geaccepteerd door git-archief(1). De 'oorsprongstak', indien geleverd, zou meestal geen a moeten hebben
debian/ richt.

CONFIGURATIE OPTIES

Bijna alle gitpkg configuratie wordt afgehandeld met behulp van git-config(1) nu. Het volgende
configuratie-opties worden ondersteund:

gitpkg.deb-dir
Kan worden ingesteld om de standaard bestemmingsmap voor geëxporteerde pakketten te overschrijven.
Standaard is '../deb-pakketten'. Beschikbaar om scripts te hooken als DEB_DIR. Dit kan zijn
overschreven op de opdrachtregel met de --deb-dir=pad optie.

gitpkg.build-rootcmd
Kan worden ingesteld om de standaardopdracht te overschrijven die wordt gebruikt om root te krijgen voor het bouwen van pakketten
activiteiten. Standaard is 'nepwortel'. Beschikbaar om scripts te hooken als BUILD_ROOTCMD.

gitpkg.prebuild-target
Kan worden ingesteld op een doel of doelen vanaf debian/regels die zal worden genoemd na de
debian broncodeboom wordt geëxporteerd, maar voordat het broncodepakket wordt gebouwd. Sommige
pakketten kunnen dit gebruiken om autoconf-bestanden of iets dergelijks te genereren, wat zou moeten
over het algemeen niet in de repo, maar die in het gedistribueerde pakket zouden moeten zitten. De
target wordt aangeroepen met behulp van de BUILD_ROOTCMD. Een algemeen gebruik voor deze haak zou zijn
noem het pakket 'schoon' doel. Deze hook is standaard uitgeschakeld sinds gitpkg
0.18. Daarvoor ging het standaard naar het schone doel. Beschikbaar om te haken
scripts als PREBUILD_TARGET.

gitpkg.orig-compressor
Kan worden ingesteld om de standaardcompressie voor een geëxporteerd pakket.orig.tar te overschrijven.
Standaard is 'gzip'. Voor formaat 3.0-pakketten omvatten geldige waarden ook xz en
bzip2. Beschikbaar om scripts te hooken als ORIG_COMPRESSOR.

gitpkg.orig-compress-niveau
Een optioneel compressieniveau om mee te gebruiken gitpkg.orig-compressor. 1 is meestal de
snelste en 9 is meestal de kleinste, met de precieze details van alles
tussen aan de gekozen compressor. Standaard is uitgeschakeld (wat zal gebruiken
wat de standaardwaarde van de compressor ook is). Beschikbaar om scripts te hooken als
ORIG_COMPRESS_LEVEL.

gitpkg.deb-compressor
Kan worden ingesteld om de standaardcompressie die wordt gebruikt door te negeren dpkg-bron(1) voor geëxporteerd
pakketjes. Standaard (indien niet ingesteld) is om wat dan ook te gebruiken dpkg-bron wil gebruiken. Voor
formaat 3.0-pakketten, omvatten geldige waarden ook xz en bzip2. Beschikbaar om te haken
scripts als DEB_COMPRESSOR.

gitpkg.deb-compressieniveau
Een optioneel compressieniveau om mee te gebruiken gitpkg.deb-compressor. 1 is meestal de
snelste en 9 is meestal de kleinste, met de precieze details van alles
tussen aan de gekozen compressor. Standaard is uitgeschakeld (wat zal gebruiken
ongeacht de dpkg-bron standaard is momenteel '9'). Beschikbaar om scripts te hooken als
DEB_COMPRESS_LEVEL.

gitpkg.dpkg-bron
Kan worden ingesteld om willekeurige opties woordelijk door te geven dpkg-bron(1) bij het bouwen van de
bronpakket. Wees voorzichtig en op eigen risico. Om meerdere opties door te geven
naar dpkg-bron u moet deze optie meerdere keren instellen (d.w.z. met behulp van git config --toevoegen
voor elke optie) vanwege de overigens amusante citaatvereisten voor opties zoals
als "--format=3.0 (native)". Standaard is leeg. Beschikbaar om scripts te hooken als de
geïndexeerde array DPKG_SOURCE_OPTS. Gebruik dit niet om het in te stellen dpkg-bron(1) -Z or -z
opties, moeten ze in plaats daarvan worden ingesteld met behulp van de deb-compressor en deb-compress-niveau
respectievelijk opties. Dit kan op de opdrachtregel worden overschreven met de
--dpkg-bron=arg optie, die eveneens meerdere keren moet worden doorgegeven om in te stellen
meerdere opties.

gitpkg.create-fake-orig
Soms zijn zowel upstream source- als debian-ondersteuning echt vermengd tot een
enkele tak van de repo, maar waarvan u nog steeds een 'niet-native' pakket wilt maken
het. gitpkg kan een originele tarball van zo'n boom vervalsen uit alles behalve de
inhoud van de map debian/. Als je deze optie op 'true' zet, is dat wel het geval
gedrag de standaard als een enkele treeish wordt doorgegeven aan gitpkg en geen overeenkomstige
orig tarball is gevonden. Als u deze optie op 'false' zet, wordt make gitpkg mislukking,
een fout rapporteren, als een enkele treeish wordt doorgegeven en geen orig tarball met de
de juiste versie bestaat er al voor (en er is er geen opgehaald door een hook-script
voordat het nodig is). Als deze optie niet is ingesteld, wordt de gebruiker hierom gevraagd
voor wat u moet doen als deze situatie zich voordoet. Standaard is uitgeschakeld. Beschikbaar
om scripts aan te haken als CREATE_FAKE_ORIG.

gitpkg.force-overwrite-orig
Deze optie regelt het gedrag van gitpkg als een 'origbranch' boomachtig is
opgegeven en de corresponderende orig.tar voor de 'branch' bestaat al. Als dit
is ingesteld op 'true', dan wordt de orig.tar overschreven met de repo-bron (naar
hergebruik een bestaande orig.tar gewoon aanroepen gitpkg met alleen de enkele debian 'branch'
treeish die u wilt exporteren). Als dit op 'false' staat, dan is het een harde fout
probeer de stroomopwaartse bron opnieuw te exporteren wanneer de orig.tar al bestaat, en
gitpkg zal beëindigen en je uitschelden als je het probeert. Als dit niet is ingesteld, wordt u hierom gevraagd
over het al dan niet overschrijven, en de build zal doorgaan met wat dan ook
van de twee die je hebt geselecteerd. Standaard is uitgeschakeld. Beschikbaar om scripts te hooken als
FORCE_OVERWRITE_ORIG.

gitpkg.keep-uitgepakte-bron
Deze optie bepaalt of de uitgepakte bronmap al dan niet wordt bewaard na het
pakket export en exit hook zijn met succes voltooid. Als dit is ingesteld op
'true', de uitgepakte bron blijft behouden. Indien ingesteld op 'false' of niet ingesteld, dan is dat zo
directory wordt verwijderd als de laatste handeling ervoor gitpkg verlaat als alles eerder is
bewerkingen succesvol afgerond. Standaard is uitgeschakeld. Beschikbaar om scripts te hooken als
BEWAREN_UNPACKED_SOURCE. Dit kan op de opdrachtregel worden overschreven met de
--keep-uitgepakt-source=bool optie (waarbij 'nee' of 'false' het niet zal behouden, en eventuele
andere waarde, inclusief niets, wel).

SCRIPT HOOKS

Door de gebruiker gedefinieerde scripts kunnen vanaf een aantal punten worden aangeroepen tijdens het samenstellen van het pakket
proces. Ze zijn afkomstig uit gitpkg als bash shell-fragmenten, in de meeste gevallen in a
subshell, zodat ze statusvariabelen kunnen lezen en externe acties kunnen uitvoeren, maar niet kunnen wijzigen
de lopende configuratie zodra een build aan de gang is. Als een haak terugkeert met een niet-nul
staat dan gitpkg zal worden beëindigd. (Hooks die gitpkg beëindigen, zouden wat tijd nodig hebben
zorg ervoor dat u niet te veel rommel achterlaat, maar laat ook genoeg aanwijzingen intact voor de
gebruiker om een ​​diagnose te stellen en op te lossen wat het probleem ook was. Nuttige en informatieve foutmeldingen
moet naar stderr geblaft worden voordat je op deze manier weggaat.)

Hook-scripts kunnen op het hostsysteem worden geïnstalleerd buiten de repo-boom, of afkomstig zijn van
versiebeheerde bestanden in de repo zelf. Beide methoden hebben voordelen en risico's voor
verschillende use-cases. Hook-scripts worden geactiveerd door de lokale beheerder door elk in te stellen
relevante git-config(1) optie met het pad naar het uit te voeren script. Paden kunnen zijn
absoluut of relatief ten opzichte van de directory van waaruit die hook wordt aangeroepen. Als er een haak is geplaatst,
het script Dan moet je bestaan ​​wanneer het wordt aangeroepen. Zorg ervoor dat u ze alleen inschakelt voor gebruik
door vertrouwde bronbomen bij het inhaken op bestanden in de repo zelf. Meestal zou je dat moeten doen
schakel ze per repo in met git-config(1) in plaats van bij a --globaal or --systeem
niveau.

A kort vermaning tegen het krijgen van verslaafd:
U moet voorkomen dat gecompliceerde in-package hook-arrangementen essentieel worden voor export
uw pakketbron. Als je ze nodig hebt om een ​​bepaald pakket correct te maken, en nodig hebt
strikte versiebinding met de bron die wordt vrijgegeven, en ze zijn niet nuttig voor anderen
helemaal niet ... dan ben je waarschijnlijk iets, of meerdere dingen, behoorlijk aan het doen
fout. Anders zit je zo diep in de shit met het werken aan een kapot bouwsysteem dat je
ik hoef je er niet over te vertellen. Hoe dan ook, de lokale admin moet je hooks inschakelen
voordat ze kunnen rennen, dus als je vriendelijk wilt zijn tegen anderen (en tegen jezelf), houd dan de
'normale' pakketten werken strikt binnen de gebruikelijke hulpprogramma's voor het bouwen van pakketten en laten de
gitpkg hooks gratis voor andere lokale admins om welke automatisering dan ook in te pakken ze genoodzaakt bent
rond dingen. Als een bepaalde versie van de pakketbron een bepaald
acties die erop zijn uitgevoerd voorafgaand aan de eerste build van het broncodepakket, daarna de PREBUILD_TARGET
optie van bovenaf is hoogstwaarschijnlijk wat je wilt in plaats van een van deze haken. Ander
mensen kunnen dat later weer gebruiken zonder dat ze gitpkg nodig hebben. Het doel is voor
dit om u te helpen. Voor sommige waarden van All Of You. Wees dus voorzichtig om te voorkomen dat u het laat
bedrieg andere mensen als de haak niet wordt geroepen, en / of laat ze weten wat ze moeten doen
doe in plaats daarvan als dat niet het geval is. Ok dan, daar is de weerhaak om op te letten, dus terug naar het punt
nog een keer:

haak punten
De beschikbare haakpunten worden hieronder weergegeven in ongeveer de volgorde waarin ze normaal gesproken zijn
ingeroepen:

gitpkg.package-config-hook
Deze hook draait in de hoogste directory van de repo gitpkg werd ingeroepen in, voorafgaand
op alle operaties die plaatsvinden, met alle git-config(1) beschikbare opties voor
Het. Er is geen gedetailleerde informatie over het pakket zelf beschikbaar in de hook
omgeving nog niet eens de naam of versie, alleen de boom-achtig(en) die gitpkg
is gepasseerd door de gebruiker, maar de hook kan zijn eigen zelfcontroles uitvoeren op basis van de
huidige (mogelijk 'vuile') inhoud van de werkboom that gitpkg werd ingeroepen.

Deze hook kan de gitpkg configuratievariabelen voor volgende
activiteiten. Het kan indien nodig bewerkingen op de repo uitvoeren, maar omdat het moet
toegewijd zijn aan de repo voordat deze ooit wordt aangeroepen, dat is misschien niet zo handig
hier in de praktijk. In principe kan het alles doen wat het wil, het is maar een omhulsel
script, er is nog niets echt begonnen, en het is in de top opgenomen
shell-niveau van gitpkg.

De werking is anders dan de admin-config-hook in slechts één opzicht, het pad
aan deze haak Dan moet je relatief zijn ten opzichte van de TLD van de repo en de revisie van het bestand
dat zal worden ingekocht, wordt uitgecheckt uit de 'tak' boomachtige dat gitpkg was
gevraagd om te exporteren. Het bestand moet in die versie bestaan ​​op het opgegeven pad.

Beschikbaar om scripts te hooken als PACKAGE_CONFIG_HAAK.

gitpkg.admin-config-hook
Deze hook wordt uitgevoerd na de pakket-config-hook keert terug, en verschilt ervan in
operatie alleen door een statisch bestand van het huidige bestandssysteem te lezen in plaats van
het extraheren van een versiebeheerde versie uit de repo die wordt geëxporteerd.

Dit kan door de lokale beheerder worden gebruikt om eventuele pakketspecifieke opties te overschrijven
kan zijn ingesteld door de pakket-config-hook, met locatiespecifieke configuratie.
Dit is een beleidscontrole, geen beveiligingscontrole. De beveiliging was helemaal voorbij toen je het liet
de pakket-config-hook run, hiermee kun je het gewoon overschrijven zonder te doen alsof
een nieuwe commit maken waarbij de pakkethaak wordt gewijzigd.

Dit is de laatste hook die wordt uitgevoerd die in staat is om het gitpkg configuratie en
stel omgevingsopties in die zichtbaar zullen zijn voor latere hooks. Beschikbaar om te haken
scripts als ADMIN_CONFIG_HOOK. Dit kan op de opdrachtregel worden overschreven met de
--admin-config-hook=pad optie.

gitpkg.pre-export-hook
Deze hook draait in de hoofdmap van de repo, achter de pakketnaam en
versie zijn bepaald, en met de uiteindelijke pakketconfiguratie inclusief
elke tweaking door de vorige hooks. Het kan geen configuratie-opties wijzigen,
handel er alleen naar of beëindig ze gitpkg.

Dit kan worden gebruikt om dingen te doen zoals pristine-tar aanroepen of een bestaande orig prefetchen
tarball van een buitenlandse bron. Het kan eventuele bewerkingen op de repo uitvoeren
dergelijke zijn gewenst, of enige andere last-minute controle die moet worden gedaan voordat we
daadwerkelijk aan de slag gaan met het exporteren van de bron die we willen inpakken.

Beschikbaar om scripts te hooken als PRE_EXPORT_HAAK.

gitpkg.deb-export-hook
Deze hook draait in de directory op het hoogste niveau van de geëxporteerde debian-broncode,
onmiddellijk nadat de bron is geëxporteerd uit de gevraagde boomachtig en
onmiddellijk voorafgaand aan de PREBUILD_TARGET wordt aangeroepen (indien aanwezig). Het kan niet
configuratie-opties wijzigen, er alleen naar handelen of beëindigen gitpkg. Als dit
haak eindigt gitpkg, blijft de geëxporteerde bronmap op het systeem staan
voor de gebruiker om te inspecteren. Latere aanroepen van gitpkg voor dezelfde uitgave
versie zal het wel overschrijven. Beschikbaar om scripts te hooken als DEB_EXPORT_HAAK.

gitpkg.orig-export-hook
Deze hook draait in de hoofddirectory van de geëxporteerde 'upstream'-bron,
onmiddellijk nadat de bron is geëxporteerd uit het geleverde boomachtig en
voordat het wordt gecomprimeerd tot een tarball. Het kan geen enkele configuratie wijzigen
opties, handel er alleen naar of beëindig ze gitpkg. Als deze haak eindigt gitpkg,
de geëxporteerde bronmap blijft op het systeem staan ​​zodat de gebruiker deze kan inspecteren.
Latere aanroepen van gitpkg voor dezelfde release zal de versie deze overschrijven
dat wel.

Deze haak is Slechts aangeroepen als de stroomopwaartse 'origbranch' daadwerkelijk wordt geëxporteerd
de bewaarplaats. Als een bestaande orig.tar wordt gevonden of door sommigen is gemaakt
eerdere hook (en deze wordt niet overschreven, zie geforceerd-overschrijven-origineel bovenstaand),
dan wordt aangenomen dat de bewerkingen die deze haak zou uitvoeren al hebben plaatsgevonden
voor deze tarball en het wordt overgeslagen.

Het is niet veilig om aan te nemen dat deze hook ervoor of erna zal worden uitgevoerd deb-
export haak, en het kan zelfs op een bepaald punt in het
toekomst. Ze worden daarna allebei ingevoerd pre-export haak retourneert, en exit-haak
begint pas (minstens) nadat beide zijn teruggekeerd. Wat gebeurt er nog meer in de
bovendien doen we in dit stadium geen harde beloften.

Beschikbaar om scripts te hooken als ORIG_EXPORT_HAAK.

gitpkg.exit-hook
Deze hook draait in de directory waar het pakket .dsc werd gedeponeerd door dpkg-
(bron)(1), immers intern gitpkg operaties zijn succesvol afgerond. Zijn
te laat om configuratie-opties te wijzigen of zelfs te beëindigen gitpkg werkelijk.
Je kunt vrijwel doen wat je wilt met deze, alles wat fout gaat
hier op is uw eigen doen. Beschikbaar om scripts te hooken als EXIT_HAAK. Dit kan zijn
overschreven op de opdrachtregel met de --exit-hook=pad optie.

haak Milieu
De volgende variabelen worden beschikbaar gemaakt voor hook-scripts, naast de reeds bestaande
vermeld als schaduwen a git-config optie van bovenaf. Ze zijn niet allemaal geldig/nuttig bij
alle haakpunten, zie de haakdocumentatie hierboven voor de uitzonderingen die van toepassing zijn op specifieke
haken.

GITPKG_HOOK_API
Staat hook-scripts toe om te vragen welke interfaces voor hen beschikbaar zijn. Heeft er maar twee
numerieke componenten gescheiden door een '.' waarvan het nummer rechts van de punt
zal worden opgehoogd elke keer dat we een nieuwe variabele toevoegen waartoe een hook toegang zou kunnen hebben, of
voeg een nieuwe knop toe, het kan worden aangepast waar bestaande interfaces niet zijn gewijzigd.
Als we het verpesten en een huidige interface moeten wijzigen, het nummer aan de linkerkant
zal gestoten worden. De huidige API-versie is 0.2

Beschikbaar in API versie 0.1
Deze variabelen zijn beschikbaar voor hooks sinds gitpkg versie 0.13

GITPKG_TREEISH
De door de gebruiker doorgegeven debian 'branch' tree-achtige die gitpkg moest exporteren.

GITPKG_ORIG_TREEISH
De 'origbranch' tree-achtig waarmee gitpkg werd aangeroepen. Dit zal leeg zijn als alleen
er werd een enkele 'tak'-boomachtig gespecificeerd.

DEB_SOURCE
De naam van het broncodepakket dat moet worden gemaakt, zonder versiebeheer. Zoals te zien in de
Bron: veld van dpkg-parsechangelog(1).

DEB_VERSIE
De versie van het broncodepakket dat moet worden gemaakt, zonder enig tijdperk. Zoals te zien in de
naam van de .diff.gz- en .dsc-bestanden.

UPSTREAM_VERSION
De versie van het broncodepakket dat moet worden gemaakt, zonder enige debian-versie. Als gezien
in de naam van de originele tarball. Voor native pakketten is dit hetzelfde als
DEB_VERSIE.

DEB_ORIG
De volledige versie van de bestandsnaam van de oorspronkelijke tarball die moet worden gebruikt of gemaakt. Deze variabele is
leeg voor native pakketten zonder een Debian versie-onderdeel.

DEB_DSC
De volledige bestandsnaam van het pakket .dsc die zal worden of is gemaakt.

DEB_PAKKET
De mapnaam van de gedebianiseerde broncodeboom waarnaar moet worden doorgestuurd dpkg-bron(1).

REPO_DIR
Een absoluut pad naar de map op het hoogste niveau van de git-repo waaruit we exporteren.
Meestal, als je uit de boom moet kijken waarin je bent gedropt, ben je dat
waarschijnlijk iets (op het) verkeerde (tijdstip) doen, maar er zijn uitzonderingen, en zijn
kunnen opvragen git-config opties is er een van. Dat is deze meestal
voor nu. Zie de repo-config-helper hieronder gedocumenteerd. Wees voorzichtig als je dat doet
gebruik het voor veel andere dingen.

Beschikbaar in API versie 0.2
Deze variabelen zijn beschikbaar voor hooks sinds gitpkg versie 0.24

GITPKG_AOPTS
Een associatieve array met de opdrachtregelopties die niet zijn geparseerd door gitpkg
zelf die kan worden gebruikt om het gedrag van een haak te onderdrukken. De array is versleuteld
op de namen van de opties met de '--' verwijderd. Als er een optie is doorgegeven
meerdere keren wordt alleen de laatst doorgegeven waarde in deze array opgeslagen. Voor
voorbeeld:

$ gitpkg --my-option=foo --option2 --opt=oeps --opt='bar baz'

Zal geven:

${GITPKG_AOPTS[mijn-optie]} = "foo"
${GITPKG_AOPTS[optie2]} = ""
${GITPKG_AOPTS[opt]} = "bar baz"

GITPKG_IOPTS
Een geïndexeerde array met de opdrachtregelopties die niet zijn geparseerd door gitpkg zelf
die kan worden gebruikt om het gedrag van een haak te onderdrukken. De array bevat de
letterlijke optietekenreeksen doorgegeven en kunnen dus worden gebruikt om toegang te krijgen tot opties die dat wel zijn
bedoeld om meerdere keren te passeren. Bijvoorbeeld:

$ gitpkg --my-option=foo --option2 --opt=oeps --opt='bar baz'

Zal geven:

${GITPKG_IOPTS[0]} = "--mijn-optie=foo"
${GITPKG_IOPTS[1]} = "--optie2"
${GITPKG_IOPTS[2]} = "--opt=oeps"
${GITPKG_IOPTS[3]} = "--opt=bar baz"

De extract_values_for_option functie in repo-config-helper (zie hieronder voor details
ervan) kan worden gebruikt om deze array verder te ontleden om alle waarde(n) voor a te verkrijgen
specifieke optie.

haak Bibliotheek
Er zijn enkele ingeblikte hook-scripts voor verschillende taken beschikbaar in /usr/share/gitpkg/hooks
die momenteel omvatten:

cowpoke-exit-haak
Een eenvoudige exit-hook die het geëxporteerde pakket verzendt om te bouwen koepoke(1).
Om het in te schakelen:

$ git config gitpkg.exit-hook /usr/share/gitpkg/hooks/cowpoke-exit-hook

Extra git-config(1) configuratie-opties:

gitpkg-cowpoke-exit-hook.ask-eerst
Indien 'true' vragen om bevestiging alvorens te bellen koepoke. Standaard is gewoon
ga je gang en doe het.

gitpkg-cowpoke-exit-hook.options
Kan andere opties bevatten om woordelijk aan door te geven koepoke. Om meerdere te passeren
opties, stelt u dit meerdere keren in, één keer voor elke optie. Dit kan zijn
overschreven op de opdrachtregel met de --koepoke=arg optie, die eveneens
moet meerdere keren worden doorgegeven om meerdere opties in te stellen.

dpkg-buildpackage-exit-hook
Een eenvoudige exit hook om lokaal binaire pakketten mee te bouwen dpkg-buildpakket(1). Tot
het mogelijk maken:

$ git config gitpkg.exit-hook /usr/share/gitpkg/hooks/dpkg-buildpackage-exit-hook

Extra git-config(1) configuratie-opties:

gitpkg-dpkg-buildpackage-exit-hook.ask-first
Indien 'true' vragen om bevestiging alvorens te bellen dpkg-buildpakket. Standaard
is om het gewoon te doen.

gitpkg-dpkg-buildpackage-exit-hook.options
Kan andere opties bevatten om woordelijk aan door te geven dpkg-buildpakket. Slagen
meerdere opties, stel dit meerdere keren in, één keer voor elke optie. Dit kan zijn
overschreven op de opdrachtregel met de --dpkg-bp=arg optie, die eveneens
moet meerdere keren worden doorgegeven om meerdere opties in te stellen.

gitpkg-dpkg-buildpackage-exit-hook.build-log
Indien ingesteld op 'false' sla dan geen logboek op van het bouwproces, de standaard is opnemen
een.

ongerepte-teer-pre-export-haak
Een haak om een ​​originele tarball te extraheren met ongerepte teer. Welke orig te extraheren is
bepaald door de pakketversie van de 'branch' tree-achtig. Om het in te schakelen:

$ git config gitpkg.pre-export-hook /usr/share/gitpkg/hooks/pristine-tar-pre-export-hook

Als er geen pristine-tar-tak in de repo wordt gevonden, wordt gitpkg beëindigd.

quilt-patches-deb-export-haak
Deze hook leest een lijst met revisiebereiken die geschikt zijn voor git-formaat-patch(1) van de
filet debian/source/git-patches, één per regel, en exporteert ze naar het debian/patches
directory in een vorm die geschikt is voor (formaat 3.0) quiltpakketten. Het is niet vereist voor
het maken van dergelijke pakketten, maar stelt u in staat individuele patches naar eigen inzicht te scheiden
alstublieft van de standaard enkele patch die anders is gemaakt door dpkg-bron.

Om het in te schakelen:

$ git config gitpkg.deb-export-hook /usr/share/gitpkg/hooks/quilt-patches-deb-export-hook

De inhoud van debian/source/git-patches kan opmerkingen bevatten (op elke regel die begint
met een #), lege regels en expressies van een reeks commits. De revisiebereiken
mag inclusief $DEB_VERSION, $UPSTREAM_VERSION, $DEB_REF or $UPSTREAM_REF. De eerste
paar wordt vervangen door de versie van het pakket dat wordt geëxporteerd, het tweede
paar met die versiestrings na het verminken sanitise_git_ref om ze opnieuw toe te wijzen aan een
juridische git hernaam. Het gebruik van de gedesinfecteerde versies verdient in de meeste gevallen de voorkeur.
Bijvoorbeeld:

# Exporteer alle commits tussen deze twee treeishes,
# gebaseerd op de versie van het pakket dat wordt geëxporteerd.

stroomopwaarts/$UPSTREAM_REF..patches/$DEB_REF

debcherry-deb-export-haak
Deze haak roept aan git-debcherry(1) om patches te vinden en te exporteren naar de stroomopwaartse bron
in een vorm die geschikt is voor gebruik met (formaat 3.0) quiltpakketten. Het zorgt voor een meer
natuurlijke (en automatische) workflow dan de quilt-patches haak hierboven door te zoeken naar
patches gemaakt aan de verpakkingstak die stroomopwaarts nog niet zijn aangebracht.

Om het in te schakelen:

$ git config gitpkg.deb-export-hook /usr/share/gitpkg/hooks/debcherry-deb-export-hook

Om deze haak te gebruiken, moet een ${DEB_ORIG}.vastlegging bestand moet worden gemaakt dat bevat
de treeish van de geëxporteerde stroomopwaartse bron in de repository. Deze wordt aangemaakt
automatisch (als deze hook is ingeschakeld) wanneer je een stroomopwaartse tarball exporteert door te passen
zowel tak en oorsprongstak naar gitpkg, of als u de ongerepte-teer-pre-export-haak,
die een geschikte commit bepaalt die overeenkomt met de tarball. Als je stroomopwaarts bent
tarball is gemaakt met een ander mechanisme dat je nodig hebt om ervoor te zorgen dat het bestand is
zelf gecreëerd.

Als je deze hook gebruikt, wil je dat misschien ergens in je repository documenteren
vergelijkbaar met de tekst erin /usr/share/doc/gitpkg/examples/README.debcherry-export een
gemak voor andere gebruikers. Uw pakket kan nog steeds worden geëxporteerd zonder deze haak
ingeschakeld, worden de stroomopwaartse patches niet afzonderlijk gescheiden in een
quilt serie.

haak Bibliotheek helpers
Dit zijn nog meer triviale fragmenten, voor bewerkingen die door meerdere kunnen worden gedeeld
scripts. Ook gevonden in /usr/share/gitpkg/hooks. Meestal zouden deze afkomstig zijn van anderen
scripts in plaats van er direct aan verslaafd te zijn.

repo-config-helper
Biedt een eenvoudige omhulling rond `git config`, wat ervoor zorgt dat het wordt aangeroepen vanuit de
repo-structuur waar alle repo-specifieke configuratie-opties kunnen worden opgeslagen. Handig voor scripts
die niet worden aangeroepen vanuit de repo-boom, maar die wel git-config opties van
hun eigen te vragen.

Biedt de sanitise_git_ref shell-functie die tekenreeksen opnieuw toewijst die zijn
illegaal om te gebruiken in een git refname.

Biedt de extract_values_for_option shell-functie die kan worden gebruikt om een
matrix van de waarden voor een bepaalde optie uit GITPKG_IOPTS.

Zie de inhoud van dat bestand zelf voor meer gedetailleerde documentatie over de functies
dat het biedt.

INTERACTIVITEIT

Als u van plan bent te bellen gitpkg uit uw eigen scripts, dan moet u er rekening mee houden dat die er zijn
twee situaties waarin het standaard interactief kan worden gevraagd. Er is geen One True Sane
Standaard voor deze gevallen, dus het is beter om het gewoon aan de gebruiker te vragen en door te gaan dan te maken
ze beginnen het hele proces opnieuw in het waarschijnlijke geval dat ze hebben gebeld gitpkg
direct. Voor meer informatie, zie de gitpkg.force-overwrite-orig en gitpkg.create-fake-orig
configuratie-opties hierboven. U dient beide expliciet in te stellen op het gedrag dat u wenst
van hen als gitpkg mag nooit interactief worden.

WERKSTROOM

Hoewel gitpkg probeert u uitdrukkelijk niet een bepaalde werkstroomprocedure op te dringen
om er volledig gebruik van te maken, is het waarschijnlijk de moeite waard om er snel minstens één te noemen
eenvoudige manier om Debian-pakketten in git te beheren.

Een veel voorkomende repo-structuur is om de ongerepte stroomopwaartse bron op één tak te houden, namelijk
rechtstreeks bijgewerkt vanuit een upstream repo of door er tar-archieven in te importeren
periodiek, met de door Debian gepatchte broncode op een andere branch. In deze situatie de
taak van het voorbereiden van een nieuwe stroomopwaartse release van een tarball zou er ongeveer zo uit kunnen zien:

Bekijk de stroomopwaartse tak
$ cd myrepo
$ git stroomopwaarts afrekenen

Verwijder alle oude upstream-bestanden uit de repo
$ rm -rf $(alle_bestanden_behalve .git)

Pak de nieuwe tarball op hun plaats uit
$ tar zxf $new_upstream.tar.gz

Laat git zelf uitzoeken wat hernoemd/nieuw/verdwenen is.
Zorg ervoor dat er geen zaken als vim .swp-bestanden op de loer liggen
in de boom nog steeds op dit punt.
$ git toevoegen.
$ git vastleggen -a
$ git-tag v$upstream_version

Bereid de Debian-tak voor
$ git kassa debian
$ git stroomopwaarts samenvoegen
$ $(update changelog en andere debian-patches enz.)
$ git vastleggen -a
$ git tag v${upstream_version}-$debian_version

Maak een uitgave
$ gitpkg v${upstream_version}-$debian_version v$upstream_version
$ cd ../deb-packages/mypackage && dpkg-buildpackage ...

Gebruik gitpkg online met behulp van onworks.net-services