irkerhook - क्लाउड में ऑनलाइन

कार्यक्रम:

नाम

irkerhook - रिपॉजिटरी हुक स्क्रिप्ट irker सूचनाएं जारी करती है

SYNOPSIS

irkerhook.py [-एन] [-वी] [[--परिवर्तनीय=मूल्य...]] [[प्रतिबद्ध-आईडी...]]

वर्णन

irkerhook.py एक पायथन स्क्रिप्ट है जिसे पोस्ट-कमिट हुक से कॉल करने का इरादा है
संस्करण-नियंत्रण भंडार। इसका काम उस कमिट के बारे में जानकारी इकट्ठा करना है जिसने गोली चलाई है
हुक (और संभवतः भंडार स्वामी द्वारा निर्धारित प्राथमिकताएँ) और उस जानकारी को शिप करें
विभिन्न घोषणा चैनलों को अग्रेषित करने के लिए irkerd का एक उदाहरण।

irkerhook.py का उचित आह्वान और व्यवहार किस वीसीएस के आधार पर भिन्न होता है
(संस्करण-नियंत्रण प्रणाली) इसे कॉल कर रहा है। चार अलग-अलग स्थान हैं जहां से यह हो सकता है
जानकारी निकालें:

1. वीसीएस उपयोगिताओं को कॉल।

2. git जैसे VCSes में जो उपयोगकर्ता-सेटटेबल कॉन्फ़िगरेशन वेरिएबल्स, वेरिएबल्स का समर्थन करते हैं
उपसर्ग "इरकर।"

3. अन्य VCSes में, एक कॉन्फ़िगरेशन फ़ाइल, "irker.conf", रिपॉजिटरी के आंतरिक भाग में
निर्देशिका.

4. फॉर्म के कमांड-लाइन तर्क --variable=value.

निम्नलिखित चर सभी समर्थित वीसीएस के लिए सामान्य हैं:

परियोजना
प्रोजेक्ट का नाम. अपेक्षाकृत संक्षिप्त पहचानकर्ता होना चाहिए; आम तौर पर दिखाई देगा
अधिसूचना की शुरुआत में ही.

रेपो
रिपॉजिटरी शीर्ष-स्तरीय निर्देशिका का नाम. यदि निर्दिष्ट नहीं है, तो डिफ़ॉल्ट a
प्रोजेक्ट नाम की छोटी प्रतिलिपि.

चैनलों
एक आईआरसी चैनल यूआरएल, या उसी की अल्पविराम से अलग की गई सूची, जो चैनल की पहचान करती है
सूचनाएं भेजी जानी हैं. यदि निर्दिष्ट नहीं है, तो डिफ़ॉल्ट फ़्रीनोड #कमिट है
चैनल.

सर्वर
वह होस्ट जिस पर अधिसूचना-रिलेइंग इरकर डेमॉन के रहने की उम्मीद है।
डिफ़ॉल्ट रूप से "लोकलहोस्ट"।

ईमेल
यदि सेट है, तो संचार के लिए टीसीपी या यूडीपी के बजाय ईमेल का उपयोग करें। मान का उपयोग इस प्रकार किया जाता है
लक्ष्य मेल पता.

टी सी पी
यदि "सही" है, तो संचार के लिए टीसीपी का उपयोग करें; यदि "झूठा" है, तो यूडीपी का उपयोग करें। डिफ़ॉल्ट रूप से "गलत"।

urlउपसर्ग
आपके रेपो के लिए चेंजसेट यूआरएल उपसर्ग। जब इसके साथ कमिट आईडी जोड़ी जाती है, तो इसे ऐसा करना चाहिए
एक सीजीआई पर इंगित करें जो सीजीआईटी, गिटवेब या कुछ इसी तरह के माध्यम से प्रतिबद्धता प्रदर्शित करेगा।
यदि आपके पास एक विशिष्ट gitweb/cgit सेटअप है तो डिफ़ॉल्ट संभवतः काम करेंगे।

यदि इस वेरिएबल का मान "कोई नहीं" है, तो कमिट में यूआरएल फ़ील्ड का सृजन
सूचनाएं दबा दी जाएंगी. अन्य जादुई मूल्य "सीजीआईटी", "गिटवेब" और हैं
"व्यूसीवीएस", जो यूआरएल टेम्पलेट्स तक विस्तारित होता है जो आमतौर पर उन सिस्टमों के साथ काम करेगा।

जादुई कुकीज़ "%(होस्ट)s" और %(repo)s" इस URL में हो सकती हैं। पहला है
होस्ट के FQDN तक विस्तारित, जिस पर irkerhook.py चल रहा है; उत्तरार्द्ध है
"रेपो" वेरिएबल के मान तक विस्तारित।

टिनीफायर
यूआरएल टेम्पलेट यूआरएल को संपीड़ित करने के लिए एक सेवा की ओर इशारा करता है ताकि वे कम उपयोग करें
अधिसूचना पंक्ति में स्थान. यदि इस चर का मान "कोई नहीं" है, तो नहीं
संपीड़न का प्रयास किया जाएगा.

रंग
यदि "mIRC", तो mIRC रंग कोड के साथ अधिसूचना फ़ील्ड को हाइलाइट करें। यदि "एएनएसआई", हाइलाइट करें
एएनएसआई रंग एस्केप अनुक्रमों के साथ अधिसूचना फ़ील्ड। डिफ़ॉल्ट "कोई नहीं" (कोई रंग नहीं)।
एएनएसआई कोड Chatzilla, irssi, ircle, और BitchX में समर्थित हैं; केवल एमआईआरसी कोड हैं
mIRC, XChat, KVirc, Konversation, या weechat में मान्यता प्राप्त।

ध्यान दें: यदि आप इसे चालू करते हैं और आपके चैनल पर सूचनाएं दिखाई देना बंद हो जाती हैं, तो आपको इसकी आवश्यकता है
उस चैनल पर आईआरसी का रंग फ़िल्टर बंद करने के लिए। ऐसा करने के लिए आपको ऑप की आवश्यकता होगी
विशेषाधिकार; आदेश जारी करें "/मोड -सी" के साथ आपके द्वारा प्रतिस्थापित
चैनल का नाम। आपको पहले "/msg chanserv set" कमांड जारी करने की आवश्यकता हो सकती है
MLOCK +nt-slk"।

maxchannels
एक पूर्णांक के रूप में व्याख्या की गई। यदि शून्य नहीं है, तो हुक द्वारा चैनलों की संख्या सीमित कर दी जाएगी
"चैनल" चर से व्याख्या करें।

इस वेरिएबल को VCS कॉन्फ़िगरेशन वेरिएबल या irker.conf के माध्यम से सेट नहीं किया जा सकता है; यह
केवल कमांड-लाइन तर्क के साथ सेट किया जाना चाहिए। इस प्रकार, एक फोर्ज साइट पर जिसमें भंडार
मालिकों को अपनी पोस्ट-कमिट स्क्रिप्ट को संशोधित करने की अनुमति नहीं है, एक साइट प्रशासक ऐसा कर सकता है
दुर्भावनापूर्ण प्रोजेक्ट स्वामियों द्वारा शॉटगन स्पैमिंग को रोकने के लिए इसे सेट करें। इसे एक मान पर सेट करना
हालाँकि, 2 से कम, संभवतः नासमझी होगी।

सियालाइक
यदि खाली नहीं है और "कोई नहीं" (डिफ़ॉल्ट) नहीं है, तो यह पुराने सीआईए व्यवहार का अनुकरण करता है
फॉर्म के सारांश के पक्ष में फाइलों की लंबी सूची को छोड़ना (एम में एन फाइलें)।
निर्देशिकाएँ)। मान की लंबाई के लिए एक सीमा मान देते हुए संख्यात्मक होना चाहिए
अक्षरों में फ़ाइल सूची.

Git
गिट के तहत, इस हुक को लागू करने का सामान्य तरीका (अपडेट हुक के भीतर से) इसे पास करता है
कमिट की सूची के बाद नाम बदलें। क्योंकि Git संशोधित सूची आम तौर पर अधिकांश से सूचियाँ
हाल से लेकर सबसे पुराने तक, आप सूचनाओं को हटाने के लिए - रिवर्स का उपयोग करना चाहेंगे
कालानुक्रमिक क्रम में। एक सामान्य अद्यतन स्क्रिप्ट में, आह्वान इस तरह दिखना चाहिए

नाम बदलें = $1
पुराना=$2
नया=$3
irkerhook.py --refname=${refname} $(git rev-list --revers ${old}..${new})

सिवाय इसके कि आपको irkerhook.py के लिए एक पूर्ण पथ की आवश्यकता होगी।

परीक्षण उद्देश्यों और पश्चवर्ती संगतता के लिए, यदि आप irkerhook.py को no के साथ लागू करते हैं
तर्क (पोस्ट-कमिट हुक के रूप में) यह ऐसा व्यवहार करेगा जैसे इसे बुलाया गया था
इस:

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

हालाँकि, जब आप a की गैर-डिफ़ॉल्ट शाखा पर दबाव डालते हैं तो यह सही परिणाम नहीं देगा
नंगे रेपो.

इस हुक को स्थापित करने का एक विशिष्ट तरीका वास्तव में पोस्ट-प्राप्त हुक में है, क्योंकि यह मिलता है
सभी आवश्यक विवरण और विफलता पर दबाव समाप्त नहीं होगा। निम्न का उपयोग करें
स्क्रिप्ट:

#!/ बिन / श

इको "आईआरसी अधिसूचना भेज रहा है"
जबकि पुराना नया refname पढ़ें; करना
irkerhook --refname=${refname} $(git rev-list --revers ${old}..${new})
किया

सुविधा के लिए, इसे irkerhook-git हेल्पर स्क्रिप्ट द्वारा कार्यान्वित किया जाता है।

प्राथमिकताएँ रेपो कॉन्फ़िग फ़ाइल में [irker] अनुभाग में सेट की जा सकती हैं। यहाँ एक उदाहरण है
वह कैसा दिख सकता है:

[इर्कर]
प्रोजेक्ट = जीपीएसडी
रंग = एएनएसआई
चैनल = irc://chat.freenode.net/gpsd,irc://chat.freenode.net/commits

आपको "रिपॉजिटरी" वैरिएबल सेट नहीं करना चाहिए (समकक्ष की गणना की जाएगी)। कोई प्रयास नहीं
एक irker.conf फ़ाइल की व्याख्या करने के लिए बनाया गया है।

"प्रोजेक्ट" वेरिएबल का डिफ़ॉल्ट मान रिपॉजिटरी निर्देशिका का बेसनाम है।
"urlprefix" वेरिएबल का डिफ़ॉल्ट मान "cgit" है।

एक गिट-विशिष्ट वैरिएबल, "रेवफॉर्मेट" है, जो कमिट के प्रारूप को नियंत्रित करता है
एक अधिसूचना में पहचानकर्ता. इसके निम्नलिखित मान हो सकते हैं:

कच्चा
प्रतिबद्धता की पूर्ण हेक्स आईडी

कम
हेक्स आईडी के पहले 12 अक्षर

वर्णन
अंतिम टैग के सापेक्ष वर्णन करें, संक्षेप में वापस आते हुए

डिफ़ॉल्ट 'वर्णन' है।

विनाश
सबवर्सन के तहत, irkerhook.py मूल्य (पूर्ण) के साथ एक --repository विकल्प स्वीकार करता है
सबवर्सन रिपॉजिटरी का पथनाम) और एक प्रतिबद्ध तर्क (संख्यात्मक संशोधन स्तर
प्रतिबद्धता का) डिफ़ॉल्ट क्रमशः वर्तमान कार्यशील निर्देशिका और HEAD हैं।

हालाँकि, ध्यान दें कि आप नही सकता सबवर्सन के अंदर रिपॉजिटरी तर्क को डिफ़ॉल्ट करें
पोस्ट-कमिट हुक; यह तोड़फोड़ की एक सीमा के कारण है, जो कि प्राप्त करना है
इन हुक के अंदर वर्तमान निर्देशिका विश्वसनीय नहीं है। इसके बजाय, मान दो होने चाहिए
तर्क जो सबवर्सन उस हुक को तर्क के रूप में पास करता है। इस प्रकार, एक विशिष्ट आह्वान
पोस्ट-कमिट स्क्रिप्ट इस तरह दिखेगी:

रेपो=$1
आरईवी=$2
irkerhook.py --repository=$REPO $REV

अन्य --variable=value सेटिंग्स भी कमांड लाइन पर दी जा सकती हैं, और ओवरराइड हो जाएंगी
irker.conf फ़ाइल में कोई भी सेटिंग।

प्रोजेक्ट वेरिएबल के लिए डिफ़ॉल्ट रिपॉजिटरी का बेसनाम है। डिफ़ॉल्ट मान
"urlprefix" वेरिएबल का "viewcvs" है।

यदि कोई irker.conf फ़ाइल रिपोजिटरी रूट निर्देशिका में मौजूद है (चेकआउट निर्देशिका नहीं)।
लेकिन जहां आंतरिक जैसे "प्रारूप" फ़ाइल लाइव होती है) हुक वेरिएबल की व्याख्या करेगा
इससे सेटिंग्स. ऐसी फ़ाइल कैसी दिख सकती है इसका एक उदाहरण यहां दिया गया है:

# इरकर प्रोजेक्ट के लिए इरकरहुक वैरिएबल सेटिंग्स
प्रोजेक्ट = इरकर
चैनल = irc://chat.freenode/irker,irc://chat.freenode/commits
टीसीपी = गलत

इस फ़ाइल में "रिपॉजिटरी" या "कमिट" वेरिएबल सेट न करें; वह दुखी होगा
परिणाम है.

कोई तोड़फोड़-विशिष्ट चर नहीं हैं।

अस्थिर
मर्क्यूरियल के तहत, irkerhook.py को दो तरीकों से लागू किया जा सकता है: या तो पायथन हुक के रूप में
(पसंदीदा) या एक स्क्रिप्ट के रूप में।

इसे पायथन हुक कहने के लिए, "कमिट" या "इनकमिंग" हुक में कोलोइंग जोड़ें
आपके मर्क्यूरियल रिपॉजिटरी में घोषणा:

[हुक]
incoming.irker = Python:/path/to/irkerhook.py:hg_hook

जब एक स्क्रिप्ट के रूप में बुलाया जाता है, तो हुक मूल्य (पूर्ण) के साथ एक --repository विकल्प स्वीकार करता है
मर्क्यूरियल रिपॉजिटरी का पथनाम) और एक प्रतिबद्ध तर्क (मर्क्यूरियल हैश) ले सकता है
कमिट की आईडी या उसका संदर्भ)। रिपॉजिटरी तर्क के लिए डिफ़ॉल्ट है
वर्तमान निर्देशिका। डिफ़ॉल्ट प्रतिबद्ध तर्क '-1' है, जो वर्तमान टिप को निर्दिष्ट करता है
प्रतिबद्ध।

जहाँ तक git का सवाल है, दोनों ही मामलों में सभी वेरिएबल्स को रेपो hgrc फ़ाइल में [irker] में सेट किया जा सकता है
अनुभाग। कमांड-लाइन वेरिएबल=वैल्यू तर्क स्वीकार किए जाते हैं लेकिन स्क्रिप्ट के लिए आवश्यक नहीं हैं
मंगलाचरण। Irker.conf फ़ाइल की व्याख्या करने का कोई प्रयास नहीं किया गया है।

"प्रोजेक्ट" वेरिएबल का डिफ़ॉल्ट मान रिपॉजिटरी निर्देशिका का बेसनाम है।
"urlprefix" वेरिएबल का डिफ़ॉल्ट मान "web.baseurl" कॉन्फ़िगरेशन का मान है
मूल्य, यदि यह मौजूद है।

छनन
कमिट को irkerd पर भेजने से पहले फ़िल्टर करना संभव है।

आपको निर्दिष्ट करना होगा फ़िल्टरcmd विकल्प, जो कमांड होगा irkerhook.py चलेगा।
इस आदेश को एक तर्क को स्वीकार करना चाहिए, जो प्रतिबद्ध का JSON प्रतिनिधित्व है
एक्सट्रैक्टर मेटाडेटा (चैनल वेरिएबल सहित)। कमांड को मानक के अनुसार उत्सर्जित होना चाहिए
(संभवतः परिवर्तित) मेटाडेटा का JSON प्रतिनिधित्व आउटपुट करें।

नीचे एक उदाहरण फ़िल्टर है:

#!/usr/बिन/env अजगर
# यह मेटाडेटा फ़िल्टर का एक मामूली उदाहरण है.
# यह केवल कमिट के लेखक का नाम बदलता है।
#
आयात sys, json
मेटाडेटा = json.loads(sys.argv[1])

मेटाडेटा['लेखक'] = "द ग्रेट एंड पावरफुल ओज़"

छाप json.dumps(मेटाडेटा)
# समाप्त

प्रगति और त्रुटि संदेशों के लिए हुक में मानक त्रुटि उपलब्ध है।

विकल्प

irkerhook.py निम्नलिखित विकल्प लेता है:

-n
किसी डेमॉन में ट्रांसमिशन को रोकें। इसके बजाय, जेनरेट किए गए JSON अनुरोध को डंप करें
मानक आउटपुट. डिबगिंग के लिए उपयोगी.

-V
स्टडआउट और समाप्त करने के लिए प्रोग्राम संस्करण लिखें।

onworks.net सेवाओं का उपयोग करके ऑनलाइन irkerhook का उपयोग करें