मेगा-फ्लास्क ट्यूटोरियल, भाग 1: "हैलो वर्ल्ड!"

यह एक श्रृंखला का पहला लेख है जहां मैं फ्लास्क माइक्रोफ्रामवर्क का उपयोग करते हुए पायथन वेब एप्लिकेशन लिखने के अपने अनुभव का दस्तावेजीकरण करूंगा।

यहाँ श्रृंखला में सभी लेखों की एक सूची दी गई है:
भाग 1: हैलो वर्ल्ड!
भाग 2: टेम्पलेट
भाग 3: प्रपत्र
भाग 4: डेटाबेस
भाग 5: उपयोगकर्ता लॉगिन
भाग 6: प्रोफाइल पेज और अवतार
भाग 7: यूनिट परीक्षण
भाग 8: अनुयायी, संपर्क और मित्र
भाग 9: अंकुरण
भाग 10: पूर्ण पाठ खोज
भाग 11: ईमेल समर्थन
भाग 12: पुनर्निर्माण
भाग 13: तिथि और समय
भाग 14: I18n और L10n
भाग 15: अजाक्स
भाग 16: डिबगिंग, परीक्षण और प्रोफाइलिंग
भाग 17: लिनक्स (यहां तक ​​कि रास्पबेरी पाई पर भी तैनात हैं!)
भाग 18: हरोकू क्लाउड पर तैनाती

मेरी पृष्ठभूमि

मैं कई भाषाओं में जटिल एप्लिकेशन विकसित करने के दो-अंकों के वर्षों के अनुभव वाला एक सॉफ्टवेयर डेवलपर हूं। मैंने पहली बार काम पर C ++ लाइब्रेरी में बाइंडिंग बनाने के लिए पायथन से मुलाकात की। पायथन के अलावा, मैंने PHP, रूबी, स्मॉलटाक में वेब एप्लिकेशन लिखे और, विश्वास करें कि यह C ++ में भी है या नहीं। इस सब से, मुझे पायथन / फ्लास्क संयोजन सबसे अधिक लचीला लगता है।

आवेदन

इस गाइड के हिस्से के रूप में मैं जिस एप्लिकेशन को विकसित करने जा रहा हूं वह माइक्रोब्लॉग सर्वर है, और मैंने इसे माइक्रोब्लॉग कहने का फैसला किया। सुंदर रचनात्मक, मुझे पता है।

हमारी प्रगति के दौरान, मैं निम्नलिखित विषयों को शामिल करूंगा:

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

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

आवश्यकताओं

यदि आपका कंप्यूटर पायथन 2.6 / 2.7 का समर्थन करता है, तो शायद सब कुछ ठीक हो जाएगा। मैनुअल से एप्लिकेशन को विंडोज, ओएस एक्स और लिनक्स पर ठीक काम करना चाहिए।

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

अंत में, आपको पायथन कोड लिखने के लिए स्वतंत्र महसूस करना चाहिए। इस भाषा के मॉड्यूल और पैकेज के साथ परिचित भी चोट नहीं करता है।

फ्लास्क स्थापित करें

ठीक है, चलो शुरू हो जाओ!
यदि आपने अभी तक पायथन 2.7 स्थापित नहीं किया है, तो इसे यहां से ले जाएं।

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

इसलिए, टर्मिनल खोलें, उस जगह का चयन करें जहां आपका आवेदन होगा, और एक नया फ़ोल्डर बनाएं जिसमें यह निहित होगा। आइए इस microblog फोल्डर को कहते हैं।

इसके बाद, virtualenv.py डाउनलोड करें और इसे एक नए फ़ोल्डर में डालें।

नया वातावरण बनाने के लिए, निम्न कमांड दर्ज करें:

 python virtualenv.py flask 

यह कमांड flask फ़ोल्डर के अंदर एक पूर्ण पायथन वातावरण बनाएगा

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

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

यदि आप एक Linux, OS x, या Cygwin उपयोगकर्ता हैं, तो एक-एक करके निम्नलिखित कमांड दर्ज करके फ्लास्क और एक्सटेंशन स्थापित करें:

यदि आप एक Windows उपयोगकर्ता हैं, तो कमांड थोड़े अलग हैं:

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

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

 flask\Scripts\pip install --no-deps lamson chardet flask-mail 

मैं विवरण में नहीं जाऊंगा, इसलिए यदि आप अधिक जानना चाहते हैं, तो फ्लास्क-मेल के लिए प्रलेखन पढ़ें।

यदि सभी पैकेजों की स्थापना सफल रही, तो आप virtualenv.py को हटा सकते हैं क्योंकि अब हमें फ़ाइल की आवश्यकता नहीं है।

"नमस्ते विश्व!" फ्लास्क में

अब आपके पास आपके microblog फ़ोल्डर में flask सबफ़ोल्डर है जिसमें एक्सटेंशन के साथ पायथन दुभाषिया और फ्लास्क फ्रेमवर्क है जिसे हम इस एप्लिकेशन में उपयोग करेंगे। यह हमारी पहली वेब एप्लिकेशन लिखने का समय है!

microblog फ़ोल्डर को स्थानांतरित करने के बाद, आइए हमारे एप्लिकेशन के लिए मुख्य फ़ोल्डर संरचना बनाएं:

 mkdir app mkdir app/static mkdir app/templates mkdir tmp 

हम अपने एप्लिकेशन को app फ़ोल्डर में रखेंगे। static सबफ़ोल्डर को स्टैटिक्स, जैसे चित्रों, जावास्क्रिप्ट फ़ाइलों और स्टाइल शीटों को संग्रहीत करने की आवश्यकता होती है। templates सबफ़ोल्डर स्पष्ट रूप से हमारे टेम्पलेट्स को संग्रहीत करने के लिए अभिप्रेत है।

आइए हमारे app पैकेज ( app/__init__.py ) के लिए एक साधारण इनिशियलाइज़ेशन स्क्रिप्ट बनाकर शुरू करें

 from flask import Flask app = Flask(__name__) from app import views 

ऊपर की स्क्रिप्ट बस एक एप्लिकेशन ऑब्जेक्ट ( Flask से विरासत में मिली) बनाती है, फिर व्यू मॉड्यूल आयात करती है, जिसे हमने अभी तक नहीं लिखा है।

दृश्य हैंडलर हैं जो वेब ब्राउज़र अनुरोधों का जवाब देते हैं। फ्लास्क में दृश्य पायथन कार्यों के रूप में लिखे गए हैं। प्रत्येक दृश्य एक या अधिक URL अनुरोधों के लिए फ़ंक्शन मैप करता है।

हम अपना पहला व्यू फंक्शन (फ़ाइल app/views.py ) लिखेंगे

 from app import app @app.route('/') @app.route('/index') def index(): return "Hello, World!" 

यह एक बहुत ही सरल प्रतिनिधित्व है जो केवल उपयोगकर्ता ब्राउज़र में प्रदर्शित करने के लिए एक स्ट्रिंग देता है। दो route सज्जाकार इस फ़ंक्शन route पते / और /index को route ।

पूरी तरह से काम करने वाले वेब एप्लिकेशन को प्राप्त करने का अंतिम चरण एक स्क्रिप्ट बनाना है जो हमारे एप्लिकेशन के वेब सर्वर को शुरू करता है। आइए run.py स्क्रिप्ट को कॉल करें और इसे रूट डायरेक्टरी ( microblog/ ) में डालें:

 #!flask/bin/python from app import app app.run(debug = True) 

स्क्रिप्ट बस हमारे app पैकेज से app वैरिएबल आयात करती है और सर्वर शुरू करने के लिए run विधि को कॉल करती है। याद रखें कि app वेरिएबल Flask क्लास का एक उदाहरण है, हमने इसे ऊपर बनाया है।

अपना एप्लिकेशन चलाने के लिए, बस स्क्रिप्ट चलाएं। OS X, Linux, और Cygwin पर, आपको फ़ाइल को चलाने से पहले निष्पादन योग्य चिह्नित करना चाहिए।

 chmod a+x run.py 

फिर स्क्रिप्ट को बस कहा जा सकता है:

 ./run.py 

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

 flask/Scripts/python run.py 

शुरू करने के बाद, सर्वर पोर्ट 5000 पर सुनेगा, कनेक्शन की प्रतीक्षा कर रहा है। अब ब्राउज़र खोलें और पता बार में निम्न URL दर्ज करें:



या आप इस लिंक का उपयोग कर सकते हैं:

 http://localhost:5000/index 

अब क्या आप कार्रवाई में रूटिंग देखते हैं? पहला URL / से बँधा है, जबकि दूसरा /index । दोनों मार्ग हमारे दृश्य फ़ंक्शन से जुड़े हैं, इसलिए वे एक ही परिणाम देते हैं। यदि आप किसी अन्य मार्ग से प्रवेश करते हैं, तो आपको एक त्रुटि मिलेगी, क्योंकि केवल ये दोनों ही प्रस्तुति समारोह के लिए बाध्य थे।

जब आप सर्वर के साथ खेल रहे होते हैं तो आप इसे रोकने के लिए सिर्फ Ctrl-C दबा सकते हैं।

और इसके साथ मैं इस गाइड के पहले भाग को समाप्त करना चाहता हूं।

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

माइक्रोब्लॉग-0.1 . zip डाउनलोड करें।

कृपया ध्यान दें कि ऊपर दिए गए संग्रह से एप्लिकेशन को चलाने के लिए आपको फ्लास्क स्थापित करने की आवश्यकता है।

आगे क्या है

श्रृंखला के अगले भाग में, हम HTML टेम्पलेट्स का उपयोग करने के लिए अपने छोटे से एप्लिकेशन को बदल देंगे।

आशा है कि आप अगले भाग में देख सकते हैं।

मिगुएल