परिचय

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

मैंने देखा कि रूसी में फ्लास्क-पॉशन के बारे में लगभग कुछ भी नहीं है, लेकिन मुझे लगता है कि यह रूपरेखा कुछ दिलचस्प लग सकती है।

इस रूपरेखा पर एक सरल समीक्षा लेख के बजाय, मैंने फ्लास्क-पोशन पर आधारित फुरफुर पुस्तकालय के लिए एक नियंत्रण प्रणाली बनाने पर कई लेख लिखने का फैसला किया।

इस प्रणाली को निम्नलिखित करने में सक्षम होना चाहिए:

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

इस प्रणाली में हम निम्नलिखित उपकरणों का उपयोग करेंगे:

• PostgreSQL
• फ्लास्क, फ्लास्क-एसक्यूएलकेमी, फ्लास्क-जेडडब्ल्यूटी, फ्लास्क-पॉशन, फ्लास्क-माइग्रेट

ट्रेनिंग

कंकाल

स्वयं परियोजना के लिए कंकाल को इकट्ठा न करने के लिए, हम Valefor cookiecutter- टेम्पलेट का उपयोग करेंगे, जिसमें उपरोक्त सभी निर्भरताएं और इससे भी अधिक शामिल हैं।

cookiecutter gh:lemegetonx/valefor 

इस टेम्पलेट में दो अनुप्रयोग शामिल हैं:

1. ऐप मुख्य चीज है। इसमें jwt के लिए हैंडलर फंक्शन, पोशन रिसोर्सेज के लिए मिक्सिन क्लासेस और sqlalchemy मॉडल के साथ-साथ एप्लिकेशन के लिए कॉन्फ़िगरेशन के साथ एक पैकेज शामिल है।
2. उपयोगकर्ता - टेम्पलेट की शुरुआत में, केवल उपयोगकर्ता मॉडल होता है।

निर्भरता स्थापना

टेम्पलेट निर्भरता को हल करने के लिए कविता का उपयोग करता है, लेकिन हाल ही में पाइप भी pyproject.toml का समर्थन करता है, इसलिए पसंद आपकी है। मैं कविता का लाभ उठाऊंगा।

 poetry install 

विन्यास

सरलीकृत कॉन्फ़िगरेशन के लिए, टेम्पलेट साइट्री लाइब्रेरी का उपयोग करता है। हमें साइट्री ऑब्जेक्ट की सेटिंग को थोड़ा संशोधित करने की आवश्यकता होगी।

1. एप्लिकेशन / कॉन्‍फ़िगर / प्रोवाइडर को बदलें। हम SystemCredentialProvider को YamlCredentialProvider से बदल देंगे ताकि थर्ड-पार्टी सिस्टम के लिए प्राधिकरण डेटा क्रेडेंशियल से लिया जा सके। फाइल, जिसे हम कमिट में नहीं जोड़ेंगे:

 from sitri import Sitri from sitri.contrib.yaml import YamlConfigProvider, YamlCredentialProvider configuration = Sitri( config_provider=YamlConfigProvider(yaml_path="./config.yaml"), credential_provider=YamlCredentialProvider(yaml_path="./credential.yaml"), ) 

वास्तव में यहां क्या हो रहा है, इसके बारे में अधिक पीएस प्रलेखन में पढ़ना आसान है, संक्षेप में, अब हम केवल यह निर्धारित करते हैं कि हमें कॉन्फ़िगरेशन और प्राधिकरण के लिए डेटा कहां मिलेगा।

1. चूंकि हमने अनिवार्य रूप से एक ही प्रदाता बनाया है, इसलिए डेटाबेस_में डॉट्स के साथ get_credential कॉल में कुंजियों में अंडरस्कोर को बदलना बेहतर है।

 DB_NAME = configuration.get_credential("db.name", path_mode=True) DB_HOST = configuration.get_credential("db.host", path_mode=True) DB_PASSWORD = configuration.get_credential("db.user.password", path_mode=True) DB_PORT = configuration.get_credential("db.port", path_mode=True) DB_USER = configuration.get_credential("db.user.name", path_mode=True) 

तो, config.yaml फ़ाइल पहले से ही टेम्प्लेट में थी, लेकिन क्रेडेंशियल .yaml को स्वयं लिखा जाना चाहिए। वास्तविक जीवन में, ऐसी फाइलों को आवश्यक रूप से .gitignore में जोड़ा जाता है, लेकिन मैं रिपॉजिटरी में क्रेडेंशियल.यम्ल टेम्पलेट जोड़ूंगा ताकि इसकी संरचना किसी को भी समझ में आ जाए जो परियोजना में जाता है।

आधार क्रेडेंशियल

 db: name: furfur_db host: localhost port: 5432 user: password: passwd name: admin 

डेटाबेस

हमारी तैयारी का अगला चरण DBMS की तैनाती है, इस मामले में PostgreSQL। सुविधा के लिए, मैं एक स्टैक बनाऊंगा। श्याम फाइल जहां मैं पोस्टग्रेज कंटेनर के लॉन्च के बारे में बताऊंगा जिसकी हमें जरूरत है।

 version: '3.1' services: db: image: postgres restart: always environment: POSTGRES_PASSWORD: passwd POSTGRES_USER: admin POSTGRES_DB: furfur_db ports: - 5432:5432 

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

परियोजना के मूल में होने के नाते, हम निम्नलिखित कमांड निष्पादित करते हैं:

 export FLASK_APP=furfur.app flask db init flask db migrate flask db upgrade 

सब कुछ, डेटाबेस की तैयारी के साथ-साथ हमारे सिस्टम के लिए सामान्य आधार, हम कर रहे हैं।

आगे क्या है?

अगले भाग में, हम एक सरल भूमिका प्रणाली और जेडब्ल्यूटी प्रमाणीकरण को व्यवस्थित करने के तरीके के बारे में बात करेंगे।

प्रोजेक्ट रिपोजिटरी: https://github.com/Egnod/furfur
इस भाग में जो कुछ भी कहा गया है: https://github.com/Egnod/furfur/releases/tag/0.0.2