YAML কে JSON-এ রূপান্তর করুন!

YAML দিন এবং সেটিকে JSON-এ রূপান্তর করুন! yml, Kubernetes, docker-compose সমর্থিত।
YAML
ফলাফল
 

YAML কে JSON-এ রূপান্তর করুন!

একটি YAML (yml) ডকুমেন্টকে JSON-এ কনভার্ট করে দেখুন ইনডেন্টেশন যে গঠন লুকিয়ে রাখে, আর প্রতিটি ভ্যালু আসলে কোন type হিসেবে parse হয়েছে। Anchor আর alias আসল ভ্যালুতে প্রসারিত হয়, আর --- দিয়ে আলাদা করা একাধিক ডকুমেন্ট একটি array-তে জড়ো হয়।

YAML-এর পরিচিত ভুল ধরতে এটি বিশেষভাবে কাজে আসে: একটি স্পেস কম থাকায় ভুল parent-এর সাথে যুক্ত হয়ে যাওয়া ভ্যালু, অথবা version: 1.10 নিঃশব্দে সংখ্যা 1.1 হয়ে যাওয়া।

কীভাবে ব্যবহার করবেন

  1. YAML বক্সে একটি docker-compose.yml, Kubernetes manifest বা workflow ফাইল পেস্ট করুন, অথবা ফাইলটি ড্র্যাগ করে ছাড়ুন।
  2. Syntax error ফলাফলে লাইন আর কলাম নম্বরসহ দেখায়; আগে সেই জায়গার ইনডেন্টেশন যাচাই করুন।
  3. প্রতিটি ভ্যালু স্ট্রিং, সংখ্যা না boolean হয়েছে তা দেখতে ফলাফল-এর নিচের JSON পড়ুন, আর দরকার হলে কপি করুন।

উদাহরণ

ইনপুট (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 স্ট্রিং key "on" হিসেবেই থাকে, কারণ এই টুল YAML 1.2-এর নিয়মে parse করে। &node anchor দিয়ে ডিফাইন করা ব্লকটি *node-এর জায়গায় প্রসারিত হয়।

সমর্থিত বৈশিষ্ট্য

  • YAML 1.2 core schema দিয়ে parse হয়: yes, on আর off স্ট্রিং থাকে, আর শুধু true/True/false boolean হয়।
  • ~ আর ফাঁকা ভ্যালু হয় null; hex 0x1F আর octal 0o17 সংখ্যা হয়।
  • &anchors আর *aliases নির্দেশিত ভ্যালুতে resolve হয়।
  • Literal | আর folded > block scalar YAML-এর newline নিয়ম প্রয়োগ করে স্ট্রিংয়ে বদলানো হয়।
  • --- দিয়ে আলাদা কয়েকটি ডকুমেন্ট একটি JSON array হয়; একটিমাত্র ডকুমেন্ট তার নিজের ভ্যালু হিসেবে আউটপুট হয়।
  • একই mapping-এ দুবার আসা key error হিসেবে জানানো হয়।

ব্যবহারের ক্ষেত্র

Kubernetes manifest-এর ইনডেন্টেশন যাচাই

containers-এর নিচের env এক ধাপ কম ইনডেন্ট করা থাকলে সেটি নিঃশব্দে অন্য ফিল্ডের সাথে যুক্ত হয়ে যায়, আর তা ধরা পড়ে শুধু apply করার সময়। JSON-এ বন্ধনীগুলো দেখায় এটি ঠিক কোন অবজেক্টের অংশ।

কোড থেকে config ব্যবহার

যেসব স্ক্রিপ্ট বা ফ্রন্টএন্ড bundle-এ YAML parser যোগ করা বাড়াবাড়ি, সেখানে config একবার কনভার্ট করে import config from './config.json' হিসেবে ব্যবহার করুন।

OpenAPI spec পরীক্ষা

YAML-এ লেখা OpenAPI ডকুমেন্ট কনভার্ট করার পর JSONPath বা jq দিয়ে কোয়েরি করা সহজ হয়, যেমন নির্দিষ্ট path-এর schema বের করা।

নোট ও সীমাবদ্ধতা

  • Merge key (<<: *defaults) প্রয়োগ হয়: anchor করা mapping-এর key-গুলো কপি হয়ে আসে, আর <<-এর পাশে লেখা key সেগুলোকে override করে। শুধু YAML 1.2 মানা parser <<-কে সাধারণ key হিসেবে রাখত, তাই এমন টুলের সাথে ফলাফল আলাদা হতে পারে।
  • 2024-01-01-এর মতো তারিখ ও সময় Date ভ্যালু না হয়ে স্ট্রিং থাকে।
  • .inf আর .nan-এর কোনো JSON রূপ নেই, তাই সেগুলো null হয়।
  • কমেন্ট JSON-এ নেওয়া যায় না, তাই বাদ পড়ে।
  • PyYAML (YAML 1.1) on আর yes-কে true হিসেবে পড়ে, তাই Python-এর ফলাফল আলাদা হতে পারে।

সাধারণ প্রশ্ন

GitHub Actions-এর on কেন true না হয়ে "on" দেখায়?

YAML 1.2-এ boolean শুধু true আর false, তাই on একটি সাধারণ স্ট্রিং, আর GitHub Actions-ও key-টি এভাবেই পড়ে। Python-এর PyYAML 1.1 মানে এবং এটিকে True key-তে বদলে দেয়, তাই স্ক্রিপ্ট থেকে workflow parse করার সময় সাবধান থাকুন।

version: 1.10 আসছে 1.1 হিসেবে।

কোট ছাড়া 1.10 YAML-এ একটি সংখ্যা, আর 1.10 মানে 1.1। ভার্সন স্ট্রিং রাখতে মূল YAML-এ "1.10" হিসেবে কোটে লিখুন।

কয়েকটি ডকুমেন্টসহ ফাইলের কী হয়?

--- দিয়ে আলাদা প্রতিটি ডকুমেন্ট ক্রমানুসারে একটি array element হয়, তাই kubectl apply -f-এ ব্যবহৃত একাধিক resource-এর ফাইল থেকে resource-গুলোর একটি array পাওয়া যায়।