Read data from strings in XML/JSON/YAML/CSV formats into a tree structure. Create data nodes manually and serialize it back to those formats.
$ dotnet add package LunarLabs.ParserXML/JSON/YAML/CSV parsers for C#.
There already excellent solutions for parsing JSON, XML and YAML in C#. However they usually require one of the following:
Besides that, each file format requires a different library that works in completly different way.
Lunar Parser was written with the intent of making parsing of data as easy as possible and in with a way that makes possible to read or write a JSON or XML using exactly the same code for each.
Get a string and pass it to the proper parser and get data back in a tree structure. It's also possible to manually create your own data nodes and then serialize them into a string. And there's also some utility methods to convert back and forth between data nodes and dictionaries, or even serialize an object to a DataNode in a generic way.
PM> Install-Package LunarParser
Since this is a .NET standard package, to use with .NET framework projects please set the target to .NET Framework 4.5 or higher, otherwise Nuget will give you installation errors.
LunarParser supports:
Import the package:
using LunarParser;
And the formats you want to use, eg:
using LunarParser.XML;
Here's some examples.
// reading XML
var root = XMLReader.ReadFromString("<message><content>Hello world!</content></message>");
var msg = root["message"];
var content = msg.GetString("content");
Console.WriteLine("Message: " + content);
// reading JSON
var root = JSONReader.ReadFromString("{\"message\": { \"content\": \"Hello world!\" } }");
var msg = root["message"];
var content = msg.GetString("content");
Console.WriteLine("Message: " + content);
// writing XML (same could be done for json, using JSONWriter or yaml with YAMLWriter)
var msg = DataSource.CreateObject("message");
msg.AddField("content", "Hello world!");
var xml = XMLWriter.WriteToString(msg);
Console.WriteLine("XML: " + xml);
System.IO.File.WriteAllText("hello.xml", xml);// converting a dictionary to a data node
var dic = new Dictionary<string, string>();
dic["dog"] = "barf";
dic["cat"] = "meow";
dic["fish"] = "blublu";
var data = dic.ToDataSource(dic);
// its also easy to iterate on child nodes
foreach (var child in data.Children) {
Console.WriteLine(child.Name + " = " + child.Value);
}
//same could be done for json, using JSONWriter
var xml = XMLWriter.WriteToString(msg);
Console.WriteLine("XML: " + xml);
// you can also do the opposite...
dic = data.ToDictionary<string>();// converting a hashset to a data node
var set = new HashSet<string>();
set.Add("one");
set.Add("two");
set.Add("three");
var node = set.FromHashSet<string>("my_hashset_name");
// you can also do the opposite...
dic = node.ToHashSet<string>();// Conversion between formats
var xml = File.ReadAllText("some_file.xml");
var root = XMLReader.ReadFromString(content);
var json = JSONWriter.WriteToString(root);
//OR
// content type is auto-detected based on extension
var root = DataFormats.LoadFromFile("some_file.xml");
DataFormats.WriteToFile("some_file.json", root);Lunar Parser automatically converts DateTime to UNIX timestamps (and does the opposite when loading).
So if you serialize it to JSON or XML you will find just a very long number instead of multiple fields.
This saves space without losing any data down to seconds (miliseconds will be lost, any dates before UNIX epoch will be lost).
If this behavior is not suitable for your program, please compile Lunar Parser from source, with the DATETIME_AS_TIMESTAMPS conditional symbol removed.
Lunar Parser supports reading and writing data nodes in a custom binary format.
This format will preserve the tree structure and node values, same as in XML and JSON formats, however it is much faster to parse and write and the file size is smaller.
Very useful to send data in a tree format over a network connection.
In the latest version there is ToObject() / FromDataSource extension methods that allow converting any C# object to a DataSource and back to the same object.
This works by inspecting public fields with reflection. Properties are currently ignored.
However note that those methods are still experimental, and currently they won't supported nested objects, but will work fine with simple structs / classes.
When saving in XML format, by default XMLWriter will save any node that contains zero childs as an attribute instead of full XML node. If this is not desirable, pass true as argument to the expand parameter of XMLWriter.WriteToString
As default, writing XML does not support escaping characters, which can produce invalid XML depending on your input data. If you need this, please pass true to the parameter "escape" of XMLWriter.WriteToString().
The CSV format can not handle nested nodes. This is a limitation of the format itself, so be careful if converting from other formats to CSV.
Let me know if you find bugs or if you have suggestions to improve the code.
And maybe follow me @onihunters :)