TOON फॉरमॅट चीट शीट

टून
देव साधने

जर तुम्हाला कधी वाटले असेल की JSON खूप शब्दशः आहे (त्या सर्व ब्रेसेस!) परंतु YAML जरा जास्त "जादुई" आणि अप्रत्याशित आहे, तर तुम्ही कदाचित TOON च्या प्रेमात पडाल. हे स्वरूप मानवी वाचनीयता आणि मशीन पार्सिंग गती यांच्यात एक अद्वितीय संतुलन साधते. हे दाट, सुस्पष्ट आणि विश्लेषित करण्यासाठी आश्चर्यकारकपणे जलद असण्यासाठी डिझाइन केले आहे.

तुम्ही डेटा स्थलांतरित करत असाल किंवा कॉन्फिगरेशन फाइल डीबग करण्याचा प्रयत्न करत असाल, या चीट शीटमध्ये तुम्हाला माहित असणे आवश्यक असलेले आवश्यक वाक्यरचना समाविष्ट आहे.

तत्वज्ञान: कमी आवाज, अधिक डेटा

तुमच्या लक्षात येणारी पहिली गोष्ट म्हणजे TOON हे YAML सारखे दिसते, परंतु ते JSON सारखे काटेकोरपणे वागते. हे इंडेंटेशन आणि न्यूलाइन्सच्या बाजूने उघडण्याच्या आणि बंद करण्याच्या ब्रेसेस खोडून टाकते, ज्यामुळे तुमचा डेटा त्वरित स्वच्छ दिसतो.

ऑब्जेक्ट्स आणि नेस्टिंग

JSON मध्ये, तुम्हाला कुरळे ब्रेसेसमध्ये सर्वकाही गुंडाळण्याची सवय आहे. TOON मध्ये, रचना इंडेंटेशनद्वारे निहित आहे.

JSON:

``md { "प्रकल्प": { "मेटाडेटा": { "नाव": "अल्फा-सेंटौरी", "status": "सक्रिय" }, "टप्पे": [ { "फेज": "डिझाइन", "प्राधान्य": 1 }, { "फेज": "चाचणी", "प्राधान्य": 2 } ] } }

तून:

``md प्रकल्प: मेटाडेटा: नाव: अल्फा-सेंटौरी स्थिती: सक्रिय टप्पे[2]{फेज,प्राधान्य}: डिझाइन, 1 चाचणी, 2

लक्षात घ्या की कीजमध्ये विशेष वर्ण असल्याशिवाय कोट्सची आवश्यकता नसते आणि पदानुक्रम दृश्यमानपणे स्पष्ट आहे.

ॲरेची शक्ती

इथेच TOON खरोखरच इतर फॉरमॅट्सपासून वेगळे होते. TOON ला तुम्हाला ॲरेची लांबी की मध्येच घोषित करणे आवश्यक आहे. हे सुरुवातीला विचित्र वाटू शकते, परंतु ते पार्सरला मेमरी पूर्व-वाटप करण्यास अनुमती देते, ज्यामुळे ते झपाट्याने जलद होते.

आदिम ॲरे

स्ट्रिंग किंवा संख्यांच्या साध्या सूचीसाठी, TOON एक संक्षिप्त, स्वल्पविरामाने विभक्त वाक्यरचना वापरते.

वाक्यरचना:

``md की[लांबी]: आयटम1, आयटम2, आयटम3

तुमच्याकडे रूट ॲरे असल्यास (संपूर्ण फाइल फक्त एक सूची आहे), ती असे दिसते:

टॅब्युलर ॲरे (द किलर फीचर)

हे वैशिष्ट्य आहे जे सहसा विकसक जिंकते. जर तुमच्याकडे ऑब्जेक्ट्सचा ॲरे असेल ज्यात सर्व समान की शेअर करतात (जसे की डेटाबेसमधील पंक्ती), TOON तुम्हाला हेडरमध्ये once स्कीमा परिभाषित करू देते आणि नंतर फक्त मूल्यांची यादी करू देते. हे JSON मध्ये आढळणारी मोठ्या प्रमाणावर रिडंडंसी काढून टाकते.

वाक्यरचना:

``md की[पंक्ती]{col1,col2}:

JSON:

``md { "इन्व्हेंटरी": [ { "sku": "KB-99", "प्रमाण": ५०, "मार्ग": 4, "पुनर्क्रमित करा": खोटे }, { "sku": "MS-12", "प्रमाण": १२, "मार्ग": 7, "पुनर्क्रमित करा": खरे }, { "sku": "MN-44", "प्रमाण": 8, "मार्ग": 2, "पुनर्क्रमित करा": खरे } ] }

तून:

``md इन्व्हेंटरी[3]{sku,qty,aisle,reorder}: KB-99,50,4, असत्य MS-12,12,7, खरे MN-44,8,2, खरे

हा "CSV-inside-YAML" दृष्टीकोन मोठा डेटासेट आश्चर्यकारकपणे वाचनीय आणि संक्षिप्त बनवतो.

मिश्रित आणि नेस्टेड ॲरे

कधीकधी डेटा एकसमान नसतो. जर तुमच्या ॲरेमध्ये विविध प्रकारचे डेटा (ऑब्जेक्ट्ससह मिश्रित संख्या) असतील किंवा त्यात जटिल नेस्टेड ऑब्जेक्ट्स असतील, तर TOON हायफन वापरून बुलेट-पॉइंट स्टाइल सिंटॅक्समध्ये परत येतो.

आपल्याकडे ॲरेच्या आत ॲरे देखील असू शकतात. आतील ॲरे देखील त्याची लांबी कशी घोषित करते ते लक्षात घ्या:

उद्धरण: ते कधी वापरावे

TOON बद्दल सर्वात छान गोष्टींपैकी एक म्हणजे तुम्हाला क्वचितच कोट्सची आवश्यकता असते. तुम्ही Hello 世界 👋 लिहू शकता ते "" मध्ये न गुंडाळता. तथापि, TOON प्रकार (संख्या, बूलियन्स) अनुमान काढण्याचा प्रयत्न करत असल्यामुळे, तुम्ही कोट वापरणे आवश्यक आहे यासाठी विशिष्ट नियम आहेत.

"मस्ट-कोट" सूची

तुम्ही तुमची स्ट्रिंग दुहेरी अवतरणात गुंडाळली पाहिजे "" जर:

  1. हे संख्या किंवा बुलियनसारखे दिसते: जर तुम्हाला "123" किंवा "true" स्ट्रिंग हवी असेल, तर ती उद्धृत करा. अन्यथा, ते संख्या १२३ आणि बुलियन सत्य बनतात.
  1. त्यात परिसीमक आहेत: जर तुमच्या स्ट्रिंगमध्ये स्वल्पविराम असेल , (किंवा तुमचे सक्रिय परिसीमक जे काही असेल), ते उद्धृत करा.
  1. त्यात व्हाइटस्पेस कडा आहेत: अग्रगण्य किंवा मागे असलेल्या स्पेससाठी कोट आवश्यक आहेत.
  1. यात विशेष वर्ण आहेत: :, ", \, [, ], {, } सारखी वर्ण.
  1. ते रिकामे आहे: रिकामी स्ट्रिंग "" म्हणून दर्शविली जाते.

उदाहरणे:

एस्केप सिक्वेन्स

साधे ठेवा. TOON फक्त स्ट्रिंगमधील पाच एस्केप सीक्वेन्स ओळखतो. इतर काहीही अवैध आहे.

  • \\ (बॅकस्लॅश)
  • \" (डबल कोट)
  • \n (नवीन रेखा)
  • \r (कॅरेज रिटर्न)
  • \t (टॅब)

प्रगत शीर्षलेख आणि सीमांकक

तुमचा डेटा स्वल्पविरामांनी भरलेला असेल तर? आपण प्रत्येक फील्ड उद्धृत करू इच्छित नाही. TOON तुम्हाला ॲरे हेडरमधील परिसीमक बदलण्याची परवानगी देतो.

तुम्ही टॅब किंवा पाइप (|) कंसात किंवा ब्रेसेसमध्ये ठेवून वापरू शकता.

पाईप डिलिमिटर उदाहरण:

हेडरमध्ये | जोडून, ​​पार्सरला स्वल्पविरामांऐवजी पाईप्स शोधणे माहीत असते, तुमचे वाक्यरचना स्वच्छ ठेवते.

की फोल्डिंग

जर तुमच्याकडे खोल नेस्टिंग असेल परंतु डेटाचा एकच मार्ग असेल, तर तुम्हाला पाच वेळा इंडेंट करण्याची आवश्यकता नाही. तुमची रचना सपाट करण्यासाठी तुम्ही डॉट नोटेशन (की फोल्डिंग) वापरू शकता.

स्टँडर्ड नेस्टिंग:

``md वापरकर्ता: प्रोफाइल: सेटिंग्ज: सूचना: ईमेल: खरे एसएमएस: खोटे

** दुमडलेला (क्लीनर):**

``md user.profile.settings.notifications: ईमेल: खरे एसएमएस: खोटे

द्रुत प्रकार संदर्भ

TOON नकाशे थेट JSON प्रकारांसाठी, परंतु ते वैध आउटपुट सुनिश्चित करण्यासाठी JavaScript-विशिष्ट किनारी प्रकरणे सुंदरपणे हाताळते.

  • संख्या: कॅनोनिकल दशांश म्हणून संग्रहित. 1.0 1 बनते.
  • अनंत / NaN: हे नल होतात (कारण JSON त्यांना सपोर्ट करत नाही).
  • तारीख: कोट केलेल्या ISO स्ट्रिंगमध्ये रूपांतरित केले.
  • अपरिभाषित/कार्ये: नल मध्ये रूपांतरित.
  • रिक्त वस्तू: काहीही नाही (रिक्त आउटपुट) म्हणून प्रतिनिधित्व केले.
  • रिक्त ॲरे: की[0]: म्हणून प्रस्तुत.

TOON हे एक स्वरूप आहे जे अचूकतेला बक्षीस देते. तुमच्या ॲरे आयटमची मोजणी करण्याची सवय होण्यास थोडा वेळ लागू शकतो, परंतु वाचनीयता आणि फाईल आकाराच्या मोबदला हे प्रयत्नासाठी चांगले आहे. आनंदी कोडिंग!