am1goo.Ston.Net 1.0.0

Ston.Net

STON (Strong Typed Object Notation) - another way to make a deal with configuration files.
It's easy to use and give to you unlimited power to control every field or property in your file.

Syntax

Parameter key and his type shoud be separate by colon symbol :.
Value should be next after equals sign =. \

• Primitive and custom types, also enums: {param name}:{type} = {value}
• Arrays: {array name} = [ .. any values between brackets .. ]
• Objects: {object name} = { .. any properties between braces .. }

Built-in primitive types:

• b - boolean
• bt - byte
• sbt - signed byte
• s - short (int16)
• us - unsigned short (uint16)
• i - integer (int32)
• ui - unsigned integer (uint32)
• l - long (int64)
• ul - unsigned long (uint64)
• f - single aka float
• d - double
• dec - decimal
• t - string
• e - enums
• url - path to external file

File format

#this is a comment

#b - means "boolean" and can be one of case-insensitives values 'yes' or '1' or 'tRuE' or 'no' or '0' or 'fAlSe'
param_1:b = yes

#i - means "integer"
param_2:i = -123

#f - means "float"
param_3:f = 32.32

#t - means "text" or "string"
param_4:t = this is a single line

param_5:t = "and this is a multi line
also called \"The King of Strings\".
It's not a joke!"

#objects should be mapped w/o any type
obj_1 = {
  field_1:t = "I'm a first field"
  field_2:s = 123
  field_3 = {
    arg_1:i = 123
    arg_2:sbt = 4
  }
}

#arrays should be mapped w/o any type as well
#also all array values can no have names
array_1 = [
  :t = "first element"
  :t = second element
  :t = 3rd element
]

#any inline objects should be mapped via type 'url'
obj = {
  internal:url = file:///home/user/internal.ston
  external:url = http://youhostname.domain/files/external.ston
}

Features

• All types of primitive types
• Enum deserialization from strings or numbers
• Single-line and multi-line strings
• Ability to inline any amount of inherit files (from local files or web servers)
• Customization of deserialization process (you can add support to any your custom types!)

Known limitations

• Currently only deserialization is supported.

Requirements

• .NET Core App 2.0 or higher
• .NET Standard 2.1 or higher
• .NET Core 5.0 and higher

Contribute

Contribution in any form is very welcome. Bugs, feature requests or feedback can be reported in form of Issues.