मैं अपनी मोहरबंद "बाइक" के साथ एपीआई का विकास और परीक्षण कैसे करूं

पीटीओ जॉन्स एपीआई HTTP JSON के स्वत: परीक्षण के लिए स्क्रिप्ट लिखने के लिए एक सरल भाषा है।

PieceofScript आपको अनुमति देता है:

• लगभग एक प्राकृतिक भाषा में विधि के नाम के साथ YAML प्रारूप में एपीआई विधियों का वर्णन करें, जो पढ़ने के परीक्षण के लिए सुविधाजनक है
• YAML प्रारूप में मॉडल का वर्णन करने और उनसे यादृच्छिक डेटा उत्पन्न करने के लिए पर्याप्त लचीला
• सरल वाक्य रचना के साथ आसानी से पढ़ने वाली भाषा में जटिल एपीआई कॉल स्क्रिप्ट लिखें
• JUnit और HTML प्रारूपों में परीक्षा परिणाम प्राप्त करें

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

यहाँ क्या यह आया है।



दुभाषिया PHP में लिखा गया है और एक फ़ार संग्रह है, इसे संस्करण PHP 7.2 की आवश्यकता है, हालांकि यह 7.1 पर भी काम कर सकता है। स्रोत कोड और प्रलेखन https://github.com/maximw/PhewofScript विकास में प्रलेखन। यह, जैसा कि यह निकला, सबसे कठिन और थकाऊ हिस्सा है।

परीक्षण परियोजना, इसकी संरचना और प्रक्षेपण
टेस्ट स्क्रिप्ट
एपीआई टेस्ट के तरीके
एपीआई विधि कॉल
मॉडल और परीक्षण डेटा की पीढ़ी
अंतर्निहित कार्य
परीक्षण के मामले
चर और क्षेत्र
प्रकार और संचालन
रन के बीच डेटा की बचत
स्टडआउट और रिपोर्ट के लिए आउटपुट
उदाहरण - पर्याप्त शब्द, कोड दिखाएं!
भविष्य के लिए टिप्पणियां और योजनाएं, यदि कोई हो

परीक्षण परियोजना, इसकी संरचना और प्रक्षेपण

परियोजना स्क्रिप्ट फ़ाइलों, एपीआई विधि विवरण फ़ाइलों और परीक्षण डेटा जनरेटर के सेट के साथ एक निर्देशिका है।

न्यूनतम संस्करण में, परियोजना इस तरह दिखती है:

./tests endpoints.yaml -  API generators.yaml -  start.pos -    

स्टार्टअप फाइल वह स्क्रिप्ट है जिसमें से परीक्षण की प्रक्रिया शुरू होती है। यह स्टार्टअप पर सेट है:

 pos.phar run ./start.pos --junit=junit_report.xml -vvv --config=config.yaml 

सभी रिश्तेदार पथ काम करने वाली निर्देशिका से आरंभिक फ़ाइल से पढ़े जाते हैं।
कॉन्फ़िगरेशन फ़ाइल को कमांड लाइन पर विकल्प --config के साथ निर्दिष्ट किया जा सकता है या कार्यशील निर्देशिका में config.yaml रखा जा सकता है। कॉन्फ़िगरेशन वैकल्पिक है, आपको आवश्यकतानुसार वहां चढ़ने की आवश्यकता है। विन्यास के बारे में अधिक ।

टेस्ट स्क्रिप्ट

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

यहां एक काल्पनिक मंच के लिए एक सरल स्क्रिप्ट उदाहरण है जहां विभिन्न उपयोगकर्ताओं द्वारा एक पोस्ट बनाने और पढ़ने का परीक्षण किया जाता है।

 require "./globals.pos" //    ,  $domain include "./globals_local.pos" //     ,    include "./user/*.pos" //       ./user  ./post include "./post/*.pos" //       var $author = User() var $reader = User() var $banned = User() var $post = Post() Register $author //   API,     must $response.code == 201 //     Register $reader must $response.code == 201 Register $banned must $response.code == 201 Add $banned to blacklist of $author //$banned      $author Create post $post by $author //   API   must $response.code == 201 //    API   201 // ...,   ,       assert $response.body.post.content == $post.content var $postId = $response.body.post.id // Id     Read post $postId by $author //     must $response.code == 200 assert $response.body.post.content == $post.content Read post $postId by $reader //      must $response.code == 200 assert $response.body.post.content == $post.content Read post $postId by $banned //        assert $response.code == 404 

हां, यह बैकलाइटिंग के बिना बहुत अच्छा नहीं लगता है।

स्क्रिप्ट की प्रत्येक पंक्ति एक ऑपरेटर से शुरू होती है, या एपीआई पद्धति के लिए एक कॉल है। यदि अचानक एपीआई विधि का नाम एक ऐसे शब्द से शुरू होता है जो किसी एक ऑपरेटर से मेल खाता है, तो आप " > " प्रतीक का उपयोग कर सकते हैं:

 >Include $user to group $userGroup 

ऑपरेटर्स केस असंवेदनशील हैं। मुखर, ASSERT या aSsErT (लेकिन ऐसा क्यों लिखें?) काम करेगा।
प्रत्येक स्टेटमेंट या एपीआई विधि कॉल एक अलग लाइन पर होनी चाहिए। यदि स्ट्रिंग का अंतिम वर्ण \ (हैलो, पायथन) है तो लाइन रैपिंग भी संभव है।

ऑपरेटरों की पूरी सूची

फ़ाइलनाम की आवश्यकता है - फ़ाइल को उस स्थान से संलग्न करें जहां ऑपरेटर कहा जाता है। संलग्न फाइल तुरंत पहली पंक्ति से शुरू होगी। पूरा होने पर, दुभाषिया स्रोत फ़ाइल की अगली पंक्ति में लौटता है। यदि अनुरोधित फ़ाइल पठनीय नहीं है, तो एक त्रुटि उत्पन्न होगी। सापेक्ष पथ की गणना कार्यशील निर्देशिका से की जाती है।

फ़ाइलमास्क को शामिल करें - आवश्यकता के समान, लेकिन यदि अनुरोधित फ़ाइल पढ़ने योग्य नहीं है, तो कोई त्रुटि नहीं होगी। यह सुविधाजनक है, उदाहरण के लिए, विभिन्न परीक्षण वातावरणों के लिए सेटिंग्स बनाने के लिए। इसके अलावा, शामिल एक ही बार में मुखौटा द्वारा सभी फ़ाइलों को कनेक्ट कर सकते हैं। इसलिए, उदाहरण के लिए, आप परीक्षण मामलों वाली फ़ाइलों की संपूर्ण निर्देशिकाओं को डाउनलोड कर सकते हैं। लेकिन एक ही समय में, फ़ाइलों को डाउनलोड करने के किसी भी आदेश की गारंटी नहीं है।

var $ चर 1 = अभिव्यक्ति 1 ; $ चर 2 = अभिव्यक्ति 2 ; ...; $ चर = अभिव्यक्तिएन - चर के लिए मान असाइन करें। यदि चर पहले से मौजूद नहीं है, तो इसे वर्तमान संदर्भ में बनाया जाएगा।

$ चर 1 = अभिव्यक्ति 1 दें ; $ चर 2 = अभिव्यक्ति 2 ; ...; $ चर = अभिव्यक्तिएन - चर के लिए मान असाइन करें। यदि चर वर्तमान संदर्भ में नहीं है, तो वैश्विक संदर्भ में चर को बनाने या संशोधित करने का प्रयास होगा।

const $ const1 = अभिव्यक्ति 1 ; $ const2 = अभिव्यक्ति 2 ; ...; $ constN = अभिव्यक्तिएन - वर्तमान संदर्भ में स्थिरांक का मान निर्धारित करें। स्थिरांक और चर के बीच का अंतर केवल इतना है कि उन्हें बदला नहीं जा सकता है; जब आप किसी मूल्य को स्थिर करने की कोशिश करते हैं, तो घोषणा के बाद एक चेतावनी जारी की जाएगी। यदि पहले से ही समान नाम वाला कोई चर है, तो इसे स्थिर घोषित करने का प्रयास करते समय एक त्रुटि उत्पन्न होगी। अन्यथा, चर के लिए सच है कि सब कुछ भी स्थिरांक के लिए सच है।

आयात $ चर 1 ; $ चर 2 ; ...; $ variableN - वैश्विक संदर्भों से वर्तमान संदर्भ के लिए चर की प्रतियां। यह उपयोगी हो सकता है यदि आपको एक वैश्विक चर के मूल्य पर काम करना है, लेकिन इसे बदलना नहीं है।

testcase testCaseName - एक परीक्षण मामले की घोषणा करता है, जिसे बाद में रन स्टेटमेंट के साथ एक इकाई कहा जा सकता है। बाद में लेख में परीक्षण के मामलों के बारे में और पढ़ें ।

अभिव्यक्ति की अभिव्यक्ति - जाँच करें कि अभिव्यक्ति सत्य है , अन्यथा विफल परीक्षण के बारे में एक रिपोर्ट मुद्रित करें।

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

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

जबकि अभिव्यक्ति - एक लूप, जबकि अभिव्यक्ति सही है, कथन को अधिक से अधिक इंडेंटेड लाइनों के साथ निष्पादित करता है।

$ सरणी ; $ तत्व - सरणी के माध्यम से लूप, सरणी के प्रत्येक अगले तत्व के लिए लूप बॉडी निष्पादित की जाती है। यह कुंजी foreach $ array प्राप्त करना भी संभव है ; $ कुंजी ; $ तत्व । मौजूदा संदर्भ में $ कुंजी और $ तत्व चर बनाए गए हैं / ओवरराइट किए गए हैं।

अगर अभिव्यक्ति - अगर अभिव्यक्ति सच है, तो अगर से अधिक इंडेंटेड लाइनों के साथ बयान निष्पादित करता है

प्रिंट अभिव्यक्ति 1 ; एक्सप्रेशन 2 ; ... एक्सप्रेशन एन - एक्सप्रेशन के मान को प्रिंटआउट में प्रिंट करें। यह डिबगिंग के लिए इस्तेमाल किया जा सकता है, यह केवल " बातूनीपन " के स्तर के साथ काम करता है --verbosity = 1 या -v और अधिक।

नींद की अभिव्यक्ति - किसी दिए गए नंबर के लिए रुकें, वैकल्पिक रूप से एक पूर्णांक, सेकंड। कभी-कभी आपको परीक्षित एपीआई को ब्रेक देने की आवश्यकता होती है।

ठहराव अभिव्यक्ति - इंटरेक्टिव मोड में नहीं (कमांड लाइन विकल्प -n ) सोने के समान है। अभिव्यक्ति वैकल्पिक है, इस मामले में कोई विराम नहीं होगा। और इंटरेक्टिव मोड में, एंटर दबाने से पहले रुकें।

रद्द - अंत परीक्षण। दुभाषिया काम खत्म करता है, रिपोर्ट बनाता है।

एपीआई टेस्ट के तरीके

यह वास्तव में आपको परीक्षण करने की आवश्यकता है - कुछ मापदंडों के साथ कॉल करें और जांचें कि उत्तर उम्मीदों पर खरा उतरता है या नहीं।

एपीआई तरीकों को YAML प्रारूप में वर्णित किया गया है। डिफ़ॉल्ट रूप से, विवरण वर्तमान निर्देशिका की एंडपॉइंट.यूमल फ़ाइल और /। या .yam फ़ाइलों में इसकी ./endpoints उपनिर्देशिका में होना चाहिए। परीक्षण से पहले, दुभाषिया इन सभी फाइलों को एक साथ पढ़ने की कोशिश करेगा।

उदाहरण समापन बिंदु। श्याम संरचना:

 Auth $user: method: "POST" url: $domain + "/login" headers: Content-Type: "application/json" format: "json" data: login: $user.login password: $user.password after: - assert $response.code == 200 - let $user.auth_token = $response.body.auth_token Create post $post by $user: method: "POST" url: $domain + "/posts" format: "json" data: $post headers: auth: "Bearer " + $user.auth_token content-type: "application/json" after: - assert $response.code == 201 Read post $postId by $user: method: "GET" url: $domain + "/posts/" + $postId headers: auth: "Bearer " + $user.auth_token content-type: "application/json" after: - assert ($response.code == 200) || ($response.code == 404) Create comment $comment on $post by $user: method: "POST" url: $domain + "/comments/create/" + $post.id format: "json" data: $comment headers: auth: "Bearer " + $user.auth_token content-type: "application/json" after: - assert $response.code == 201 

एपीआई विधि (YAML संरचना का शीर्ष स्तर) जिसके द्वारा इसे कहा जा सकता है लगभग एक मनमाने प्रारूप में एक स्ट्रिंग है।

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

इसके अलावा, नाम में कहीं भी आप डबल घुंघराले ब्रैकेट में वैकल्पिक विधि मान निर्दिष्ट कर सकते हैं।

 Get comments of $post {{$page=1; $perPage=$defaultGlobalPageSize}}: method: "GET" url: $domain + "/comments/" + $post.id query: page: $page per_page: $perPage headers: auth: "Bearer " + $user.auth_token content-type: "application/json" after: - assert $response.code == 200 

वैकल्पिक मान निर्दिष्ट करने वाले अभिव्यक्तियों में, वैश्विक संदर्भ चर उपलब्ध हैं।
वैकल्पिक मूल्य उपयोगी हो सकते हैं ताकि आप हर बार एपीआई पद्धति को कॉल करने के लिए उन्हें निर्दिष्ट न करें। यदि पृष्ठ का आकार केवल एक ही स्थान पर बदलने की आवश्यकता है, तो इसे अन्य सभी स्थानों पर क्यों इंगित करें? इस पद्धति के लिए कॉल के उदाहरण:

 Get comments of $newPost //     $page  $perPage Get comments of $newPost {{$page=$currentPage+1}} Get comments of {$newPost} {{$perPage=10;$page=100}} 

उपयोग किए गए शेष चर (उपरोक्त उदाहरण में $ डोमेन ) को वैश्विक संदर्भ से लिया जाएगा। मैं आपको बाद में संदर्भों के बारे में अधिक बताऊंगा।

यह मुझे लगता है कि एपीआई तरीकों को एक प्राकृतिक भाषा में मानव-पठनीय नाम देना सुविधाजनक है, फिर परीक्षण स्क्रिप्ट को पढ़ना आसान है। नाम केस-असंवेदनशील हैं, अर्थात, प्रामाणिक $ उपयोगकर्ता विधि को $ $ उपयोगकर्ता और AUTH $ उपयोगकर्ता के रूप में कहा जा सकता है। हालांकि, चर नाम केस-संवेदी हैं, नीचे चर के बारे में अधिक।

महत्वपूर्ण नोट। YAML प्रारूप आपको उद्धरण चिह्नों में तार संलग्न नहीं करने देता है। लेकिन दुभाषिया के लिए, उद्धरण के बिना एक स्ट्रिंग एक अभिव्यक्ति है जिसका मूल्यांकन करने की आवश्यकता है। उदाहरण के लिए, एक url: http://example.com/login घोषणा url: http://example.com/login फ़ील्ड में निष्पादन के दौरान एक सिंटैक्स त्रुटि होगी। इसलिए, यह सही होगा: url: "http://example.com/login" या url: "http://"+$domain+"/login"

एपीआई विधि विवरण फ़ील्ड

विधि - आवश्यक HTTP विधि

url - वास्तविक URL, आवश्यक

हेडर - HTTP हेडर की सूची, वैकल्पिक

कुकीज़ - वैकल्पिक कुकी सूची

HTTP - HTTP प्रमाणीकरण के लिए डेटा, वैकल्पिक

 auth: login: $login password: $password type: "basic" //  "digest"  "ntlm", - "basic" 

क्वेरी - URL मापदंडों की एक सूची, वैकल्पिक

प्रारूप - मूल्यों में से एक:

• कोई नहीं - अनुरोध का कोई शरीर नहीं है
• json - JSON को भेजें
• कच्चे - स्ट्रिंग भेजें "जैसा है"
• फॉर्म - आवेदन / x-www-form-urlencoded प्रारूप में
• मल्टीपार्ट - मल्टीपार्ट / फॉर्म-डेटा फॉर्मेट में

वैकल्पिक, डिफ़ॉल्ट कोई नहीं

डेटा - अनुरोध निकाय, प्रारूप में निर्दिष्ट प्रारूप में भेजा जाएगा, वैकल्पिक

• किसी के लिए भी - डेटा प्रारूप अनुपस्थित हो सकता है, यदि मौजूद है, तो उसे अनदेखा किया जाएगा
• Json प्रारूप के लिए, कोई भी मूल्य
• कच्चे प्रारूप के लिए, कोई भी स्केलर मान
• प्रपत्र प्रारूप के लिए, एक सरणी जिसका कुंजी क्षेत्र नाम हैं:
  
  

   data: login: "Bob" password: $password remember_me: 1 

• मल्टीपार्ट प्रारूप के लिए, निम्न संरचना की एक सरणी:
  
  

   data: user_id: value: 42 headers: X-Baz: "bar" avatar: file: "/path/to/file" photo: file: "http://url.to/file" filename: "custom_filename.jpg" 

फ़ाइल फ़ील्ड में निर्दिष्ट फ़ाइलें पढ़ने योग्य होनी चाहिए। यदि कोई URL निर्दिष्ट किया गया है, तो php.ini में allow_url_fopen को सक्षम किया जाना चाहिए

पहले - बयान जो HTTP अनुरोध, वैकल्पिक से पहले निष्पादित किए जाएंगे

के बाद - बयान जो HTTP अनुरोध, वैकल्पिक के बाद निष्पादित किया जाएगा

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

एपीआई विधि कॉल

स्क्रिप्ट में एपीआई विधि को कॉल करने के लिए, यदि आवश्यक हो, तो आपको इसका नाम और पैरामीटर निर्दिष्ट करने की आवश्यकता है। यहाँ ऊपर दिए गए विवरण से अंतिम एपीआई विधि को कॉल करने का एक उदाहरण है:

 Create comment $comments.1 on {$newPost} by {$postAuthor} 

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

 Create comment {$comments[$i]} on $posts.0 by $users.1 Read post {123} by $user Get comments of $users.1.id {{$page = 2}} 

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

$ अनुरोध संरचना

$ request.method - स्ट्रिंग - HTTP विधि
$ request.url - स्ट्रिंग - अनुरोधित URL
$ request.query - सरणी - GET मापदंडों की एक सूची
$ request.headers - ऐरे - अनुरोध हेडर की सूची
$ request.cookies - सरणी - कुकीज़ सूची
$ reuqest.auth - Array या Null - HTTP प्रमाणीकरण के लिए डेटा
$ request.format - स्ट्रिंग - अनुरोध डेटा प्रारूप
$ request.data - किसी भी प्रकार - डेटा क्षेत्र में गणना की गई थी

$ प्रतिक्रिया संरचना

$ response.network - बूलियन - गलत अगर त्रुटि HTTP के नीचे नेटवर्क स्तर पर थी
$ response.code - संख्या या अशक्त - प्रतिक्रिया कोड, उदाहरण के लिए, 200 या 404
$ response.status - स्ट्रिंग या अशक्त - प्रतिक्रिया की स्थिति, उदाहरण के लिए, "204 कोई सामग्री नहीं" या "401 अनधिकृत"
$ response.headers - सरणी - प्रतिक्रिया हेडर की सूची, हेडर के नाम लोअरकेस हैं
$ response.cookies - सरणी - कुकीज़ सूची
$ response.body - किसी भी प्रकार - प्रतिक्रिया निकाय को JSON के रूप में संसाधित किया गया है, अगर पार्स करने के दौरान कोई त्रुटि थी, तो शरीर तत्व बिल्कुल मौजूद नहीं होगा: @response.body == null ( चर के अस्तित्व की जाँच के बारे में )
$ response.raw - स्ट्रिंग या नल - कच्ची प्रतिक्रिया शरीर
$ response.duration - संख्या लिखें - सेकंड में अनुरोध की अवधि

मॉडल और परीक्षण डेटा की पीढ़ी

जनरेटर का उपयोग मॉडल का वर्णन करने और उनसे परीक्षण डेटा उत्पन्न करने के लिए किया जाता है। YAML प्रारूप में विवरण जनरेटरों में होना चाहिए। वर्किंग डायरेक्टरी और / या * .yaml फाइलों में ./generators उपनिर्देशिका में फ़ाइल।

 User: body: login: Faker\login() name: Faker\name() email: Faker\email() password: Faker\text(16) child: Child() birthday: dateFormat(Faker\datetime(), "U") settings: notifications_enabled: Faker\boolean() Child: body: name: Faker\name() gender: Faker\integer(1, 2) age: Faker\integer(0, 18) Comment($user): body: content: "Hi! I'm " + $user.name tags: - "tag1" - "tag2" 

उपरोक्त उदाहरण में, तीन जनरेटर उपयोगकर्ता () , बाल (), और टिप्पणी () घोषित किए गए हैं। इस मामले में, उत्तरार्द्ध में तर्क $ उपयोगकर्ता है और उत्पन्न करते समय इस डेटा का उपयोग कर सकते हैं। जनरेटर के तर्क हमेशा मूल्य द्वारा पारित किए जाते हैं। इसके अलावा, उदाहरण कई और अधिक निर्मित कार्यों का उपयोग करता है: Faker \ name () , Faker \ email () , dateFormat () , आदि। अंतर्निहित कार्यों पर अनुभाग ।

उपर्युक्त उदाहरण से उपयोगकर्ता () जनरेटर को कॉल करते समय, एक संरचना उत्पन्न होगी जो कि JSON में इस तरह दिखाई देती है:

 { "login": "fgadrkq", "name": "Lucy Cechtelar", "email": "tkshlerin@collins.com", "password": "gbnaueyaaf", "child": { "name": "Adaline Reichel", "gender": 2, "age": 12 }, "birthday": 318038400, "settings": { "notifications_enabled": true } } 

चाइल्ड फ़ील्ड का मान चाइल्ड () जनरेटर का परिणाम है।

जैसा कि एपीआई विधियों के विवरण में, उद्धरण चिह्नों में संलग्न नहीं किए गए किसी भी तार को मूल्यांकन के रूप में माना जाता है। यह न केवल किसी अन्य जनरेटर के लिए कॉल हो सकता है, बल्कि एक मनमाना अभिव्यक्ति है, उदाहरण के लिए, टिप्पणी ($ उपयोगकर्ता) जनरेटर में, सामग्री फ़ील्ड स्ट्रिंग के संघनन का प्रतिनिधित्व करती है हाय! मैं $ उपयोगकर्ता को नाम दिया गया हूं

जनरेटर के नाम केस-असंवेदनशील हैं और एक लैटिन पत्र से शुरू होना चाहिए, उनमें लैटिन अक्षर, संख्या, अंडरस्कोर और बैकस्लैश हो सकते हैं।

क्योंकि जनरेटर और अंतर्निहित कार्यों को कॉल करने के लिए सिंटैक्स समान है, वे एक सामान्य नाम स्थान साझा करते हैं। अधिवेशन के द्वारा, मैं एक "विक्रेता" या अंतर्निहित कार्यों के पुस्तकालय को निर्दिष्ट करने के लिए एक विभाजक के रूप में बैकस्लैश का उपयोग करने का सुझाव देता हूं, जैसे कि Gakerub.com/fzaninotto/Fit पुस्तकालय पर आधारित Faker \ something () फ़ंक्शन।

अंतर्निहित कार्य

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

चर के साथ संचालन:

इसी तरह ($ var, $ नमूना, $ checkTypes) बुलियन - तर्क सही है अगर तर्क एक ही प्रकार के हैं, यदि $ var एक सरणी है, तो सभी स्ट्रिंग कुंजियाँ जो $ नमूना में हैं, $ var में होनी चाहिए, यदि $ checkTypes सच है, तो संबंधित तत्वों के प्रकार मेल खाना चाहिए। दूसरे शब्दों में, $ var सरणी के तत्व $ नमूने के तत्वों का सबसेट हैं।
समान ($ var, $ नमूना, $ checkTypes) बूलियन समान का एक एनालॉग है () , अतिरिक्त एरो के साथ, सरणियों के मामले में, $ var में सभी स्ट्रिंग कुंजियाँ $ नमूना में भी होनी चाहिए । दूसरे शब्दों में, $ var सरणी के तत्व तत्व प्रकार तक $ नमूना सरणी के तत्वों के बराबर हैं ।
अधिकतम ($ var1, $ var2, ... $ varN) - पारित मूल्यों की अधिकतम (यदि उनकी तुलना की जा सकती है)।
न्यूनतम ($ var1, $ var2, ... $ varN) - पारित मूल्यों की न्यूनतम।
if ($ condition, $ var1, $ var2) - यदि $ condition == सत्य है, तो यह $ var1, अन्यथा $ 2 को वापस कर देगा। कोचिंग ऑपरेटर (हैलो MySQL) की जगह।
पसंद ($ condition1, $ var1, $ condition2, $ var2, ..., $ conditionN, $ varN) - $ सशर्त == सच होने पर पहला सामना करना पड़ा $ varK लौटेगा।

तार के साथ काम करें:

आकार ($ स्ट्रिंग) संख्या - UTF-8 एन्कोडिंग में स्ट्रिंग की लंबाई।
रेगेक्स ($ स्ट्रिंग, $ रेगेक्स) बूलियन - नियमित अभिव्यक्ति के लिए चेक स्ट्रिंग ।
regexMatch ($ string, $ regex) Array - स्ट्रिंग्स की एक सरणी लौटाएगा - नियमित समूहों के साथ मेल खाता $ regex ।

ऐरे प्रसंस्करण:

सरणी ($ var1, $ var2, ... $ varN) सरणी - पारित तत्वों से एक सरणी बनाता है।
आकार ($ सरणी) संख्या - सरणी में तत्वों की संख्या।
चाबियाँ ($ सरणी) सरणी - सरणी में कुंजियों की एक सूची।
टुकड़ा ($ सरणी, $ ऑफसेट, $ लंबाई) सरणी - लंबाई के $ ऑफसेट से सरणी का हिस्सा $ लंबाई, ( अधिक )।
परिशिष्ट ($ सरणी, $ मूल्य) सरणी - सरणी के अंत में एक तत्व जोड़ें।
Prepend ($ array, $ value) सरणी - सरणी की शुरुआत में एक तत्व जोड़ें।

दिनांक प्रसंस्करण:

dateFormat ($ date, $ format) स्ट्रिंग - दिनांक स्वरूपण, ( स्वरूपों के बारे में अधिक )।
dateModify ($ date, $ format) दिनांक - वह दिनांक परिवर्तित करें, जो कि रिलेटिव फॉर्मेट्स के साथ उपयोग करने के लिए सुविधाजनक है ।

रैंडम टेस्ट डेटा जेनरेशन:

Faker \ पूर्णांक ($ मिनट, $ अधिकतम) संख्या - $ $ से $ अधिकतम समावेशी के लिए यादृच्छिक पूर्णांक
Faker \ ipv4 () स्ट्रिंग - यादृच्छिक IPv4
Faker \ arrayElement ($ सरणी) स्ट्रिंग - सरणी से यादृच्छिक तत्व
Faker \ name () स्ट्रिंग - यादृच्छिक नाम
Faker \ ईमेल () स्ट्रिंग - यादृच्छिक ईमेल

अब कई अंतर्निहित कार्य नहीं हैं। मैंने केवल वही जोड़ा जो परीक्षण के समय मुझे आवश्यक लगता है। आप नए संस्करणों में आवश्यकतानुसार नई सुविधाएँ जोड़ सकते हैं। और भविष्य में, अगर यह मांग में है, तो मैं PHP में विशेष कक्षाओं के रूप में कार्यान्वित गतिशील रूप से जुड़े कार्यों को बनाने की क्षमता जोड़ूंगा।

परीक्षण के मामले

एक परीक्षण मामला बयानों का एक क्रम है जिसे एक इकाई कहा जा सकता है। प्रोग्रामिंग भाषाओं में प्रक्रिया के कुछ एनालॉग। टेस्टकेस स्टेटमेंट

द्वारा टेस्ट केस बनाया जाता है , उसके बाद टेस्ट केस के नाम से, एपीआई पद्धति के नाम के समान सिंटैक्स के साथ । नेस्टेड टेस्ट केस निषिद्ध हैं।

 testcase Registration $device //     var $user = User() Register $user on $device assert $response.code == 201 //        var $user = User() //       InvalidUser() var $user.email = "some_bad_email" Register $user on $device assert $response.code == 400 

रन स्टेटमेंट एक अलग टेस्ट केस कह सकता है, या सभी टेस्ट केस जिन्हें तर्क की आवश्यकता नहीं है।

 run Get all users //   -,    run Get user $user_id //   -   run //   -,     

इस तरह के एक लॉन्च का विचार यह है कि परीक्षण मामलों का उपयोग व्यापार तर्क के एक हिस्से के अलग-अलग स्वतंत्र परीक्षणों के रूप में किया जा सकता है और जटिल परीक्षण परिदृश्यों में कोड दोहराव से बचने के लिए प्रक्रियाओं के रूप में।

तर्क विधि के लिए तर्क पास करने के पूर्ण सादृश्य में संदर्भ या मान के द्वारा परीक्षण मामले में तर्क पारित किए जाते हैं।

चर और क्षेत्र

चर नाम केस-संवेदी होते हैं और $ साइन के साथ शुरू होते हैं (हाँ, हाँ, मैं एक pshpshnik हूं)।

की चर प्रकार हैं सरणी , तो अलग-अलग क्षेत्रों या मूल्य के तत्वों के लिए उपयोग बिंदु के माध्यम से उत्पादन किया जाता है: $users.12.password। अंकों के बीच, केवल संख्या या लैटिन अक्षर, पहले लैटिन अक्षर वाले अंडरस्कोर और संख्या की अनुमति है। फ़ील्ड नाम भी केस संवेदनशील होते हैं।

एक सरणी तत्व की एक गतिशील पहुंच संभव है:$post.comments[$i + 1].content

चार प्रकार के संदर्भ हैं - चर का दायरा।

वैश्विक संदर्भ - शुरुआत में बनाया गया है, जिसमें परीक्षण मामलों के बाहर और एपीआई विधि कॉल के बाहर बयान निष्पादित करते समय घोषित सभी चर शामिल हैं।

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

एपीआई विधि संदर्भ - तब बनाया जाता है जब एपीआई विधि कहा जाता है, जब पहले और बाद में निर्दिष्ट ऑपरेटरों को निष्पादित किया जाता है ।

जेनरेटर संदर्भ- जनरेटर में नया बनाने या मौजूदा चर को बदलने की कोई संभावना नहीं है, इसलिए वैश्विक संदर्भ चर और तर्क केवल पढ़ने के लिए हैं। चर हमेशा जनरेटर संदर्भ के लिए मूल्य द्वारा पारित किए जाते हैं।

महत्वपूर्ण नोट। सभी संदर्भों के भीतर, वैश्विक संदर्भ चर उपलब्ध हैं यदि उनके नाम वर्तमान संदर्भ में नहीं बनाए गए हैं।

चर के साथ काम करने के लिए ऑपरेटरों के उदाहरण:

 const $a = 1 let $a = 2 //    var $b = 1 const $b = 3 //    const $c = 3; $c = 4 //   , $c      

 let $a = 1; $a = $a + 1; $a = $a + 2 print $a // 4 

 Testcase Context example changes $argument1, $argument2 and $argument3 var $a = "changed" let $b = "changed" const $c = "changed" import $i let $i = "changed" var $argument1 = "changed" var $argument2 = "changed" var $argument3 = "changed" // ,     var $a = "original" var $b = "original" var $i = "original" const $c = "original"; var $paramByRef = "original" var $paramByVal = "original" const $paramConst = "original" run Context example changes $paramByRef, {$paramByVal} and $paramConst //  $a     - print $a // "original" // $b     -,  let    $b print $b // "changed" // $i      print $i // "original" //      ,  var   print $c // "original" //     print $paramByRef // "changed" //     print $paramByVal // "original" //     ,     print $paramConst // "original" 

सिस्टम और संचालन टाइप करें

लैक्स डायनेमिक टाइपिंग का उपयोग किया जाता है।

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

टुकड़ा प्रकार में उपलब्ध डेटा प्रकार:

संख्याएक संख्या है। सादगी के कारणों के लिए, मैंने इंटेगर और फ्लोट के लिए अलग-अलग प्रकार नहीं बनाए। पीसोस्क्रिप्ट में पूर्णांक और वास्तविक संख्याओं के बीच एकमात्र महत्वपूर्ण अंतर एक सरणी का उपयोग कुंजी के रूप में है: वास्तविक संख्या पूर्णांकों के लिए गोल होगी।
7 -42 3.14159

स्ट्रिंग - डबल कोट्स में संलग्न स्ट्रिंग्स , संभवतः एक
"I say \"Hello world!\""

नल स्लैश के साथ बच गए - केस-असंवेदनशील स्थिर
null

बूलियन द्वारा निर्धारित - बूलियन संचालन और तुलना संचालन का परिणाम है, केस-असंवेदनशील स्थिरांक द्वारा निर्धारित
true false

तिथि / तिथि और समय। "हुड के तहत" एक डेटटाइम है । लगातार एक प्रारूप में, एक उद्धरण में निर्दिष्ट किया जाता है ।
'now', '2008-08-07 18:11:31', 'last day of next month'

ऐरे एक सरणी है, केवल गैर-स्केलर प्रकार है। लपेटनासरणी । इस प्रकार के कोई शाब्दिक नहीं हैं, लेकिन सरणियों जनरेटर के काम का परिणाम हो सकता है, अंतर्निहित कार्य (उदाहरण के लिए, सरणी () - हैलो पीएचपी 5.3 और नीचे), या आप बस वेरिएबल कुंजियों का उपयोग कर सकते हैं जो कि असाइनमेंट में गतिशील रूप से किए जाएंगे।

 let $a.1 = 100 let $i = 1 let $a[$i + 1] = 200 let $a.sum = $a.1 + $a.2 print " "; $a.sum //  300 var $b = array(true, 3, $a, "Hi") // [true, 3, {1: 100, 2: 200, "sum":300}, "Hi"] 

जब कोई नहीं चर या एरेस एलीमेंट को एक्सेस करते हैं, तो टेस्ट स्क्रिप्ट को रोक दिया जाएगा और एक त्रुटि उत्पन्न होगी। लेकिन जब ऑपरेटरों का दावा है या बहुत जरूरी है, अगर वहाँ किसी गैर-मौजूद चर लिए एक संदर्भ है, त्रुटि नहीं होगा, लेकिन जांच में विफल माना जाता है।

एक चर के अस्तित्व और प्रकार की जाँच करना

हमें चर @ के अस्तित्व और प्रकार की जाँच के निर्माण का अलग से उल्लेख करना चाहिए ।

यदि $ के बजाय चर नाम में @ निर्दिष्ट किया जाता है , तो इस निर्माण का परिणाम निम्न में से एक होगा:

• चर के प्रकार या सरणी तत्व के प्रकार के साथ एक स्ट्रिंग, यदि कुंजी का उपयोग किया गया था;
• अशक्त अगर चर सुलभ संदर्भों में नहीं पाया जाता है या सरणी में निर्दिष्ट कुंजी के साथ तत्व मौजूद नहीं है।

यह डिज़ाइन HTTP प्रतिक्रियाओं की संरचना की जाँच करते समय उपयोगी हो सकता है।

 var $a.string_field = "Hello World" var $a.number_field = 3.14 var $a.bool_field = true var $a.date_field = '+1 day' var $a.null_field = null var $a.array_field = array(1, "2") assert @a.string_field == "String" assert @a.number_field == "Number" assert @a.bool_field == "Boolean" assert @a.date_field == "Date" assert @a.null_field == "Null" assert @a.array_field == "Array" assert @a.array_field.0 == "Number" assert @a.array_field.1 == "String" assert @a.array_field.2 == null assert @notExistedVar == null 

या निर्माण में जैसे:

 assert @comment.optional_field && $comment.optional_field > 20 

पहले ऑपरेशन पर बूलियन ऑपरेशन को अनुकूलित किया जाता है। यदि पहला ऑपरेंड गलत है , तो && ऑपरेशन भी दूसरे ऑपरेंड की गणना करने का प्रयास नहीं करेगा। इसी तरह से || ।

रन के बीच डेटा की बचत

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

सहेजना सक्षम है - स्टोरेज कमांड लाइन विकल्प , जो स्टोरेज फ़ाइल का नाम सेट करता है:

 pos.phar run ./start.pos --storage=storage.yaml 

डेटा को YAML प्रारूप में सहेजा जाता है, जो इसे पढ़ना और संपादित करना आसान बनाता है।

संग्रहण \ get (स्ट्रिंग $ कुंजी, $ defaultValue, बूलियन $ saveValue = true) - यदि कुंजी $ कुंजी मौजूद नहीं है या संग्रहण फ़ाइल निर्दिष्ट नहीं है, तो $ defaultValue लौटाता है। अन्यथा, यह संग्रहीत मान लौटाता है। यदि तर्क $ saveValue सही है और कुंजी $ कुंजी नहीं मिली, तो $ defaultValue लिखा जाएगा।

भंडारण \ सेट (स्ट्रिंग $ कुंजी, $ मूल्य) - कुंजी $ कुंजी के साथ $ मूल्य बचाता है, और $ मूल्य लौटाता है। यदि संग्रहण फ़ाइल सेट नहीं की गई है, तो यह केवल $ मूल्य लौटाता है।

भंडारण \ कुंजी (स्ट्रिंग $ regexp = null) सरणी- सभी उपलब्ध कुंजियों की एक सरणी देता है। यदि तर्क $ regexp शून्य नहीं है, तो इस नियमित अभिव्यक्ति के अनुरूप कुंजी वापस आ जाएगी। यदि संग्रहण फ़ाइल सेट नहीं की गई है, तो यह खाली सरणी देता है।

स्टडआउट के लिए आउटपुट

PieceofScript JUnit और HTML प्रारूप में रिपोर्ट उत्पन्न कर सकते हैं। पहले CI / CD सिस्टम के साथ एकीकरण के लिए आवश्यक है, उदाहरण के लिए जेनकिंस। दूसरा यह है कि परीक्षा परिणाम को आसानी से देखें, उदाहरण के लिए, स्थानीय स्तर पर परीक्षण करते समय। स्टार्टअप पर रिपोर्ट फ़ाइलें सेट की जा सकती हैं:

 pos.phar run ./start.pos --junit=junit_report.xml --html=report.html 

HTML रिपोर्ट का एक उदाहरण

दुभाषिया के काम के बारे में विभिन्न जानकारी स्टडआउट में प्रदर्शित की गई है। सूचना उत्पादन के 5 मानक स्तर हैं। सब कुछ उसी स्तर पर प्रदर्शित किया जाता है जो अन्य "बातूनी" लोगों पर भी प्रदर्शित होता है।

चुप - सबसे "मूक" स्तर -q कमांड लाइन विकल्प द्वारा निर्धारित किया जाता है ।
इस स्तर पर, कुछ भी स्टडआउट, यहां तक ​​कि महत्वपूर्ण दुभाषिया त्रुटियों के लिए आउटपुट नहीं है। लेकिन गैर-शून्य रिटर्न कोड के द्वारा, आप समझ सकते हैं कि कुछ गलत हो गया। विकल्प निर्दिष्ट किए बिना

सामान्य डिफ़ॉल्ट स्तर है।
इस स्तर पर, दुभाषिया में त्रुटियां उत्पन्न होती हैं। API विधियों में त्रुटिपूर्ण अनुरोध और विफल दावे और जाँच अवश्य होनी चाहिए ।

Verbose - विकल्प द्वारा निर्धारित-v ।
इस स्तर पर, प्रिंट स्टेटमेंट के परिणाम प्रदर्शित किए जाते हैं ।

बहुत क्रिया - -vv विकल्प द्वारा निर्धारित ।
इस स्तर पर, दुभाषिया चेतावनी प्रदर्शित की जाती है।

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

उदाहरण

कहावत "सौ बार सुनने से बेहतर है एक बार देखना" सही है और व्याख्या में "कोड को एक बार देखने से बेहतर है कि उसका वर्णन सौ बार पढ़ें"। मैंने https://github.com/maximw/PosExamples रिपॉजिटरी में उदाहरण तैयार किए और डाले ।

VirusTotal

Virustotal.com - दुर्भावनापूर्ण फ़ाइलों और लिंक की जाँच के लिए एक सेवा। एपीआई प्रलेखन । टिप्पणी के तरीकों के अपवाद के साथ, एपीआई के सार्वजनिक भाग के लिए टेस्ट किए जाते हैं, क्योंकि मैं परीक्षण डेटा के साथ एक वास्तविक "मुकाबला" एपीआई में कूड़े नहीं करना चाहता।

एपीआई तक पहुंचने के लिए, आपको रजिस्टर करने की जरूरत है , कुंजी प्राप्त करें और इसे Virustotal / globals.pos फ़ाइल में जोड़ें ।

चल रहे परीक्षण:

 pos.phar run ./Virustotal/start.pos 

Pastery

पासेबिन एनालॉग। एपीआई प्रलेखन ।
एपीआई को एक्सेस करने के लिए आपको रजिस्टर करने की जरूरत है , कुंजी प्राप्त करें और इसे Pastery / globals.pos फ़ाइल में जोड़ें ।

चल रहे परीक्षण:

 pos.phar run ./Pastery/start.pos 

यह उल्लेखनीय है कि इन परीक्षणों के साथ विचारों की संख्या की सीमा में एक बग पाया गया था। यह पहले से ही Pastery के डेवलपर्स द्वारा तय किया गया है।

रिक और मॉर्टी

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

चल रहे परीक्षण:

 pos.phar run ./RickAndMorty/20MinutesTest.pos 

यदि आप एक सार्वजनिक एपीआई जानते हैं जो इस तरह से परीक्षण करना दिलचस्प होगा, तो कृपया एक व्यक्तिगत ईमेल में लिखें।

भविष्य के लिए टिप्पणियां और योजनाएं, यदि कोई हो

0) मेरे पास छोटे और बड़े सुधारों की एक सूची है, जिनकी मुझे अभी आवश्यकता नहीं है, लेकिन उपयोगी हो सकते हैं।


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

2) मुझे लगता है कि OpenAPI ( स्वैगर ), RAML , विवरणों के आधार पर एपीआई विधियों के लिए मचान बहुत उपयोगी होंगेडाकिया । लेकिन यह बहुत से काम लायक है अगर पीलूस्क्रिप्ट को इसके लायक है।

3) कुछ आईडीई के लिए प्लगइन्स बनाना अच्छा होगा, जिसमें कोड हाइलाइटिंग और ऑटो-पूरा करना होगा। टेस्ट केस के नाम, एपीआई के तरीके, ऑपरेटर और चर के स्वतः पूर्णता केवल अर्चि-सुविधाजनक होंगे। लेकिन वह अभी तक इस दिशा में "खोदा" नहीं गया है। उदात्त पाठ और भाषा सर्वर प्रोटोकॉल के लिए हाइलाइटिंग बनाने को समझना । मुझे खुशी होगी अगर इस तरह के दिमाग वाले लोग पहले से ही ऐसी चीजों में पारंगत हों।

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

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

PS एक तरफ, चूंकि यह मेरा "शिल्प" है, इसलिए "I am PR।" हब में पोस्ट डालना तर्कसंगत होगा। दूसरी ओर, मैं पीआर नहीं करता हूं, किसी भी व्यावसायिक लाभ का पीछा नहीं करता हूं, बस एक उपकरण जो मैंने खुद के लिए बनाया है, मैंने "कंघी" करने का फैसला किया और इसे सार्वजनिक रूप से बाहर रखा।