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

JSON একটি বহুল ব্যবহৃত ডেটা ইন্টারচেঞ্জ ফরম্যাট, কিন্তু কনফিগারেশন ফাইলের জন্য TOML (Tom's Obvious, Minimal Language) ক্রমশ জনপ্রিয় হয়ে উঠছে। এটি বিশেষভাবে কনফিগারেশন লেখার জন্য তৈরি, যা মানুষ সহজে পড়তে ও লিখতে পারে। Rust-এর Cargo.toml, Python-এর pyproject.toml, Go, Hugo স্ট্যাটিক সাইট জেনারেটরসহ অসংখ্য টুল TOML ব্যবহার করে। JSON থেকে TOML কনভার্টার হল এমন একটি টুল যা JSON ফরম্যাটের ডেটাকে TOML ফরম্যাটে রূপান্তর করে, ফলে ডেভেলপাররা API রেসপন্স, কনফিগারেশন টেমপ্লেট বা যেকোনো JSON ডেটাকে TOML-ভিত্তিক সিস্টেমে সহজে স্থানান্তর করতে পারে। বিশেষ করে যখন একটি প্রোজেক্টে কনফিগারেশন ব্যবস্থাপনা JSON থেকে TOML-এ সরিয়ে নেওয়া হয়, তখন পুরনো JSON কনফিগ ফাইলগুলোকে হাতেকলমে রূপান্তর করার ঝামেলা এড়াতে এই কনভার্টার অত্যন্ত কার্যকর। এছাড়া কোনো API থেকে প্রাপ্ত JSON ডেটা সরাসরি কোনো TOML কনফিগারেশন জেনারেটরে ফিড করতেও এটি সাহায্য করে। স্থানীয় ডেভেলপারদের জন্যও, যারা হয়তো পাইথনের পয়েট্রি প্রোজেক্টে pyproject.toml তৈরি করছেন বা রাস্টের কার্গো প্রোজেক্ট সেটআপ করছেন, তাদের কাছে এই টুল সময় বাঁচানোর একটি চমৎকার উপায়। এটি সম্পূর্ণ ওয়েব-ভিত্তিক এবং কোনো ইনস্টলেশন ছাড়াই ব্রাউজার থেকে ব্যবহার করা যায়। আপনি বিপরীত রূপান্তর চাইলে টমল থেকে জেসন কনভার্টার ব্যবহার করতে পারেন। JSON ডেটা পরিষ্কার করতে চাইলে আগে জেসন ফরম্যাটার কাজে লাগতে পারে।

JSON (JavaScript Object Notation) সম্পূর্ণরূপে অবজেক্ট ও অ্যারের ধারণার ওপর ভিত্তি করে; এটি মেশিনের জন্য দ্রুত পার্স করা সহজ, কিন্তু মানুষ যখন বড় কনফিগারেশন ফাইল পড়তে চায়, তখন এর সিনট্যাক্স কিছুটা জটিল মনে হয়। JSON-এ সবকিছু কোঁকড়া ব্র্যাকেট {} ও স্কোয়ার ব্র্যাকেট [] দিয়ে আবদ্ধ থাকে, স্ট্রিং কী-এর জন্য ডাবল কোটেশন আবশ্যক এবং কমা সঠিকভাবে বসানো চ্যালেঞ্জিং। অন্যদিকে TOML একটি কনফিগারেশন-কেন্দ্রিক ভাষা, যেখানে টেবিল [table] এবং ইনলাইন টেবিল ব্যবহার করে ডেটা সাজানো হয়। TOML-এ কী-ভ্যালু পেয়ার লেখা হয় সহজবোধ্য key = "value" আকারে, কী-তে কোটেশন ঐচ্ছিক, এবং হোয়াইটস্পেস সহনশীল। এটি কমেন্ট সাপোর্ট করে (# দিয়ে), যা JSON-এ সম্ভব নয়। TOML-এ বিভিন্ন ডেটা টাইপ: স্ট্রিং, ইন্টিজার, ফ্লোট, বুলিয়ান, ডেটটাইম, অ্যারে এবং টেবিল। JSON-এ ডেটটাইমের কোনো বিল্ট-ইন সাপোর্ট নেই, তাই রূপান্তরের সময় JSON-এর স্ট্রিংয়ে থাকা ISO ১৯ মার্চ, ২০২৫ ফরম্যাটের তারিখকে TOML চিহ্নিত করতে পারে যদি তা অফসেট বা লোকাল টাইম সহ হয়। তবে সরাসরি রূপান্তরকারী সাধারণত তারিখ শনাক্তকরণের চেষ্টা করে না, কিন্তু উন্নত টুল কখনো কখনো সেটি করে। আরেকটি বড় পার্থক্য হলো TOML-এ টেবিলের অ্যারে [[array.of.tables]] সাপোর্ট করে যা JSON-এর অবজেক্টের অ্যারের সমতুল্য কিন্তু অনেক ব্যাখ্যাযোগ্য। JSON-এর নেস্টেড অবজেক্টকে TOML-এ সাধারণত ডট নোটেশন দিয়ে টেবিল হিসেবে উপস্থাপন করা হয়: একটি অবজেক্ট {"server": {"host": "localhost", "port": ৮,০৮০}} TOML-এ হবে [server]\nhost = "localhost"\nport = ৮,০৮০। এই পার্থক্যগুলো বোঝা রূপান্তরের মান উন্নত করে।

JSON থেকে TOML কনভার্টার প্রথমে ইনপুট JSON স্ট্রিংকে পার্স করে একটি ইন্টারনাল ডেটা স্ট্রাকচারে রূপান্তর করে। এই পার্সিং ধাপে JSON-এর সিনট্যাক্স যাচাই করা হয়; কোনো ত্রুটি থাকলে ব্যবহারকারীকে জানানো হয়। সফল পার্সিং-এর পর টুলটি ডেটা ট্রি ট্রাভার্স করে প্রতিটি কী-ভ্যালু পেয়ার ও নেস্টেড স্ট্রাকচারকে TOML সিনট্যাক্স অনুযায়ী ম্যাপ করে। টপ-লেভেল কী-ভ্যালু পেয়ার সরাসরি key = value আকারে লেখা হয়। কোনো মান যদি অবজেক্ট হয়, তবে তার কী-গুলোর ভিত্তিতে একটি [parent] টেবিল তৈরি করে সব শিশুকী সেই টেবিলের অধীনে বসায়। নেস্টেড অবজেক্টের আরও গভীর স্তরে গেলে TOML-এ ডট নোটেশনযুক্ত টেবিল তৈরি হয়, যেমন [parent.child]। JSON অ্যারেগুলো TOML-এ সাধারণ অ্যারে হিসেবে রূপান্তরিত হয় arr = [1, 2, 3]। কিন্তু যদি অ্যারের প্রতিটি আইটেম নিজেই অবজেক্ট হয় এবং তা টেবিলের অ্যারে হিসেবে প্রকাশ করা ভালো হয়, তাহলে কিছু কনভার্টার [[parent]] ডাবল ব্র্যাকেট সিনট্যাক্স ব্যবহার করে। আমাদের টুলটি বুদ্ধিমত্তার সাথে সিদ্ধান্ত নেয়: যদি অ্যারের সব উপাদান একই কাঠামোর অবজেক্ট হয় এবং টপ-লেভেল টেবিল না হয়, তাহলে টেবিলের অ্যারে তৈরি করে, অন্যথায় ইনলাইন অ্যারে ব্যবহার করে। স্ট্রিং এস্কেপিংয়েও মনোযোগ দেওয়া হয়: JSON-এ ইউনিকোড এস্কেপ \uXXXX সরাসরি TOML-এ ইউনিকোড ক্যারেক্টার বা প্রয়োজনীয় এস্কেপিংয়ে রূপান্তর হয়। বুলিয়ান true/false ও null TOML-এ যথাক্রমে true, false ও null হয় (TOML-এ null নেই, তাই অনেক সময় ফাঁকা মান বাদ দেওয়া হয় বা খালি স্ট্রিং হিসেবে ধরা হয়, কিন্তু কনভার্টারটি সাধারণত null কে স্ট্রিং বা বাদ দিয়ে দেয়, ব্যবহারকারীর পছন্দের ওপর নির্ভর করে)। ফলস্বরূপ আউটপুট TOML স্ট্রিং জেনারেট করা হয়, যা সরাসরি কপি করে ফাইলে সংরক্ষণযোগ্য। পুরো প্রক্রিয়াটি ক্লায়েন্ট-সাইডে সম্পন্ন হয়, তাই আপনার ডেটা সার্ভারে যায় না। রূপান্তর শেষে আউটপুট প্রদর্শিত হলে আপনি জেসন ফরম্যাটার দিয়ে আগে JSON টি সুন্দর করে নিতে পারেন যাতে নিখুঁত রূপান্তর হয়। বিপরীত প্রয়োজনে টমল থেকে জেসন কনভার্টার-ও আমাদের সিরিজেই আছে।

বাস্তব জীবনের JSON ডেটাতে প্রায়শই গভীরভাবে নেস্টেড অবজেক্ট, মিশ্র অ্যারে এবং ইউনিকোড বা এস্কেপড ক্যারেক্টার থাকে। JSON থেকে TOML কনভার্টার এই জটিলতাগুলো দক্ষতার সঙ্গে সামাল দেয়। উদাহরণস্বরূপ, একটি ই-কমার্স সাইটের প্রোডাক্ট ক্যাটালগ JSON-এ {"products": [{"id": ১০১, "name": "স্মার্টফোন", "specs": {"ram": "৪ জিবি", "storage": "৬৪ জিবি"}}]} থাকতে পারে। এখানে products অ্যারেটি একই স্ট্রাকচারের অবজেক্ট ধারণ করছে, তাই টুলটি একে TOML-এ টেবিলের অ্যারে হিসেবে রূপান্তর করবে: [[products]]\nid = ১০১\nname = "স্মার্টফোন"\n[products.specs]\nram = "৪ জিবি"\nstorage = "৬৪ জিবি"। এই রূপান্তর মানুষকে দ্রুত বুঝতে সাহায্য করে যে প্রতিটি পণ্যের স্পেসিফিকেশন কী। তবে যদি অ্যারের উপাদানগুলোর গঠন ভিন্ন হয়, যেমন একটি অবজেক্ট, একটি স্ট্রিং, আরেকটি সংখ্যা, তাহলে TOML-এ ইনলাইন অ্যারে arr = [{...}, "text", ১০] ব্যবহার করা হয়, যা JSON-এর কাছাকাছি থাকে। বিশেষ অক্ষরের ক্ষেত্রে, JSON-এ \n, \t ইত্যাদি এস্কেপ সিকোয়েন্স TOML-এ সরাসরি প্রযোজ্য নয়; TOML-এ স্ট্রিং বেসিক স্ট্রিং (ডাবল কোট) অথবা লিটারেল স্ট্রিং (সিঙ্গেল কোট) হতে পারে। কনভার্টারটি JSON স্ট্রিংয়ের কন্টেন্ট অনুযায়ী সঠিক TOML স্ট্রিং টাইপ ও এস্কেপিং নির্ধারণ করে। যেমন, যদি স্ট্রিংয়ে ব্যাকস্ল্যাশ ও উদ্ধৃতি চিহ্ন মিশ্র থাকে, তাহলে এটি স্বয়ংক্রিয়ভাবে লিটারেল স্ট্রিং বা প্রয়োজনীয় এস্কেপ বেছে নেয়। এছাড়া TOML-এ ৬৪ বিট ইন্টিজার বা ফ্লোট সমর্থন করে, JSON-এর 1e3 ফ্লোট সরাসরি 1e3 লেখা হয়। ডেটটাইমের ক্ষেত্রে, যদি JSON-এ স্ট্রিং "2025-03-19T10:30:00Z" থাকে, উন্নত কনভার্টার একে 2025-03-19T10:30:00Z অথবা অফসেট ডেটটাইম হিসেবে আউটপুট করতে পারে, কিন্তু বেসিক কনভার্টার তাকে শুধু স্ট্রিং হিসেবে রেখে দেয়। আমাদের টুলটি ব্যবহারকারীকে একটি অপশন দিতে পারে যে TOML ডেটটাইম টাইপে রূপান্তর করবে কিনা, বা নিরাপদে স্ট্রিং রাখবে। ফলে ডেটার বিশ্বস্ততা রক্ষা পায়। সংক্ষেপে, জটিল নেস্টিং ও বিশেষ ক্যারেক্টার নিয়ে চিন্তা না করেই আপনি নির্ভরযোগ্য রূপান্তর পাবেন, যা মাইগ্রেশনকে সহজতর করে। আপনার যদি YAML কনফিগারেশনের প্রয়োজন হয়, জেসন থেকে ইয়ামল কনভার্টার ব্যবহার করতে পারেন।

JSON থেকে TOML কনভার্টারের ব্যবহারিক প্রয়োগ ব্যাপক। প্রথমত, আধুনিক ডেভেলপমেন্টে কনফিগারেশন ফাইল মাইগ্রেশন। ধরুন আপনার একটি নোড.জেএস প্রোজেক্ট আগে .json কনফিগ ফাইল ব্যবহার করত, এখন আপনি পাইথন বা রাস্টে পোর্ট করছেন এবং pyproject.toml বা Cargo.toml ব্যবহার করতে চান। পুরোনো জেসন কনফিগকে সরাসরি টুলে দিয়ে TOML প্রাপ্তি সময় বাঁচায় এবং ম্যানুয়াল ভুল এড়ায়। দ্বিতীয়ত, API রেসপন্স ট্রান্সফরমেশন। অনেক সময় ব্যাকএন্ড থেকে JSON ফরম্যাটে কনফিগারেশন ডেটা আসে যা কোনো TOML-ভিত্তিক টুলে ফিড করতে হয়, যেমন Hugo সাইটের কনফিগারেশন জেনারেটর বা CI/CD পাইপলাইনের কোনো স্টেজ যা TOML ইনপুট নেয়। কনভার্টার সেই ডেটাকে অনায়াসে প্রয়োজনীয় ফরম্যাটে দিতে পারে। তৃতীয়ত, ডেটা ইন্টারচেঞ্জ। বিভিন্ন মাইক্রোসার্ভিসের মধ্যে যদি একটি JSON আউটপুট দেয় আর অন্যটি TOML আশা করে, তবে মাঝখানে ম্যানুয়াল স্ক্রিপ্টের বদলে এই টুল সহজ সমাধান। চতুর্থত, শিক্ষা ও ডিবাগিং। যে কেউ TOML-এর সিনট্যাক্স শিখছেন, তারা পরিচিত JSON ডেটাকে TOML-এ রূপান্তর করে দেখতে পারেন কাঠামোটি কেমন হয়, ফলে শেখা ত্বরান্বিত হয়। পঞ্চমত, স্ট্যাটিক সাইট জেনারেটর: বাংলাদেশের অনেক ডেভেলপার এখন Hugo ব্যবহার করে ব্লগ বা ডকুমেন্টেশন সাইট তৈরি করছেন, যেখানে config.toml অপরিহার্য। আগের JSON কনফিগ থেকে সরাসরি TOML ফাইল তৈরি করতে এই কনভার্টার সহায়ক। অবশেষে, প্যাকেজ ম্যানেজমেন্ট: Python Poetry, Rust Cargo, Go modules প্রভৃতির জন্য কনফিগার ফাইল প্রস্তুত করার সময় আপনি সহজেই JSON টেম্পলেট থেকে শুরু করতে পারেন। সবক্ষেত্রেই টুলটি দ্রুত, নির্ভুল এবং ব্যবহারকারী-বান্ধব, যা উন্নয়নের গতিকে ত্বরান্বিত করে। আপনি চাইলে আউটপুট TOML ফাইল চেক করতে টমল থেকে জেসন কনভার্টার দিয়ে পুনরায় JSON-এ ফিরিয়ে তুলনা করতে পারেন, নির্ভুলতা নিশ্চিত করতে।

JSON থেকে TOML রূপান্তরকে সাধারণত লসলেস বলা যায় কি না, তা নির্ভর করে ডেটার ধরনের ওপর। গাণিতিক মান, স্ট্রিং, বুলিয়ান এবং নেস্টেড অবজেক্টের বিন্যাস সম্পূর্ণ অপরিবর্তিত থাকে যদি TOML-এর সীমাবদ্ধতা এতে বাধা না দেয়। TOML-এ null টাইপ নেই, তাই JSON-এর null মানকে কনভার্টার সাধারণত বাদ দেয় বা খালি স্ট্রিং "" দেয়, যা সবসময় পূর্ণাঙ্গ পুনরুদ্ধারযোগ্য নয়। এ কারণে কঠোর লসলেস রূপান্তরের জন্য null হ্যান্ডলিং একটি চ্যালেঞ্জ। আমাদের টুলটি ডিফল্টভাবে null মানকে বাদ দিয়ে একটি সতর্কতা দেখাতে পারে, অথবা একটি বিশেষ সেন্টিনেল মান দিয়ে প্রতিস্থাপন করতে পারে। যেসব কী-তে স্পেস বা বিশেষ ক্যারেক্টার থাকে, TOML-এ কী কোটেড হতে পারে এবং তা JSON-এ কোঁকড়া ব্র্যাকেটে স্ট্রিং কি ঠিকভাবে ম্যাপ হয়। ইনলাইন টেবিল ও টেবিলের অ্যারের মধ্যে পার্থক্যও কিছু ক্ষেত্রে রি-কনভার্ট করলে কিছু কাঠামোগত ভিন্নতা দেখা দিতে পারে, যেমন TOML-এ [a.b] এবং [a]\n[b] সমতুল্য কিন্তু JSON-এ ইন্টারপ্রিটেশন এক। আবার ইনলাইন অ্যারে ও টেবিলের অ্যারে বিনিময়যোগ্য নয়; যদি কনভার্টার টেবিলের অ্যারে বানায়, তা বিপরীত কনভার্সনে সেই অ্যারেটি JSON-এ {"a": [{"b": ...}]} পাবে, যা আসল JSON-এর মতোই। তবে একটি খেয়াল রাখার বিষয় হলো TOML-এ কী অর্ডার সাধারণত সংরক্ষিত থাকে না (পার্সার-নির্ভর), কিন্তু আমাদের কনভার্টার অর্ডার যথাসম্ভব বজায় রাখে। বাস্তবে অধিকাংশ কনফিগারেশন ফাইলের জন্য এই সামান্য পার্থক্য কোনো সমস্যা সৃষ্টি করে না, কারণ TOML-ভিত্তিক সিস্টেম কী-এর ক্রমে নির্ভর করে না। এছাড়া সংখ্যার নির্ভুলতা: JSON-এ সব সংখ্যা ফ্লোটিং পয়েন্ট হিসেবে ধরা হয়, কিন্তু TOML ইন্টিজার ও ফ্লোট আলাদাভাবে সংরক্ষণ করে, ফলে ৫ এবং ৫ আলাদা হতে পারে। টুলটি যেখানে সম্ভব JSON-এর 5 কে TOML ইন্টিজার হিসেবে রূপান্তর করে, যা বেশিরভাগ ক্ষেত্রে কাঙ্ক্ষিত। ডেটটাইম রূপান্তরের ঐচ্ছিকতা এবং স্ট্রিং এনকোডিংয়ের কারণে রূপান্তর পুরোপুরি বিডিরেকশনাল লসলেস নাও হতে পারে, কিন্তু একমুখী অভিপ্রায়ে তা শতভাগ কার্যকর। আপনি রূপান্তরের আগে জেসন ফরম্যাটার দিয়ে ইনপুট JSON সুন্দর করে নিলে কার্যকারিতা উন্নত হয় এবং ত্রুটির সম্ভাবনা কমে। পরিশেষে, এই কনভার্টার প্র্যাকটিক্যাল কেসে অত্যন্ত নির্ভরযোগ্য, এবং ডেভেলপারদের মাইগ্রেশন প্রয়োজনে এটি প্রথম সারির হাতিয়ার।