क्या रूबी वाक्यविन्यास के लिए कोई निश्चित संदर्भ दस्तावेज़ है?

Question

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

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

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

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

क्या मुझे अभी कुछ याद आ रहा है या वास्तव में कोई निश्चित संपूर्ण रूबी वाक्यविन्यास को परिभाषित करने योग्य पठनीय दस्तावेज़ है?

Answer 1

केवल दस्तावेज है कि यथोचित रूप में "निश्चित" वर्णित किया जा सकता YARV स्रोत पेड़ में parse.y के स्रोत कोड है।

ISO Draft Specification में व्याकरण के सारांश के साथ एक 39 पृष्ठ परिशिष्ट शामिल है। नोट, हालांकि, आईएसओ रूबी रूबी 1.8 और 1.9 के चौराहे का एक न्यूनतम सबसेट है। IOW: यह किसी भी चीज का वर्णन नहीं करता है जो केवल 1.8 में है या केवल 1.9 में है (इसलिए, 1.9 में सिंटैक्स जोड़ों जैसे स्टेबी प्रो और प्रतीक हैंश का वर्णन नहीं किया गया है), और न ही उस छेड़छाड़ में सब कुछ का वर्णन करता है। आईएसओ रूबी उस संबंध में आईएसओ एचटीएमएल की तरह थोड़ा सा है।

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

अंतिम बात जिसे निश्चित माना जा सकता है वह है The Ruby Programming Language डेविड फ़्लानागन और युकिहिरो "मैटज़" मात्सुमोतो द्वारा पुस्तक।

नोट, हालांकि, "रूबी सिंटैक्स का पूरा" एक कठिन काम है, क्योंकि रुबी का सिंटैक्स अमानवीय अजीब कोने के मामलों की एक बड़ी मात्रा के साथ जटिल है।

Answer 2

यह एक बहुत अच्छी रूबी वाक्य रचना संसाधन

http://www.cs.auckland.ac.nz/references/ruby/doc_bundle/Manual/man-1.4/syntax.html

Answer 3

सुझाव ऊपर जवाब के रूप में है, वहाँ http://ruby-std.netlab.jp पर एक "कल्पना" लिखने पर एक प्रयास है।

आपको उस "spec" से सावधान रहना होगा। यह भाषा डिजाइनरों द्वारा नहीं किया जाता है, और वे मूल रूप से दस्तावेज कर रहे हैं जो वे देखते हैं और दूसरी तरफ नहीं। यह 1.8.7 पर आधारित है इसलिए 1.9 में विशेषताएं हो सकती हैं जो कवर नहीं हैं।

मैं कल्पना नहीं कर सकता कि 300 पृष्ठ दस्तावेज़ के साथ वाक्यविन्यास को याद रखना। "टेबल पर" रखने के लिए, this cheatsheet वर्णन करता है कि आप क्या चाहते हैं: संघनित वाक्यविन्यास, आरक्षित शब्द, आदि This is an alternative from dzone।

Answer 4

कार्यों में रूबी मानक का एक मसौदा है। आप इसे यहाँ प्राप्त कर सकते हैं: http://ruby-std.netlab.jp/

आपका उदाहरण के बारे में case और प्रोग्रामिंग रूबी खराब चुना जाता है। प्रोग्रामिंग रूबीcase का परिचय जब (प्रथम संस्करण के लिए पेज 98 पर; दूसरे संस्करण के लिए 141), थॉमस कहते हैं,

रूबी case अभिव्यक्ति एक शक्तिशाली जानवर है: बहु तरफ़ा if स्टेरॉयड पर। और इसे और भी अधिक शक्तिशाली बनाने के लिए, यह दो स्वादों में आता है।

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

आपका बड़ा बिंदु हालांकि अनुचित नहीं है। यह मानक होने के लिए शायद मददगार होगा।