लॉजी - मानव चेहरे के साथ एक लकड़हारा

कुछ समय पहले, मेरे दिमाग में जावा को अधिक अनुकूल, सरल और उसी समय विन्यास में काफी लचीला बनाने के लिए विचार आया। इस तरह की आवश्यकताएं शायद एक मध्यम और छोटी परियोजना में सच हैं, जहां आप भारी लॉग 4j के बिना कर सकते हैं। वस्तुतः एक सप्ताह में, यह विचार एक साधारण जावा लाइब्रेरी में समान रूप से सरल नाम से विकसित हुआ - लॉजी ।

का उपयोग करें:

import static logy.Logy.*; public class Test { public void test() { String s[] = {"a", "b"}; warn("Can't find", quote(upper("c")), "in", group(quote(upper(scalar(s))))); } } 

निष्कर्ष:
29.06.2012 1:19:25 Test.test [WARN] :: Can't find "C" in ["A", "B"]

मेरे लिए, यह बहुत पठनीय लगता है, सिंटैक्टिक शुगर, डीएसएल जैसी एपीआई और कॉल के समय लॉगिंग मापदंडों की गतिशील परिभाषा के लिए धन्यवाद (अतिरिक्त फ़ील्ड के बिना public static final Logger logger = ... कक्षा में public static final Logger logger = ... )।

शीर्षक के बारे में

शब्द "लोगी" - अंग्रेजी से "गूंगा" के रूप में अनुवादित है। एक ओर, नाम को "लॉग" के रूप में कम माना जाता है, दूसरी ओर, यह संकीर्णता (एक अच्छे अर्थ में) और पुस्तकालय की सादगी पर संकेत देता है।

सुविधाएँ / सुविधाएँ

• संकलित JAR फ़ाइल में 17 kb लेता है
• कोई निर्भरता नहीं
• DSL- जैसे API: उद्धरण, समूह, ऊपरी, निर्यात, ...
• लॉगिंग मापदंडों की गतिशील परिभाषा (लकड़हारे की स्पष्ट शुरुआत के बिना)
• फ़ाइल के लिए लॉगिंग / stdout / stderr
• कॉन्फ़िगरेशन फ़ाइलों में मुखौटा समर्थन ("*")
• सीमा में विन्यास "विश्व स्तर पर" ... "विधि"

एपीआई

लॉजी एपीआई स्थिर तरीकों का एक सेट है जिसमें एक पैरामीटर्स की चर संख्या होती है जिसे एक लाइन में प्रोजेक्ट में आयात किया जा सकता है:

 import static logy.Logy.*; 

5 संदेश स्तर, प्राथमिकता के क्रम में: "डिबग", "ठीक", "जानकारी", "चेतावनी", "त्रुटि", समान विधियों द्वारा दर्शाए गए हैं।

एक उदाहरण:

 error("Files", quote("file1", "file2"), "not found!"). 

निष्कर्ष:
Files "file1" "file2" not found!

"निर्यात" विधि का उपयोग करके रूपांतरण के परिणामों को एक स्ट्रिंग में निर्यात करें।

एक उदाहरण:

 String s = export("The", quote(upper("message")), "can't be delivered!"); System.out.println(s); 

निष्कर्ष:
The "MESSAGE" can't be delivered!

उद्धरण चिह्नों में कोटेशन पैरामीटर।

एक उदाहरण:

 int arr[] = {1, 2, 3, 4}; info("Quotted values:", quote(scalar(arr), "a", "b")); 

निष्कर्ष:
Quotted values: "1" "2" "3" "4" "a" "b"

"समूह" विधि का उपयोग करके परिणाम समूहन।

 String s[]= {"a", "b", "c"}; info("Grouped values:", group(scalar(s), 1, "d")); 

निष्कर्ष:
Grouped values: [a, b, c, 1, d]

"ऊपरी" और "निचले" तरीकों का उपयोग करके मापदंडों के रजिस्टर को बदलना।

एक उदाहरण:

 String s[]= {"a", "b", "c"}; info("Uppered values:", upper(scalar(s))); info("Lowered values:", lower("A", "B", "C")); 

निष्कर्ष:
Uppered values: ABC
Lowered values: abc

"स्केलर" और "सरणी" विधियों का उपयोग करके पैरामीटर के लिए उपयोग के मामले का स्पष्टीकरण।

एक उदाहरण:

 int arr[] = {1, 2, 3, 4}; info("Quotted array:", quote(array(arr))); info("Quotted values:", quote(scalar(arr))); 

निष्कर्ष:
Quotted array: "[1, 2, 3, 4]"
Quotted values: "1" "2" "3" "4"

विन्यास

कॉन्फ़िगरेशन फ़ाइलें निम्न परिभाषाओं का समर्थन करती हैं:

• "#" के साथ शुरू होने वाली टिप्पणियाँ
• "VARIABLE @ SCOPE = VALUE" फ़ॉर्म के तीन

उदाहरण के लिए, एक वैश्विक संदेश प्रारूप को कॉन्फ़िगर करने के लिए एक ट्रिपल इस तरह दिख सकता है:

 format@=%date% %time %class% [%level%] %%% 

जहाँ निम्नलिखित संदर्भ चर उपलब्ध हैं:

• % स्कोप% - उस पथ का पूर्ण पथ जिसमें से लकड़हारा को बुलाया जाता है
• % वर्ग% - उस विधि का पूर्ण पथ जिस विधि से लकड़हारा को बुलाया जाता है
• % विधि% - उस विधि का नाम जिससे लकड़हारा कहा जाता है
• % तारीख% - तिथि, उस समय जब लकड़हारा को बुलाया गया था, वर्तमान लोकेल के प्रारूप में
• % समय% - उस समय जब लकड़हारा को बुलाया गया था, वर्तमान लोकेल के प्रारूप में
• % स्तर% - लकड़हारा संदेश स्तर
• %%% - लकड़हारा संदेश

चर की गुंजाइश सेट करते समय मुख्य विशेषता मार्ग में "*" का उपयोग होता है।

एक साधारण उदाहरण पर विचार करें। मान लीजिए कि आप सभी संदेशों को परीक्षण कक्षाओं से फ़ाइल में लॉग इन करना चाहते हैं और अन्य कक्षाओं से कंसोल में केवल त्रुटियों को लॉग करते हैं। ऐसा करने के लिए, प्रोजेक्ट की जड़ में, निम्न सामग्री के साथ "properties.logy" फ़ाइल बनाएँ:

 #   level@=error logger@=stream:err #     “Test”     “test” level@*Test.test*=debug logger@*Test.test*=file:test.log 

योजनाओं

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

केवल एक चीज जो वास्तव में लॉजी की कमी है, वह है) उपयोग के एक क्षेत्र के लिए कई लॉगर्स का समर्थन (अब, दुर्भाग्य से, केवल एक); ख) एक बहु-थ्रेडेड वातावरण में सही संचालन (सच बताने के लिए, मैंने जांच नहीं की, लेकिन मुझे संदेह है कि समस्याएं होंगी, खासकर जब एक फ़ाइल में लॉगिंग होती है)।

मैं 0.2.0 संस्करण के लिए निकट भविष्य में ये बदलाव करने की योजना बना रहा 0.2.0 ।

पुनश्च

बेशक, मैंने लाइब्रेरी की सभी विशेषताओं के बारे में बात नहीं की। अधिक विस्तृत प्रलेखन (लेखन की प्रक्रिया में) GitHub परियोजना पृष्ठ पर पाया जा सकता है।

मुझे फीडबैक, कांटे, पूल अनुरोध और बग रिपोर्ट पर बहुत खुशी होगी।

एनालॉग्स के लिए के रूप में। मैंने व्यर्थ इस प्रश्न को अंत में नहीं छोड़ा है। ईमानदारी से, मैं वास्तव में समान कार्यक्षमता और क्षमताओं के साथ एक पुस्तकालय खोजने की कोशिश नहीं करता। शायद इसलिए कि मैं पूरी तरह से अपना खुद का कुछ लिखना चाहता था, या, मैं सिर्फ "हां, आप पहले से ही इस के साथ आने के बहाने खोज रहा हूँ, मैं जा रहा हूँ और खाऊंगा" मेरे सिर में हर नए विचार के सामने जो कार्यान्वयन के लिए भूखा है। इसके अलावा, यह ज्ञात है कि वास्तव में कुछ नया करने के लिए लगभग असंभव है, यह दूसरों की तुलना में बेहतर करना संभव है।