irkerhook - Bulutta Çevrimiçi

Program:

ADI

irkerhook - irker bildirimleri veren depo kancası komut dosyası

SİNOPSİS

irkerhook.py [-n] [-V] [[--değişken=değer...]] [[taahhüt kimliği...]]

TANIM

irkerhook.py, bir
sürüm kontrol deposu. Görevi, kovulan taahhüt hakkında bilgi toplamaktır.
kanca (ve muhtemelen depo sahibi tarafından belirlenen tercihler) ve bu bilgiyi gönderin
çeşitli duyuru kanallarına yönlendirmek için bir irkerd örneğine.

irkerhook.py'nin doğru çağrılması ve davranışı, hangi VCS'ye bağlı olarak değişir
(versiyon kontrol sistemi) onu çağırıyor. olabileceği dört farklı yer vardır.
bilgileri ayıkla:

1. VCS yardımcı programlarına yapılan çağrılar.

2. Kullanıcı tarafından ayarlanabilen yapılandırma değişkenlerini destekleyen git gibi VCS'lerde, değişkenler
"irker" ön eki.

3. Diğer VCS'lerde, havuzun iç kısmında bir yapılandırma dosyası olan "irker.conf"
dizin.

4. --değişken=değer biçimindeki komut satırı bağımsız değişkenleri.

Aşağıdaki değişkenler, desteklenen tüm VCS'ler için geneldir:

proje
Projenin adı. Nispeten kısa bir tanımlayıcı olmalıdır; genellikle görünür
bir bildirimin en başında.

repo
Depo üst düzey dizininin adı. Belirtilmezse, varsayılan olarak bir
proje adının küçük harfli kopyası.

kanallar
Bir IRC kanal URL'si veya aynı kanalların virgülle ayrılmış listesi.
bildirimler gönderilmelidir. Belirtilmezse, varsayılan serbest düğümdür #commits
kanalı.

sunucu
Bildirim ileten irker arka plan programının üzerinde bulunması beklenen ana bilgisayar.
Varsayılan olarak "localhost".

E-posta
Ayarlanırsa, iletişim için TCP veya UDP yerine e-posta kullanın. Değer olarak kullanılır
hedef posta adresi.

tcp
"Doğru" ise, iletişim için TCP'yi kullanın; "yanlış" ise, UDP kullanın. Varsayılan olarak "yanlış" olur.

url ön eki
Deponuz için URL önekini değiştirin. Taahhüt kimliği buna eklendiğinde,
taahhüdü cgit, gitweb veya benzeri bir şey aracılığıyla gösterecek bir CGI'yı işaret edin.
Tipik bir gitweb/cgit kurulumunuz varsa, varsayılanlar muhtemelen çalışacaktır.

Bu değişkenin değeri "Yok" ise, taahhütte URL alanının oluşturulması
bildirimler engellenecektir. Diğer sihirli değerler "cgit", "gitweb" ve
Genellikle bu sistemlerle çalışacak URL şablonlarına genişleyen "viewcvs".

Sihirli çerezler "%(host)s" ve %(repo)s" bu URL'de oluşabilir. İlki
irkerhook.py'nin çalıştığı ana bilgisayarın FQDN'sine genişletildi; ikincisi
"repo" değişkeninin değerine genişletildi.

minikleştirici
Daha az yer kaplamaları için URL'leri sıkıştırmak için bir hizmeti işaret eden URL şablonu
bildirim satırında boşluk. Bu değişkenin değeri "Yok" ise, hayır
sıkıştırma denenecektir.

renk
"mIRC" ise, mIRC renk kodlarıyla bildirim alanlarını vurgulayın. "ANSI" ise, vurgulayın
ANSI renk kaçış dizili bildirim alanları. Varsayılan olarak "hiçbiri" (renk yok).
ANSI kodları Chatzilla, irssi, ircle ve BitchX'te desteklenir; mIRC kodları yalnızca
mIRC, XChat, KVirc, Konversation veya weechat'ta tanınır.

Not: Bunu açarsanız ve kanalınızda bildirimlerin görünmesi durursa,
IRC'nin o kanaldaki renk filtresini kapatmak için. Bunu yapmak için op'a ihtiyacınız olacak
ayrıcalıklar; "/ mode" komutunu verin -c" ile senin tarafından değiştirildi
Kanal ismi. Önce "/msg chanserv set" komutunu vermeniz gerekebilir.
MLOCK +nt-slk".

maksimum kanallar
Tamsayı olarak yorumlanır. Sıfır değilse, kancanın alacağı kanal sayısını sınırlar.
"channels" değişkeninden yorumlayın.

Bu değişken, VCS yapılandırma değişkenleri veya irker.conf aracılığıyla ayarlanamaz; yapabilir
yalnızca bir komut satırı bağımsız değişkeni ile ayarlanabilir. Böylece, deponun bulunduğu bir forge sitesinde
sahiplerin taahhüt sonrası komut dosyalarını değiştirmelerine izin verilmez, bir site yöneticisi şunları yapabilir:
kötü niyetli proje sahipleri tarafından av tüfeği spam'ını önlemek için ayarlayın. Bir değere ayarlamak
Bununla birlikte, 2'den az, muhtemelen akıllıca olmaz.

CIA'ya benzeyen
Boş değilse ve "Yok" (varsayılan) değilse, bu, eski CIA davranışını taklit eder.
formun bir özeti lehine uzun dosya listelerini bırakarak (M'de N dosya
dizinler). Değer, uzunluğu için bir eşik değeri veren sayısal olmalıdır.
karakterlerle dosya listesi.

git
Git altında, bu kancayı (güncelleme kancasının içinden) çağırmanın normal yolu, onu bir
refname ardından bir taahhüt listesi. Çünkü git rev listesi normalde çoğundan listeler
eskiden en eskiye, bildirimlerin atlanmasını sağlamak için --reverse kullanmak isteyeceksiniz
kronolojik sıralama. Normal bir güncelleme komut dosyasında, çağrı şöyle görünmelidir

refname=$1
eski=2$
yeni=3$
irkerhook.py --refname=${refname} $(git rev-list --reverse ${eski}..${yeni})

bunun dışında irkerhook.py için mutlak bir yola ihtiyacınız olacak.

Test amacıyla ve geriye dönük uyumluluk için, irkerhook.py'yi no ile çağırırsanız
argümanlar (bir taahhüt sonrası kancada olduğu gibi) sanki şöyle çağrılmış gibi davranacaktır.
bu:

irkerhook.py --refname=refs/heads/master HEAD

Ancak, varsayılan olmayan bir şubeye bastığınızda bu doğru sonucu vermeyecektir.
çıplak repo.

Bu kancayı takmanın tipik bir yolu, aslında alma sonrası kancadadır, çünkü
gerekli tüm detaylar ve başarısızlık üzerine baskıyı iptal etmeyecektir. Aşağıdakileri kullanın
senaryo:

#!/ Bin / sh

echo "IRC bildirimi gönderiliyor"
eski yeni refname'yi okurken; yapmak
irkerhook --refname=${refname} $(git rev-list --reverse ${eski}..${yeni})
yapılmış

Kolaylık sağlamak için bu, irkerhook-git yardımcı komut dosyası tarafından uygulanır.

Tercihler, bir [irker] bölümündeki repo yapılandırma dosyasında ayarlanabilir. İşte bir örnek
neye benzeyebileceğinin:

[iğrenç]
proje = gpsd
renk = ANSI
kanallar = irc://chat.freenode.net/gpsd,irc://chat.freenode.net/commits

"Depo" değişkenini ayarlamamalısınız (bir eşdeğer hesaplanacaktır). Hiçbir hareket yok
bir irker.conf dosyasını yorumlamak için yapılır.

"Proje" değişkeninin varsayılan değeri, depo dizininin temel adıdır.
"urlprefix" değişkeninin varsayılan değeri "cgit"tir.

taahhüdün biçimini kontrol eden, git'e özgü bir değişken olan "revformat" vardır.
bir bildirimde tanımlayıcı. Aşağıdaki değerlere sahip olabilir:

çiğ
taahhüdün tam onaltılık kimliği

kısa
onaltılık kimliğin ilk 12 karakteri

tanımlamak
son etikete göre tanımla, kısa geri dön

Varsayılan 'açıklama'dır.

Yıkılma
Subversion altında, irkerhook.py değeri olan bir --repository seçeneğini kabul eder (mutlak
Subversion deposunun yol adı) ve bir taahhüt argümanı (sayısal revizyon seviyesi)
taahhüdün). Varsayılanlar, sırasıyla geçerli çalışma dizini ve HEAD'dir.

Ancak unutmayın ki, yapamam bir Subversion içindeki depo argümanını varsayılan
taahhüt sonrası kanca; Bunun nedeni, Subversion'ın bir sınırlamasıdır, bu da
geçerli dizin bu kancaların içinde güvenilir değil. Bunun yerine, değerler iki olmalıdır
Subversion'ın bu kancaya argüman olarak ilettiği argümanlar. Böylece, tipik bir çağrı
taahhüt sonrası komut dosyası şöyle görünecektir:

REPO=1$
GERİ=2$
irkerhook.py --repository=$REPO $REV

Diğer --variable=value ayarları da komut satırında verilebilir ve geçersiz kılınır.
irker.conf dosyasındaki herhangi bir ayar.

Proje değişkeni için varsayılan, havuzun temel adıdır. varsayılan değer
"urlprefix" değişkeninin adı "viewcvs"dir.

Depo kök dizininde (ödeme dizini değil) bir irker.conf dosyası varsa
ancak "format" dosyası gibi dahili öğelerin yaşadığı yerlerde) kanca değişkeni yorumlayacaktır
ondan ayarlar. İşte böyle bir dosyanın nasıl görünebileceğine dair bir örnek:

# irkerhook irker projesi için değişken ayarları
proje = irker
kanallar = irc://chat.freenode/irker,irc://chat.freenode/commits
tcp = yanlış

Bu dosyada "depo" veya "taahhüt" değişkenlerini ayarlamayın; bu mutsuz olurdu
Sonuçlar.

Subversion'a özgü değişkenler yoktur.

cıvalı
Mercurial altında, irkerhook.py iki şekilde çağrılabilir: ya bir Python kancası olarak
(tercih edilir) veya komut dosyası olarak.

Bunu bir Python kancası olarak adlandırmak için, "taahhüt" veya "gelen" kancaya collowing ekleyin
Mercurial deponuzdaki beyan:

[kancalar]
gelen.irker = python:/path/to/irkerhook.py:hg_hook

Bir komut dosyası olarak çağrıldığında, kanca değeri olan bir --repository seçeneğini kabul eder (mutlak
Mercurial deposunun yol adı) ve bir taahhüt argümanı alabilir (Mercurial hash
Taahhüdün kimliği veya buna bir referans). Depo bağımsız değişkeni için varsayılan,
geçerli dizin. Varsayılan taahhüt argümanı '-1' olup, mevcut ipucunu belirtir.
taahhüt.

Git'e gelince, her iki durumda da tüm değişkenler bir [irker] içindeki repo hgrc dosyasında ayarlanabilir.
Bölüm. Komut satırı değişkeni=değer bağımsız değişkenleri kabul edilir ancak komut dosyası için gerekli değildir
çağırma. Bir irker.conf dosyasını yorumlamak için hiçbir girişimde bulunulmaz.

"Proje" değişkeninin varsayılan değeri, depo dizininin temel adıdır.
"urlprefix" değişkeninin varsayılan değeri, "web.baseurl" yapılandırmasının değeridir.
varsa değer.

Süzme
Taahhütleri irkerd'e göndermeden önce filtrelemek mümkündür.

belirtmeniz gerekir filtrecmd irkerhook.py komutunu çalıştıracak olan seçenek.
Bu komut, taahhütün JSON temsili olan bir argümanı kabul etmelidir ve
çıkarıcı meta verileri (kanallar değişkeni dahil). Komut standarda yaymalıdır
(muhtemelen değiştirilmiş) meta verilerin bir JSON temsilini çıktılayın.

Aşağıda örnek bir filtre verilmiştir:

#!/usr/bin/ortam piton
# Bu, bir meta veri filtresinin önemsiz bir örneğidir.
# Tek yaptığı taahhüdün yazarının adını değiştirmek.
#
içe aktarma sistemi, json
meta veri = json.loads(sys.argv[1])

metadata['author'] = "Muhteşem ve Güçlü Oz"

baskı json.dumps(meta veri)
# son

İlerleme ve hata mesajları için standart hata mevcuttur.

SEÇENEKLER

irkerhook.py aşağıdaki seçenekleri kullanır:

-n
Bir daemon'a iletimi engelle. Bunun yerine, oluşturulan JSON isteğini şuraya dökün:
standart çıktı. Hata ayıklama için kullanışlıdır.

-V
Program sürümünü stdout'a yazın ve sonlandırın.

Onworks.net hizmetlerini kullanarak irkerhook'u çevrimiçi kullanın