JSON থেকে YAML কনভার্টার

আপনার ব্রাউজারে JSON-কে YAML এবং YAML-কে JSON-এ রূপান্তর করুন

JSON এবং YAML একই ধরনের ডেটা বর্ণনা করে — নেস্টেড ম্যাপ, তালিকা, স্ট্রিং, সংখ্যা এবং বুলিয়ান — কিন্তু দেখতে খুব ভিন্ন এবং ভিন্ন জায়গায় ব্যবহৃত হয়। আপনি যদি API, কনটেইনার ফাইল, বা CI পাইপলাইনের কাছাকাছি কোনো সময় কাটান, তাহলে একসময় আপনাকে একটিকে অন্যটিতে পরিণত করতে হবে। এই পেজটি সেই রূপান্তরটি উভয় দিকেই করে, সম্পূর্ণভাবে আপনার ব্রাউজারের ভেতরে, তাই আপনি যে ডেটা পেস্ট করেন তা কখনো আপনার মেশিন ছেড়ে যায় না।

JSON কী এবং কোথায় এটি ব্যবহৃত হয়

JSON (JavaScript Object Notation) একটি কঠোর, ব্র্যাকেট-ও-ব্রেস ফরম্যাট যা প্রথমে মেশিনের জন্য তৈরি। প্রতিটি অবজেক্ট {}-এ মোড়ানো, প্রতিটি অ্যারে []-এ, কী ও স্ট্রিং ভ্যালু ডাবল-কোটেড, এবং আইটেমগুলো কমা দিয়ে আলাদা করা। এটি REST ও GraphQL API-এর ডিফল্ট ওয়্যার ফরম্যাট, বেশিরভাগ ওয়েবহুকের বডি, NoSQL ডকুমেন্টের আকার, এবং আপনার fetch কল যা ফেরত দেয়। প্রায় প্রতিটি ভাষা এটি সরাসরি পার্স করে, যে কারণেই এটি API স্তর জিতেছে: JavaScript-এ JSON.parse, Python স্ট্যান্ডার্ড লাইব্রেরিতে json, এবং সর্বত্র সমতুল্য। বিনিময়ে JSON হাতে লিখতে বিস্তারিত এবং মন্তব্য নিষিদ্ধ করে, তাই এটি এমন ফাইলের জন্য দুর্বল ফরম্যাট যা একজন মানুষ সারাদিন সম্পাদনা করে।

YAML কী এবং কোথায় এটি ব্যবহৃত হয়

YAML (YAML Ain't Markup Language) বিপরীত অগ্রাধিকারের জন্য ডিজাইন করা হয়েছিল: প্রথমে মানুষ। এটি ব্রেস ও কোট বাদ দেয়, নেস্টিং প্রকাশ করতে ইনডেন্টেশন ব্যবহার করে, এবং # দিয়ে মন্তব্য লিখতে দেয়। এই পঠনযোগ্যতাই এটিকে কনফিগারেশনের সাধারণ ভাষায় পরিণত করেছে। Docker Compose ফাইল, Kubernetes ম্যানিফেস্ট, GitHub Actions ও GitLab CI ওয়ার্কফ্লো, Ansible প্লেবুক, এবং অগণিত অ্যাপ কনফিগ ফাইল সবই YAML। একটি সাধারণ YAML ডকুমেন্ট সমতুল্য JSON-এর চেয়ে লক্ষণীয়ভাবে ছোট এবং একটি পুল রিকোয়েস্টে ডিফ করা অনেক সহজ। এই কমনীয়তার মূল্য হলো ভঙ্গুরতা, যেখানেই রূপান্তর আকর্ষণীয় হয়ে ওঠে।

গুরুত্বপূর্ণ মূল পার্থক্যগুলো

তিনটি পার্থক্য প্রায় প্রতিটি রূপান্তর সিদ্ধান্তকে চালিত করে। প্রথমত, YAML-এ হোয়াইটস্পেস গুরুত্বপূর্ণ আর JSON-এ অর্থহীন। YAML স্পেস ব্যবহার করে — কখনো ট্যাব নয় — কাঠামো বোঝাতে, তাই একটি একক ভুল-সারিবদ্ধ স্পেস নীরবে একটি ডকুমেন্টের অর্থ পরিবর্তন করে দিতে পারে। JSON ইনডেন্টেশন নিয়ে একেবারেই চিন্তা করে না। দ্বিতীয়ত, YAML মন্তব্য সমর্থন করে আর JSON করে না। YAML-এর যেকোনো # মন্তব্য আপনি JSON তৈরি করলে সহজেই অদৃশ্য হয়ে যায়, কারণ এটি রাখার কোনো জায়গা নেই। তৃতীয়ত, YAML-এর সমৃদ্ধ, অন্তর্নিহিত টাইপিং আছে। এটি খুশিমনে তারিখ, টাইমস্ট্যাম্প এবং কয়েকটি বানানে নাল পড়ে, এবং কোট না করা ভ্যালু থেকে টাইপ অনুমান করে। JSON-এর একটি ছোট, স্পষ্ট টাইপ সেট আছে এবং কোনো অস্পষ্টতা নেই। এটাও লক্ষ্য করুন যে JSON টেকনিক্যালি YAML 1.2-এর একটি সাবসেট, যে কারণে বৈধ JSON সাধারণত YAML হিসেবে পরিষ্কারভাবে পার্স হয়, কিন্তু উল্টোটা নিশ্চিত নয়।

রূপান্তরের যেসব সমস্যা লক্ষ্য রাখতে হবে

রাউন্ড-ট্রিপিং সবসময় লসলেস নয়, আর কোথায় জিনিস ভাঙে তা জানা ভালো:

• নরওয়ে সমস্যা। YAML 1.1 নিয়মের অধীনে, কোট না করা NO বুলিয়ান false হিসেবে পার্স হয়, এবং yes, on, ও offও বুলিয়ানে পরিণত হয়। একটি দেশের কোড বা একটি সুইচ লেবেল আপনার চোখে পড়ার আগেই true/false-এ পাল্টে যেতে পারে। যে ভ্যালুগুলো আপনি স্ট্রিং হিসেবে বোঝাতে চান সেগুলো কোট করুন।
• সংখ্যা জবরদস্তি। 3.10-এর মতো একটি সংস্করণ তার শেষের শূন্য হারিয়ে 3.1 হয়ে যেতে পারে, আর 1.0 আপনি টেক্সট চাইলেও একটি সংখ্যায় পরিণত হয়। সংস্করণ স্ট্রিং ও আইডি কোট করুন।
• অ্যাংকর ও এলিয়াস উধাও হয়ে যায়। YAML-এর &anchor ও *alias রেফারেন্সের কোনো JSON সমতুল্য নেই। একটি ভালো কনভার্টার সেগুলোকে তাদের পূর্ণ ভ্যালুতে সম্প্রসারিত করে, তাই ডেটা সঠিক থাকে কিন্তু ডুপ্লিকেশন-বিরোধী কৌশলটি হারিয়ে যায় — JSON থেকে YAML থেকে JSON মূল অ্যাংকর পুনর্নির্মাণ করবে না।
• মন্তব্য ও ব্লক স্কেলার। JSON-এ যাওয়ার সময় মন্তব্য বাদ পড়ে। মাল্টি-লাইন ব্লক স্কেলার (| ও >) \n এস্কেপ সহ সাধারণ JSON স্ট্রিং-এ পতিত হয়, তাই ভিজ্যুয়াল ফরম্যাটিং উদ্দেশ্য হারিয়ে যায়।
• YAML-এ ফিরে যাওয়ার সময় ইনডেন্টেশন। JSON ইনডেন্টেশন এনকোড করে না, তাই কনভার্টার একটি সামঞ্জস্যপূর্ণ স্টাইল বেছে নেয়। একটি ট্যাব-সংবেদনশীল টুলে পেস্ট করার আগে এটি পর্যালোচনা করুন।

কেন শুধু স্থানীয় হওয়াটা গুরুত্বপূর্ণ

কনফিগ ফাইল ও API পেলোড ঠিক সেই ধরনের জিনিস যা একটি র‍্যান্ডম সার্ভারে আপলোড করা উচিত নয়: এগুলোতে প্রায়ই হোস্টনেম, টোকেন, অভ্যন্তরীণ সার্ভিস নাম, বা গ্রাহক ডেটা থাকে। এই কনভার্টার পার্স-ও-এমিট ধাপটি আপনার ব্রাউজারে JavaScript দিয়ে চালায়। কিছুই ব্যাকএন্ডে পাঠানো হয় না, কিছুই লগ করা হয় না, এবং পেজ লোড হওয়ার পরে টুলটি অফলাইনেও কাজ করে। একটি Kubernetes সিক্রেট বা একটি CI ওয়ার্কফ্লো নিশ্চিন্তে পেস্ট করুন এই ভরসায় যে এটি আপনার মেশিনেই থাকবে।

সম্পর্কিত টুলিং প্রয়োজন? সম্পূর্ণ ডেটা কনভার্টার সেট ব্রাউজ করুন, JSON ফরম্যাটার দিয়ে অগোছালো ইনপুট পরিষ্কার করুন, এবং API জগৎ ও কনফিগ জগতের মধ্যে যাওয়ার প্রয়োজন হলেই এখানে ফিরে আসুন।

প্রায়শই জিজ্ঞাসিত প্রশ্ন