FracturedJson

• JSON डेटा को इंसानों के लिए पढ़ने में आसान तरीके से व्यवस्थित रखते हुए भी उसे कॉम्पैक्ट रूप में बनाए रखने वाली formatting utility का संग्रह
• arrays और objects को जहाँ तक संभव हो एक ही पंक्ति में दिखाता है, और जब संरचना समान हो तो टेबल के रूप में align करता है
• comments preserve करने की सुविधा देता है; JSON standard में comments नहीं होते, लेकिन वास्तविक उपयोग परिवेश में आम comments को साथ बनाए रखता है
• .NET library, JavaScript/TypeScript package, VS Code extension, browser formatter जैसे कई environments में इस्तेमाल किया जा सकता है
• मौजूदा JSON formatters की readability सीमाओं को बेहतर बनाकर developers और data analysts की visual understanding बढ़ाने वाला tool

---

FracturedJson अवलोकन

• FracturedJson utilities का एक संग्रह है जो इंसानों के लिए पढ़ने में आसान लेकिन अपेक्षाकृत compact JSON format बनाता है
  • arrays और objects बहुत लंबे या जटिल न हों तो उन्हें एक पंक्ति में आउटपुट करता है
  • समान संरचना वाली कई पंक्तियों को fields align करके table के रूप में दिखाता है
  • लंबे arrays को कई पंक्तियों में बाँटकर, एक पंक्ति में कई items रखता है
• अलग-अलग settings के जरिए output format को नियंत्रित किया जा सकता है, और ज़्यादातर मामलों में default settings से भी अच्छा परिणाम मिलता है
• यह browser-based formatter page, .NET library, JavaScript/TypeScript package, और VS Code extension के रूप में उपलब्ध है
• Python के लिए विकल्प भी अलग से बताए गए हैं

Motivation

• ज़्यादातर JSON libraries केवल दो तरह के formats देती हैं
  • Minified JSON: efficient, लेकिन इंसानों के लिए पढ़ना मुश्किल
  • Beautified/Indented JSON: बहुत ज़्यादा फैला हुआ, इसलिए जल्दी समझना कठिन
• FracturedJson डेटा को वैसे format करता है जैसे कोई इंसान सीधे लिखता
  • बहुत जटिल या लंबा न हो तो containers को एक पंक्ति में रखता है
  • समान arrays या objects को table format में align करता है

काम करने का तरीका (How It Works)

• FracturedJson चार तरह की formatting styles का उपयोग करता है
  1. Inlined: छोटे और सरल objects या arrays को एक पंक्ति में दिखाता है
     • MaxInlineComplexity setting से allowed nesting level नियंत्रित होता है
  2. Compact Multiline Array: कई items को एक पंक्ति में रखते हुए, कई पंक्तियों में बाँटकर दिखाता है
     • MaxCompactArrayComplexity से nesting allowance बदला जा सकता है, -1 से disable किया जा सकता है
  3. Table: समान संरचना वाले items को column-aligned format में व्यवस्थित करता है
     • अगर inner containers बहुत जटिल हों तो केवल कुछ हिस्सों को compact किया जाता है
     • MaxTableRowComplexity और TableCommaPlacement से नियंत्रित किया जा सकता है
  4. Expanded: अगर ऊपर की शर्तें लागू न हों, तो हर item को कई पंक्तियों में indent करके दिखाता है

comments हैंडलिंग

• JSON standard comments की अनुमति नहीं देता, लेकिन FracturedJson comments preserve करने की सुविधा देता है
  • comments संबंधित elements के साथ बने रहते हैं, और multi-line comments व inline comments दोनों संभाले जा सकते हैं

Discussions

• user questions, feedback, और suggestions के लिए GitHub Discussions space उपलब्ध है
• project से जुड़ी discussions और improvement suggestions दी जा सकती हैं