WSON (Web Simple Object Notation)

#programming #data #wson #serialization

WSON is a new data serialization format designed to address the shortcomings of JSON and YAML.

GitHub

Syntax Definition

1. Basic Structure

The contents of a WSON file are enclosed in curly baces {}, which represent an object.
An object consists of key-value pairs.
Keys and values are separated by either a colon (:) or an equals sign (=).

2. Comments

Comments begin with // or # and are written on a single line.
Comments apply until the end of the line.
Multi-line comments are not supported; for comments spanning multiple lines, add // or # at the start of each line.

3. Object

An object is enclosed in curly barces {} and contains key-value pairs.
You can use either : or = between keys and values, and both symbols can be mixed within the same object
Each attribute is separated by a comma ,.
Objects can be nested within other objects.

Example:

{
    status: "success",
    code = 200,
    user = {
        id: 123,
        name: "John Doe"
    }
}

4. Array

Arrays are enclosed in square brackets [], and elements are separated by commas ,.
Array elements can include objects, strings, numbers, and other data types.
In WSON, arrays can be nested within objects, and arrays can contain other arrays or objects.

Example:

tasks: [
    {
        task_id: 1,
        title: "Complete project report"
    },
    {
        task_id: 2,
        title: "Review team feedback"
    }
]

5. Key-Value Pair

Attribute names are strings and are followed by either : or =, with the value placed immediately after.
Value types include strings, numbers, booleans, objects, and arrays.
Strings are enclosed in double quotes ".
Numbers are used without quotes and can be integers or floating-point values.

Example:

name: "John Doe"
age = 25

6. Data Types

String: Text enclosed in double quotes ".

"hello world"

Number: An integer or floating-point value.

42
3.14

Boolean: Uses true or false valuse.

is_active = true

Object: Key-value pairs enclosed in curly braces {}.
Array: A list of elements enclosed in square brackets [].

7. Example Explanation

{
    // Status code and message information
    status: "success",
    code: 200,
    message: "Data retrieved successfully",

    user = {
        id = 123,
        name: "John Doe",
        email: "john@example.com",
        age: 25  # User age
    },

    tasks: [
        {
            task_id: 1,
            title: "Complete project report",
            status: "in-progress",
            due_date: "2024-10-15"
        },
        {
            task_id: 2,
            title: "Review team feedback",
            status: "pending",
            due_date: "2024-10-20"
        }
    ]
}