प्लिम - पायथन का सबसे व्यापक स्लिम टेंपलेटिंग पोर्ट

निश्चित रूप से, हेमल और स्लिम के पहले कार्यान्वयन पायथन में दिखाई देने वाले थे। या कम से कम यह उचित होगा।
HTML मार्कअप लिखने के लिए एक अधिक "पाइथोनिक" दृष्टिकोण की कल्पना करना मुश्किल है, जो कभी इन भाषाओं द्वारा प्रस्तावित किया गया था। इंडेंटेड सिंटैक्स, क्लोजिंग कैरेक्टर्स की कमी, सामान्य संक्षिप्तता - क्या ये शब्द किसी औसत प्रोग्रामर के होंठों से किसी को पहली बार पाइथन के बारे में सुनाई नहीं दे रहे हैं?

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

प्रेरणा

पायथन के लिए, पहले से ही काफी बड़ी संख्या में पैकेज हैं जो हमल जैसी मार्कअप भाषाओं को लागू करते हैं। यहाँ उनमें से कुछ हैं:

• slimish-jinja2
• PyJade
• टकसाल
• SHPAML
• Yammy
• PyHAML
• HamlPy

एक तरह से या किसी अन्य, इन सभी परियोजनाओं को उनके विस्तार की डिग्री में मूल स्लिम से नीच हैं:

- कुछ में निहित सिंटैक्स दोष हैं जो अब तय नहीं किए जा सकते हैं, क्योंकि परियोजनाओं में एक बड़े कोड बेस के साथ एक स्थापित ऑडियंस है;
- अन्य सभी मौजूदा "बड़े" अजगर टेम्पलेट इंजनों के लिए क्रॉस-कंपाइलर्स लिखने की कोशिश कर रहे हैं, जिसके परिणामस्वरूप उनमें से प्रत्येक का वाक्यविन्यास समान रूप से समर्थित है;
- बाकी सभी में बहुत ज्यादा भोली-भाली बातें हैं। यहां तक ​​कि स्लिमिश- jinja2 (जो, सिद्धांत रूप में, पूरे स्लिम सिंटैक्स का समर्थन करना चाहिए) बहुत मामूली तरीके से लागू किया जाता है। कृपया ध्यान दें कि एक टैग की विशेषताओं को पार्स करना एक बहुत ही सरल नियमित अभिव्यक्ति का उपयोग करता है, जो "=" वर्ण वाले लगभग किसी भी अजगर स्ट्रिंग के साथ गलत तरीके से काम करेगा। यह स्पष्ट रूप से एक परियोजना नहीं है जिसे आज आपकी सुव्यवस्थित विकास प्रक्रिया में लागू किया जा सकता है।

यह पता चला कि पैकेजों की इतनी बड़ी सूची के साथ भी, उत्पादन प्रणाली की बात आती है। इस निराशाजनक निष्कर्ष के परिणामस्वरूप, मूल स्लिम टेम्पलेट इंजन के अपने स्वयं के, उत्पादन-तैयार बंदरगाह को लिखने का निर्णय लिया गया।

कार्यान्वयन

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

"सबसे पूर्ण कार्यान्वयन" के लिए सबसे पतला नियंत्रण संरचनाओं का समर्थन करना है। हालाँकि, आपको तुरंत स्पष्ट करना चाहिए कि प्लिम भाषा का सटीक पोर्ट नहीं है ! सिंटैक्स के कुछ तत्वों को हटा दिया गया था, दूसरों को काफी पूरक बनाया गया था, और कुछ निर्माणों में स्पष्टता और विशिष्टता पेश की गई थी। लेकिन, फिर भी, ज्यादातर सिंटैक्स में कोई बदलाव नहीं आया है, इसलिए जब प्लिम के साथ काम करते हैं तो आप मौजूदा सिलेक्टर्स का उपयोग करके स्लिम सिंटैक्स को हाइलाइट कर सकते हैं।

अंत में स्थिति को स्पष्ट करने के लिए, सिंटैक्स के सभी परिवर्तनों की एक सूची निम्न है:

1. स्लिम निम्नलिखित लाइन संकेतक का समर्थन करता है - "" "," = "" और "=="। प्लिम में, एपोस्ट्रोफ (एकल उद्धरण) को अल्पविराम से बदल दिया गया है:
   

   , value =, value ==, value 

   
   यह परिवर्तन इस तथ्य से तय किया गया था कि एक एकल उद्धरण एक अनियंत्रित पायथन अभिव्यक्ति की शुरुआत में एक वैध चरित्र है। इसलिए, निम्नलिखित प्लिम अभिव्यक्तियों की एक अस्पष्ट व्याख्या होगी (जो स्वचालित कोड अनुवाद के समय हमेशा खराब होती है):
   

    /      python-,       ,     ? ='' /     python-    ('u''' -   python-)       ,       ? ='u''' 

   
   
   उसी समय, किसी भी सही अजगर स्ट्रिंग की शुरुआत में अल्पविराम चरित्र की अनुमति नहीं है, इसलिए इसका उपयोग करते समय हमें भावों की स्पष्ट व्याख्या मिलती है:
   

    /    runtime,    mako- ${'} -   .   . =,' /    .  mako-   -,      . =,u'' 

   
   
2. स्लिम के विपरीत, प्लिम टैग विशेषताओं को उजागर करने के लिए चौकोर और घुंघराले ब्रेसिज़ का समर्थन नहीं करता है। आप केवल कोष्ठक का उपयोग कर सकते हैं।
   यह प्रतिबंध कुछ पार्सर घटकों के एल्गोरिदम के तर्क को सरल करता है और सिंटैक्स में मानकीकरण के एक निश्चित स्तर का परिचय देता है, जबकि बिल्कुल इसकी कार्यक्षमता को कम नहीं करता है:
   

    /         . p(title="Link Title") h1 class=(item.id == 1 and 'one' or 'unknown') Title /         mako-  python- a#idx-${item.id} href=item.get_link( **{'argument': 'value'}) = item.attrs['title'] 

   
   
3. जैसा कि आप पिछले उदाहरण में देख सकते हैं, प्लिम शॉर्ट टैग रूपों (# id.class) में गतिशील अभिव्यक्तियों का समर्थन करता है। आप कोष्ठक में अभिव्यक्तियों को दूसरी पंक्ति में भी स्थानांतरित कर सकते हैं:
   

    /       #m${ c.message.id }.msg${ ( "test" ) } = do_something_real( 'with', 'the', real, arguments) 

   
   
4. प्लिम में, सभी टैग को लोअरकेस अक्षर का उपयोग करना चाहिए । यह प्रतिबंध "निहित" शाब्दिक तार के लिए भाषा समर्थन में शामिल करने में सक्षम होने के लिए पेश किया गया था, जो सूची के अगले पैराग्राफ में चर्चा की गई है। लेकिन आप अनुमान लगा सकते हैं कि यह निम्नलिखित उदाहरण से क्या है:
   

    doctype 5 html head title Page Title body p | !  -   ,    . p !  -   ,      . 

   
   
5. स्लिम के विपरीत, प्लिम में निहित पाठ ब्लॉक के लिए समर्थन है। एक पाठ ब्लॉक को "निहित शाब्दिक" माना जाएगा यदि इसकी पहली पंक्ति पात्रों के निम्नलिखित अनुक्रमों में से एक के साथ शुरू होती है:
   
   • लैटिन राजधानी पत्र
   • एक सीमा से कोई भी पत्र ASCII वर्ण तालिका में शामिल नहीं है;
   • कोई भी अंक जिसके पहले कोई "+" या "-" अक्षर जो आरक्षित हैं;
   • किसी भी और -प्ररूप एन्कोडेड HTML चरित्र। उदाहरण के लिए, & nbsp;
   • "$ {" वर्णों के अनुक्रम से शुरू होने वाली mako अभिव्यक्ति;
   • स्क्वायर ब्रैकेट खोलना "[";
   • कोष्ठक खोलना "(";
   • कोई भी यूनिकोड वर्ण जो कोड U0021 - U007E (यानी, ASCII रेंज 33 के बाहर - 126, जो एक आरक्षित पार्सर है) की सीमा में नहीं है।
   
   यहाँ अंतर्निहित पाठ ब्लॉक का उपयोग करने का एक उदाहरण है:
   

    p | pipe is the explicit literal indicator. It is required if your line starts with the non-literal character. p I'm the implicit literal, because my first letter is in uppercase. p 1. Digits 2. are 3. the 4. implicit 5. literals 6. too. p ${raw_mako_expression} indicates the implicit literal line. p If subsequent lines do not start with implicit literal indicator, you must indent them | or you can use the "explicit" pipe. p       ,    ,     ASCII-,           . 

   
   
6. आपको चरित्र का उपयोग करने की आवश्यकता नहीं है "|" (पाइप - शैली और स्क्रिप्ट टैग में एक स्पष्ट शाब्दिक का एक संकेतक);
7. प्लम नियंत्रण संरचनाओं और फिल्टर के बीच कोई अंतर नहीं करता है।
   उदाहरण के लिए, स्लिम में आपको "-if", "-for" और इसी तरह किसी भी नियंत्रण निर्माण के लिए लिखना चाहिए, लेकिन कॉफी: (शुरुआत में माइनस के बिना, लेकिन अंत में एक डबल के साथ) - किसी भी उपलब्ध फिल्टर के लिए। प्लिम में, आप एक ही वाक्यविन्यास का उपयोग करते हैं: "-if", "-for" और "-ऑफ़"।
8. Plim HTML टैग्स को सपोर्ट करता है! आपको केवल उन्हें बंद करने के लिए याद रखना चाहिए। टैग के अंदर, समान पार्सिंग नियम "क्लीन" प्लिम मार्कअप के लिए काम करते हैं। यह कार्यक्षमता विशेष रूप से उपयोगी है जब आप निम्नलिखित उदाहरण के समान कुछ लागू करने की कोशिश कर रहे हैं:
   

    - if edit_profile /       <div id="edit-profile"> - include new_or_edit_interface.html - if edit_profile /     </div> 

   
   HTML टैग के समर्थन के कारण, Plim ने "/!" के समतुल्य को लागू नहीं किया जिसके साथ स्लिम ने HTML टिप्पणियों को उत्पन्न किया। प्लिम में इस तरह के डिजाइन की निरर्थकता के बारे में निर्णय इस तथ्य के कारण किया गया था कि वर्तमान में HTML टिप्पणियां लगभग विशेष रूप से इंटरनेट एक्सप्लोरर सशर्त हैक के लिए उपयोग की जाती हैं। यह नगण्य गुंजाइश मार्कअप भाषा में अतिरिक्त वाक्य रचना के निर्माण को सही नहीं ठहराती है, जिसमें "देशी" एचटीएमएल-टिप्पणियों के लिए अंतर्निहित समर्थन है।
   

जैसा कि आप देख सकते हैं, मूल भाषा के संबंध में परिवर्तन यथासंभव सावधानीपूर्वक किए गए थे और केवल उन्हीं स्थानों पर जहाँ मैंने सोचा था, नियमों की अनावश्यक "सख्ती" थी।

बोनस

मूल सिंटैक्स के अलावा, प्लिम लागू होता है:

• निर्मित में CoffeeScript, SCSS / SASS, मार्कडाउन और reStructuredText के समर्थन में;
• -सुनालों और कुंडली ऑपरेटरों के लिए समर्थन;
• प्रपत्र में बूलियन विशेषताओं के लिए समर्थन = (bool_dynamic_expr)? ;
• सभी मेको टैग और नियंत्रण संरचनाओं के लिए संक्षिप्त रूप।

मेटा जानकारी

आप ReadTheDocs.org प्लेटफॉर्म (अंग्रेजी संस्करण, वहाँ पीडीएफ और epub हैं ) पर भाषा के सभी नियंत्रण संरचनाओं पर विस्तृत और अद्यतित दस्तावेज़ पा सकते हैं।

GitHub पर ट्रैकर में सभी सुझावों और त्रुटि संदेशों का स्वागत है ।

PS वर्तमान संस्करण का परीक्षण केवल शाखा 2.7 पर किया गया था। मुझे यकीन नहीं है (परीक्षणों के लिए कोई आवश्यक वातावरण नहीं है), लेकिन 2.6 में भी सब कुछ ठीक होना चाहिए। लेकिन 3.x वर्तमान में निश्चित रूप से समर्थित नहीं है। लेकिन यह केवल इस तथ्य के कारण है कि Py3K में मानक पुस्तकालय से कुछ पैकेजों ने अपना स्थान बदल दिया है।