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" } ] }