YAML को JSON में बदलें!

YAML डालें और उसे JSON में बदलें! yml, Kubernetes, docker-compose समर्थित।
YAML
परिणाम
 

YAML को JSON में बदलें!

YAML (yml) document को JSON में बदलें, ताकि indentation के पीछे छिपी संरचना और हर वैल्यू किस type के रूप में parse हुई, यह दिख सके। Anchors और aliases असली values में फैलाए जाते हैं, और --- से अलग किए कई documents एक array में इकट्ठा होते हैं।

यह YAML की पुरानी गलतियां पकड़ने में खास तौर पर काम आता है: एक space कम होने से किसी वैल्यू का गलत parent से जुड़ जाना, या version: 1.10 का चुपचाप संख्या 1.1 बन जाना।

उपयोग कैसे करें

  1. docker-compose.yml, Kubernetes manifest या workflow फ़ाइल को YAML बॉक्स में पेस्ट करें, या फ़ाइल उस पर drop करें।
  2. Syntax errors परिणाम में line और column numbers के साथ दिखते हैं; पहले उस जगह का indentation जांचें।
  3. परिणाम के नीचे का JSON पढ़कर देखें कि हर वैल्यू string, संख्या या boolean बनी, और ज़रूरत हो तो उसे कॉपी करें।

उदाहरण

इनपुट (YAML)
name: ci
on:
  push:
    branches: [main]
defaults: &node
  runs-on: ubuntu-latest
  timeout-minutes: 10
jobs:
  test: *node
आउटपुट (JSON)
{
  "name": "ci",
  "on": {
    "push": {
      "branches": [
        "main"
      ]
    }
  },
  "defaults": {
    "runs-on": "ubuntu-latest",
    "timeout-minutes": 10
  },
  "jobs": {
    "test": {
      "runs-on": "ubuntu-latest",
      "timeout-minutes": 10
    }
  }
}

GitHub Actions की on: key string key "on" ही रहती है, क्योंकि यह टूल YAML 1.2 नियमों से parse करता है। &node anchor से define किया block *node की जगह फैलाया जाता है।

समर्थित सुविधाएँ

  • YAML 1.2 core schema से parse होता है: yes, on और off strings रहते हैं, और सिर्फ़ true/True/false booleans बनते हैं।
  • ~ और खाली values null बनती हैं; hex 0x1F और octal 0o17 संख्याएं बनते हैं।
  • &anchors और *aliases reference की गई values में resolve होते हैं।
  • Literal | और folded > block scalars YAML के newline नियम लागू करके strings में बदले जाते हैं।
  • --- से अलग कई documents JSON array बनते हैं; एक अकेला document अपनी ही वैल्यू के रूप में निकलता है।
  • एक ही mapping में दो बार आने वाली key error के रूप में बताई जाती है।

उपयोग के मामले

Kubernetes manifest का indentation जांचना

अगर containers के नीचे env एक स्तर कम indent है, तो वह चुपचाप किसी दूसरे field से जुड़ जाता है और आपको apply के समय ही पता चलता है। JSON में braces ठीक दिखाते हैं कि वह किस object का है।

कोड से config इस्तेमाल करना

किसी script या front-end bundle के लिए जहां YAML parser जोड़ना ज़्यादा है, config को एक बार बदलें और उसे import config from './config.json' के रूप में इस्तेमाल करें।

OpenAPI spec की जांच

YAML में लिखा OpenAPI document बदलने के बाद JSONPath या jq से query करना आसान होता है, उदाहरण के लिए किसी खास path का schema निकालना।

नोट्स और सीमाएँ

  • Merge keys (<<: *defaults) लागू होती हैं: anchor वाली mapping की keys कॉपी होती हैं, और << के पास लिखी keys उन्हें override करती हैं। सिर्फ़ YAML 1.2 वाला parser << को सादी key रखेगा, इसलिए ऐसे टूल्स से परिणाम अलग हो सकते हैं।
  • 2024-01-01 जैसी तारीखें और समय Date values बनने की बजाय strings रहते हैं।
  • .inf और .nan का JSON में कोई रूप नहीं है और वे null बनते हैं।
  • Comments JSON में नहीं ले जाए जा सकते और हट जाते हैं।
  • PyYAML (YAML 1.1) on और yes को true पढ़ता है, इसलिए Python के परिणाम अलग हो सकते हैं।

अक्सर पूछे जाने वाले प्रश्न

GitHub Actions का on true की बजाय "on" क्यों दिखता है?

YAML 1.2 में सिर्फ़ true और false booleans हैं, इसलिए on एक सामान्य string है, और GitHub Actions भी key को इसी तरह पढ़ता है। Python का PyYAML 1.1 का पालन करता है और इसे True key बना देता है, इसलिए scripts से workflows parse करते समय सावधान रहें।

version: 1.10 1.1 के रूप में आता है।

बिना quotes का 1.10 YAML में संख्या है, और 1.10 1.1 के बराबर है। Version string रखने के लिए source YAML में उसे "1.10" के रूप में quote करें।

कई documents वाली फ़ाइल का क्या होता है?

--- से अलग हर document क्रम से array का element बनता है, इसलिए kubectl apply -f के साथ इस्तेमाल होने वाली कई resources वाली फ़ाइल से resources का array मिलता है।