The Serializer package provides convenient classes for reading and writing data. It also support many standard formats like plain text, XML, JSON or YAML.

Any class of this package can be used with a print statement.

load serializer.json-stream
load system.file

if stream = Serializer.JsonStream(System.open('./target/path', 'w')) {
	print (stream) {
		{
			'first': true,
			'next': 0.5,
			'last': 'foo'
		}
	}
}

A stream class must, at least, provide 2 methods: read and write.

It can also provides extra methods depending on the stream kind.

For byte based stream the class can provide the following methods:

• readSome for reading up to a specified amount of bytes

For text based stream the class can provide the following methods:

• readChar for reading one character after the other
• readWord for reading one word after the other
• readUntil for reading text until a separator
• readLine for reading one line after the other
• readLines to iterate over each lines

An other stream can be used to construct a stream instance. It allow to create a stream chain to provide missing features. For example, the Serializer.BufferedStream class add buffering to a classes where reading may be expensive. The Serializer.TextStream class provides a text based interface to byte based streams. An instance of this class can then be used to create a bridge between an instance of Serializer.YamlStream and a custom stream class.

Some other classes can act like a stream like System.File.

• Serializer.BufferedStream
• Serializer.DataStream
• Serializer.DocumentStream
• Serializer.JsonStream
• Serializer.StringStream
• Serializer.TextStream
• Serializer.XmlAttribute
• Serializer.XmlAttributes
• Serializer.XmlDomAttribute
• Serializer.XmlDomCData
• Serializer.XmlDomCharacterData
• Serializer.XmlDomComment
• Serializer.XmlDomDocument
• Serializer.XmlDomDocumentFragment
• Serializer.XmlDomDtd
• Serializer.XmlDomElement
• Serializer.XmlDomException
• Serializer.XmlDomNamedNodeMap
• Serializer.XmlDomNode
• Serializer.XmlDomProcessingInstruction
• Serializer.XmlDomStream
• Serializer.XmlDomText
• Serializer.XmlSaxHandle
• Serializer.XmlSaxStream
• Serializer.XmlStream
• Serializer.YamlAlias
• Serializer.YamlComment
• Serializer.YamlDirective
• Serializer.YamlDocument
• Serializer.YamlMapping
• Serializer.YamlScalar
• Serializer.YamlSequence
• Serializer.YamlStream
• Serializer.YamlTag