TOML থেকে JSON

TOML থেকে JSON রূপান্তর কী?

TOML (Tom's Obvious Minimal Language) হলো মানুষের জন্য ডিজাইন করা একটি কনফিগারেশন ফাইল ফরম্যাট। এটি স্পষ্টভাবে একটি হ্যাশ টেবিলে ম্যাপ করে, নেস্টেড টেবিল, টাইপড মান এবং ইনলাইন কমেন্ট সমর্থন করে। অনেক টুল ও ফ্রেমওয়ার্ক TOML-কে প্রাথমিক কনফিগ ফরম্যাট হিসেবে ব্যবহার করে: Rust প্রকল্পগুলো Cargo.toml-এর উপর নির্ভর করে, Python প্যাকেজিং pyproject.toml ব্যবহার করে এবং Hugo স্ট্যাটিক সাইটগুলো config.toml-এর মাধ্যমে কনফিগার করা হয়। অনলাইনে TOML থেকে JSON-এ রূপান্তর করলে এই কনফিগারেশন ফাইলগুলোকে এমন একটি ফরম্যাটে রূপান্তর করা যায় যা প্রায় প্রতিটি প্রোগ্রামিং ভাষা, API এবং ডেটা পাইপলাইন সরাসরি ব্যবহার করতে পারে।

JSON (JavaScript Object Notation) — যা RFC 8259 দ্বারা সংজ্ঞায়িত — হলো সবচেয়ে ব্যাপকভাবে সমর্থিত ডেটা ইন্টারচেঞ্জ ফরম্যাট। TOML তার ন্যূনতম সিনট্যাক্স ও কমেন্ট সমর্থনের মাধ্যমে মানব-পাঠযোগ্যতাকে অগ্রাধিকার দেয়, আর JSON মেশিন ইন্টারঅপারেবিলিটিকে অগ্রাধিকার দেয়। একটি TOML থেকে JSON কনভার্টার TOML v1.0.0 স্পেসিফিকেশন অনুযায়ী TOML ইনপুট পার্স করে এবং কাঠামোগতভাবে সমতুল্য একটি JSON ডকুমেন্ট তৈরি করে এই ব্যবধান পূরণ করে। রূপান্তরটি সমস্ত ডেটা সংরক্ষণ করে: স্ট্রিং, ইন্টিজার, ফ্লোট, বুলিয়ান, অ্যারে এবং টেবিল সরাসরি তাদের JSON সমতুল্যে ম্যাপ হয়।

TOML-এর চারটি নেটিভ তারিখ/সময় টাইপ আছে যা JSON সরাসরি উপস্থাপন করতে পারে না: অফসেট ডেট-টাইম, লোকাল ডেট-টাইম, লোকাল ডেট এবং লোকাল টাইম। JSON-এ কোনো ডেট টাইপ নেই, তাই রূপান্তরের সময় এই মানগুলো ISO 8601 স্ট্রিং হিসেবে সিরিয়ালাইজ করা হয়।

কেন TOML থেকে JSON কনভার্টার ব্যবহার করবেন?

TOML-এ লেখা কনফিগারেশন ফাইলগুলো প্রায়ই এমন সিস্টেমে ফিড করতে হয় যা শুধুমাত্র JSON গ্রহণ করে। হাতে ফাইল পুনরায় লেখা বা লোকালি একটি পার্সার লাইব্রেরি ইনস্টল করার পরিবর্তে, একটি ব্রাউজার-ভিত্তিক কনভার্টার মাত্র সেকেন্ডে রূপান্তর সম্পন্ন করে।

TOML থেকে JSON ব্যবহারের ক্ষেত্র

TOML থেকে JSON টাইপ ম্যাপিং রেফারেন্স

প্রতিটি TOML টাইপের একটি সরাসরি JSON সমতুল্য আছে, একটি ব্যতিক্রম বাদে: তারিখ ও সময়ের মান। নিচের টেবিলটি দেখায় প্রতিটি TOML টাইপ কীভাবে JSON-এ রূপান্তরিত হয়। এই ম্যাপিং TOML v1.0.0 স্পেসিফিকেশন অনুসরণ করে এবং tomllib (Python), toml-rs (Rust) ও @iarna/toml (Node.js)-এর মতো স্ট্যান্ডার্ড পার্সারের আচরণের সাথে মেলে।

TOML ইন্টিজার পাঠযোগ্যতার জন্য আন্ডারস্কোর সমর্থন করে (যেমন 1_000_000) এবং হেক্সাডেসিমাল (0xDEADBEEF), অক্টাল (0o755) ও বাইনারি (0b11010110) লিটেরেল সমর্থন করে। এগুলো সবই JSON-এ সরল দশমিক সংখ্যায় রূপান্তরিত হয়। TOML ইনফিনিটি ও NaN ফ্লোট মানও সমর্থন করে, কিন্তু এগুলোর কোনো JSON উপস্থাপনা নেই এবং স্ট্রিক্ট মোডে রূপান্তর ত্রুটি সৃষ্টি করবে।

কোড উদাহরণ

চারটি ভাষায় TOML থেকে JSON রূপান্তরের কার্যকরী উদাহরণ। প্রতিটি একটি TOML ফাইল পড়ে, পার্স করে এবং ফরম্যাট করা JSON আউটপুট দেয়।

import { parse } from '@iarna/toml'
import fs from 'fs'

const toml = fs.readFileSync('config.toml', 'utf8')
const json = parse(toml)
console.log(JSON.stringify(json, null, 2))
// Input:  [server]
//         host = "localhost"
//         port = 8080
// Output: { "server": { "host": "localhost", "port": 8080 } }

import tomllib   # Python 3.11+ (standard library)
import json

with open('config.toml', 'rb') as f:
    data = tomllib.load(f)

print(json.dumps(data, indent=2, default=str))
# Dates become strings: "1979-05-27"
# Arrays of tables become JSON arrays of objects

package main

import (
    "encoding/json"
    "fmt"
    "os"

    "github.com/BurntSushi/toml"
)

func main() {
    var data map[string]any
    _, err := toml.DecodeFile("config.toml", &data)
    if err != nil {
        panic(err)
    }
    out, _ := json.MarshalIndent(data, "", "  ")
    fmt.Println(string(out))
}

# Using yj (YAML/JSON/TOML converter)
cat config.toml | yj -tj

# Using dasel
dasel -f config.toml -r toml -w json

# Using Python one-liner (3.11+)
python3 -c "import tomllib, json, sys; print(json.dumps(tomllib.load(sys.stdin.buffer), indent=2, default=str))" < config.toml

সচরাচর জিজ্ঞাসা