निर्माण उपकरण और उपयोगिताओं के साथ Django परियोजना टेम्पलेट

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

इसलिए, मैं जनता के सामने एक परियोजना पेश कर रहा हूँ "कम स्क्रिबल!" जल्दी करो, डीबग करो! ”Django पर उच्च गति के विकास के लिए एक सेट।

ये 2 पैटर्न हैं:

• बिल्डआउट कॉन्फ़िगरेशन टेम्प्लेट जो प्रोजेक्ट के लिए आवश्यक सभी पैकेजों को खींचता है और इकट्ठा करता है
• प्रोजेक्ट टेम्प्लेट, अर्थात् सेटिंग्स जिसमें सभी आवश्यक उपकरण शामिल हैं, और स्टैटिक्स का एक सेट (हमल और सास में तैयार फाइलें)

स्थापना

एक परियोजना को अपलोड करने और Django में एक परियोजना बनाने के लिए, बस कमांड निष्पादित करें:

  $ hg क्लोन ssh: //hg@bitbucket.org/siberiano/fastdev-django my_new_project
 $ cd my_new_project
 $ rm .hg / hgrc
 $ अजगर बूटस्ट्रैप -डिस्टवर्ल्ड
 $ बिल्डआउट बनाते हैं 

( BitBucket पर प्रोजेक्ट पेज। )

परियोजना में क्या शामिल हैं:

makefile

कमांड लाइन स्क्रिप्ट के एक सेट के बजाय, हमने अपने प्रोजेक्ट में मेकफाइल बनाया और कमांड की निर्भरता संकलित की, उदाहरण के लिए, रनआउट केवल बिल्डआउट और बूटस्ट्रैप के बाद पूरा किया जा सकता है। मैंने निम्नलिखित नियमित प्रक्रियाओं को जोड़ा:

• रन - 0.0.0.0:8000 पर सर्वर शुरू करता है
• shell_plus - विस्तारित django कमांड लाइन को लॉन्च करता है
• make_messages - html और haml से एक स्थानीय फ़ाइल संकलित करता है
• संकलन - अनुवाद संकलित करता है

buildout

zc.buildout एक स्क्रिप्ट है जिसे Zope प्रोजेक्ट में विकसित किया गया है और इसका उपयोग Pylons में किया जाता है जो किसी प्रोजेक्ट फ़ोल्डर या उपयोगकर्ता फ़ोल्डर में ~ / .buildआउट को एकत्रित करता है, प्रोजेक्ट वातावरण को अतिरिक्त पैकेज (साइट पैकेज) से अलग करता है और कुछ व्यंजनों को निष्पादित करता है (उदाहरण के लिए, स्क्रिप्ट स्थापित करें और उस पर एक दूसरे से एक कड़ी रखो)।

बिल्डआउट में सेटिंग्स की एक लचीली प्रणाली और विभिन्न लिपियों का एक तैयार-निर्मित संग्रह है, सामान्य तौर पर, एक विकसित बुनियादी ढांचा जिसे आप एक काम कर रहे प्रोजेक्ट को इकट्ठा करने के लिए उपयोग कर सकते हैं।

यहां सबसे सरल कॉन्फ़िगरेशन का एक उदाहरण है, जहां हम अतिरिक्त पैकेज और पाइफ्लेक्स स्टैटिक कोड एनालाइज़र के साथ Djanga स्थापित करते हैं:

  [Buildout]
 भागों =
     Django
     pyflakes
 
 [Django]
 रेसिपी = djangorecipe
 अंडे = 
     IPython
     django_extensions

 [Pyflakes]
 नुस्खा = zc.recipe.egg
 लिपियाँ = चिताएँ
 अंडे = pyflakes
 प्रविष्टि-अंक = pyflakes = pkg_resources: run_script
 तर्क = 'pyflakes', 'pyflakes'

बिल्डआउट एक विशेष साइट से djangorecipe और zc.recipe.egg नुस्खा डाउनलोड करेगा और उन्हें निष्पादित करेगा।

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

यह कॉन्फ़िगरेशन हमें कुछ सिरदर्द से बचाता है:

• कहीं न कहीं हम संकेत कर सकते हैं कि कौन से अंडे की जरूरत है, और वे किसी भी नई प्रणाली पर स्वचालित रूप से स्थापित हो जाएंगे, उदाहरण के लिए, होस्टिंग, और एक (कमांड) के साथ!
• हम यह सुनिश्चित कर सकते हैं कि सभी सिस्टम एक ही संस्करण के अंडे देंगे (संभवतः पुराने भी, लेकिन काम करने की गारंटी)

परियोजना की स्थापना 2 टीमों में की जाती है:

  $ अजगर बूटस्ट्रैप -डिस्टवर्ल्ड
 $ बिन / बिल्डआउट

प्रोजेक्ट तैयार है, और डेवलपर के लिए Django सर्वर पहले से ही शुरू किया जा सकता है। हम प्रबंधित करते हैं [कमांड] के बजाय

  $ बिन / django चलाने वाला 0.0.0.0:8000 

बैटरी

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

  $ बिन / pyflakes my_new_script.py
 अपरिभाषित चर: test_string, पंक्ति 2
 परिभाषा से पहले प्रयुक्त चर: एक और_वार, पंक्ति 5 

(2 वेरिएबल्स तक पहुंच जो घोषित नहीं की गई थी। एक विश्लेषक के बिना, हम दो बार साइट लॉन्च करेंगे और बग देखेंगे।)

विश्लेषणकर्ताओं के बाद, प्रोग्रामर को डीबगर्स की आवश्यकता होती है। पायथन में उनमें से बहुत सारे हैं, लेकिन जिन लोगों की हमने टीम में जाँच की, उनमें सबसे सुविधाजनक PuDB है , यह एक संवादात्मक वातावरण है जो टेक्स्ट मोड में मिडनाइट कमांडर की तरह काम करता है और 80 के दशक के पुराने QBasic / Borland मीडिया से मिलता जुलता है।



इसे शुरू करने के लिए, आपको कमांड डालने की जरूरत है जहां डिबगिंग की आवश्यकता है:

  आयात पुडब;  pudb.set_trace ()

डिबगर के अंदर बहुत विन्यास योग्य है (Ctrl + P), और इससे आप IPyon पर डिबग कंसोल में भी जा सकते हैं। यह एक शक्तिशाली पायथन कंसोल है जिसमें आप अपने रिकॉर्ड और कुछ कार्यों को दोहराने के लिए मैक्रो को सब कुछ स्वत: पूर्ण कर सकते हैं, उदाहरण के लिए, डीबगिंग मॉड्यूल।

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

यदि पेज क्रैश हो जाए तो क्या होगा? आमतौर पर, अगर कुछ अस्पष्ट त्रुटि होती है, तो आपको निम्नलिखित कार्य करने की आवश्यकता है:

• संपादक में प्रोग्राम फ़ाइल खोलें, पुडब लाइन डालें
• सर्वर को पुनरारंभ करने के लिए प्रतीक्षा करें (जो एक मोटी परियोजना पर एक लंबा समय लग सकता है)
• ब्राउज़र खोलें, अपडेट पर क्लिक करें
• कंसोल पर जाएं और बहस शुरू करें
• एक त्रुटि मिलने के बाद, आपको फ़ाइल पर लौटने और डीबग लाइन को हटाने की आवश्यकता है

यदि Werkzeug को 5 क्रियाओं के बजाय प्रोजेक्ट में स्थापित किया गया है, तो एक काम करना होगा, क्योंकि यह एप्लिकेशन ब्राउज़र विंडो में मरणोपरांत डिबगिंग कंसोल को सीधे प्रदर्शित करता है। इसके अलावा, कॉल स्टैक के किसी भी स्तर पर! कई समस्याओं के लिए यह काफी पर्याप्त है।

यदि कोड के रूप में यह काम करना चाहिए, पठनीयता के लिए इसे कंघी।

  $ बिन / pep8 my_new_script.py
 'आयात *' बहुत ही खराब शैली है।  पंक्ति २
 अपेक्षित 2 रिक्त रेखाएँ, 1. पंक्ति 5।

एचएएमएल, सास, OOCSS

किसी भी कोड के साथ काम करते समय, हम अक्सर इसे लिखते नहीं हैं, लेकिन इसे पढ़ते हैं। इसलिए, मार्कअप भाषा, जिसे जल्दी से पढ़ा जा सकता है, न कि आईडीई, जिसमें आप जल्दी से लिख सकते हैं, काम को बहुत तेज कर देता है।

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

  - लोड i18n सेक
 % html
     % सर
         % उपाधि
             - ब्लॉक शीर्षक
                 Django में स्पीड डेवलपमेंट

     % शरीर
         # menu.page.oldSchool
             - ब्लॉक मेनू
                 .line.title_bar
                     .unit.size1of2
                         % a.site_logo {'href': "/"} Django में तेजी से विकास
                
                     .unit.size1of2.lastUnit
                         - 'language_selector.haml' शामिल करें
    
         #body
             - ब्लॉक बॉडी

इसे निम्नलिखित दस्तावेज़ में परिवर्तित किया जाता है:

  {% लोड i18n सेक%}
 <Html>
     <Head>
         <Title>
             {% ब्लॉक शीर्षक%}
                 Django में स्पीड डेवलपमेंट
             {% एंडब्लॉक%}
         </ Title>
     </ Head>
     <Body>
         <div id = "menu" class = "page oldSchool">
             {% ब्लॉक मेनू%}
                 <div class = "line title_bar">
                     <div class = "unit size1of2">
                         <a class="site_logo" href="/"> Django में तेज़ विकास </a>
                     </ Div>
                     <div class = "unit size1of2 lastUnit">
                         {% में 'language_selector.haml'% शामिल हैं}
                     </ Div>
                 </ Div>
             {% एंडब्लॉक%}
         </ Div>
    
         <div id = "body">
             {% ब्लॉक बॉडी%}
             {% एंडब्लॉक%}
         </ Div>
     </ Body>
 </ Html>

एक बंद टैग के कारण आपका लेआउट कितनी बार टूट गया? HAML भाषा में कोई बंद टैग नहीं हैं। टैग बंद हो जाता है जहां टैब बंद हो जाता है। इस तरह के दस्तावेज़ को घोंसले के स्तर को संपादित करना और जोड़ना आसान है, और पढ़ने में आसान है - इसमें 1.5 गुना कम लाइनें और एक चौथाई कम पत्र हैं। पात्रों के लिए एकमात्र नुकसान विशेषताओं के लिए JSON है, लेकिन यह एक बड़ा नुकसान नहीं है।

यह परियोजना HamlPy का उपयोग करती है , जिसे लिस्टिंग से देखा जा सकता है, Django टैग और सादे HTML का समर्थन करता है यदि Haml आपके लिए पर्याप्त नहीं है, उदाहरण के लिए:

  <विकल्प {% यदि option.selected%} चयनित {% endif%}> {{विकल्प.वायु}} </ विकल्प>

Haml CSS समकक्ष Sass है । एसएएस परियोजना 2 प्रकार के मार्कअप का समर्थन करती है: एससीएसएस (घुंघराले ब्रेस के साथ सीएसएस का एक एनालॉग) और एसएएसएस (टैब के साथ हैम और पायथन का एक एनालॉग)। मैं बाद के रूप में अधिक संक्षिप्त पसंद करता हूं। सैस से सबसे बड़ा लाभ सभी मालिकाना नियमों का संपीड़न है, जैसे * -लाइनर-ग्रेडिएंट, एक कॉल में:

  @पोर्ट बोर्बन
     .action
         + लीनियर-ग्रेडिएंट (शीर्ष, # 6d33f2 0%, # 54a3ee 50%, # 3690f0 51%, # 1e69de 100%)

यह सभी ढाल कार्यान्वयन (-moz -..., -o -..., -webkit- ... आदि) के साथ एक बड़ी सूची में विस्तार करेगा। मैं यहां एक उदाहरण नहीं देता, लेकिन मैं सिर्फ इतना कहूंगा कि सास भाषा लूप्स और सशर्त ब्लॉकों का समर्थन करती है @ अगर ... और । एक समान कम-सीएसएस परियोजना है, और अगर वांछित है, तो इसे django-कंप्रेसर से भी जोड़ा जा सकता है, लेकिन यह लूप जैसे हेरफेर और तर्कों को पुनर्व्यवस्थित करने की अनुमति नहीं देगा।

शैलियों को एक दूसरे में घोंसला बनाया जा सकता है:

  .class1
         फ़ॉन्ट-वजन: बोल्ड
         > .class2
             फ़ॉन्ट-शैली: इटैलिक

परिणाम:

  .class1 {
         फ़ॉन्ट-वजन: बोल्ड;  }
    
     .class1> .class2 {
         फ़ॉन्ट-शैली: इटैलिक;  }

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

यहां सबसे लोकप्रिय वर्कपीस हैं। तालिकाएँ (HAML मार्कअप में):

  .line
     .unit.size1of3 बाएं कॉलम
     .unit.size1of3 केंद्र स्तंभ
     .unit.size1of3.lastUnit सही कॉलम

"मीडिया ब्लॉक", यानी बाईं तरफ की तस्वीर और वह टेक्स्ट जो दाईं ओर की तस्वीर के आसपास नहीं बहता है:

  .media
     % img.img {'src': '{{message.author.picture.url}}' '} /
     .bd = message.text

एक खाली पृष्ठ टेम्पलेट, कंटेंट ब्लॉक (हेडर, बॉडी और बेस के साथ आयत) भी है। मेरी परियोजना में, OOCSS को एक उप-भंडार के रूप में बनाया गया है, और इसे समय-समय पर GitHub से अपडेट किया जा सकता है ।

क्या जोड़ना है

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

निकट भविष्य में:

• स्थिर लाइब्रेरियों में जावास्क्रिप्ट लाइब्रेरियों को जोड़ें: आवश्यकताएँ, jQuery और बैकबोन (और उप-रिपॉजिटरी के रूप में भी)
• डेटाबेस और अद्यतन "जुड़नार" डाउनलोड करने वाले एक पुनर्निर्माण डीबी एप्लिकेशन को जोड़ें, जो सिंकबेक नहीं कर सकता
• TemplateFlakes एप्लिकेशन, टेम्प्लेट का एक स्थिर विश्लेषक, लोड और उपयोग किए गए टैग
• नमूना टेम्पलेट्स
• परिशिष्ट : लेख के प्रकाशन से पहले लेखन से एक सप्ताह, बिन / बिल्डआउट वेबफिकेशन कमांड जोड़ा गया था, जो WSGI स्क्रिप्ट को स्थापित करता है ताकि परियोजना उसी नाम की मेजबानी पर काम करे।

मुझे समीक्षा करने, परियोजना को कांटा करने, विलय के लिए अनुरोध भेजने में खुशी होगी।

परिशिष्ट: बकेटबिट पर , उन्होंने तीसरे पक्ष के घटकों को स्थापित करने के लिए निर्देश जोड़ने के लिए कहा। मैं जवाब देता हूं: आपको मैन्युअल रूप से तृतीय-पक्ष घटक स्थापित करने की आवश्यकता नहीं है। SASS, Pyflakes और अन्य एप्लिकेशन बिल्डआउट स्थापित करेंगे।