Juple is a Java library that can be used to convert Java objects into a Tuple Markup Language (TML) representation. It can also be used to convert a TML string to an equivalent Java object. Juple can also convert TML to node trees that are searchable by patterns.
The Tuple Markup Language specification was originally written by John Judnich.
Juple uses modified code from Google's Gson which is released as open-source under the Apache Liscense, Version 2.0.
Juple was created to combine the simplicity and elegance of John Judnich's Tuple Markup Language with the versatility and power of Google's Gson.
Documentation:
- README.md this file
- USER_GUIDE.md illustrates how to use Juple (link)
- SYNTAX.md highlights how Juple interprets TML (link)
- LICENSE the license (link)
The com.sudoplay.juple
package contains several classes of interest:
- Juple serializes and deserializes Java objects to and from TML.
- JupleBuilder builds a Juple instance with user defined settings.
- TMLNodeTreeParser parses TML into a pattern searchable node tree.
- TMLReader is a wrapper for java.io.Reader with methods to assert syntax and read data.
- TMLWriter is a wrapper for java.io.Writer with methods to assert syntax and write data.
It is very simple to create a Java object from its TML representation using Juple.
[
[ name | Ethereal Filcher ]
[ life | 22 ]
[ location |
[ x | 6.2 ]
[ y | 5.4 ]
[ z | -3.14 ]
]
[ ethereal | true ]
]
public class Vector3f {
public float x, y, z;
public Vector3f() {}
}
public class Monster {
private String name;
private int life;
private Vector3f location;
private boolean ethereal;
public Monster() {}
}
Juple juple = new Juple();
Monster monster = juple.fromTML(reader, Monster.class);
For more examples, check out the examples folder.
Copyright © 2013 Jason Taylor. Released as open-source under Apache License, Version 2.0.