TSCL or Tezz's Simple Configuration Language is a flat Configuration langauge that is mainly used for configurations and other similar ventures. TSCL doesn't have braces and nested braces which could look confusing and messy in the long run.
Instead TSCL has Pointers that points to a Section. In TSCL, this simple langauge contains only 4 parts:
- Sections
- Objects
- Arrays
- Pointers
TSCL has 4 major operations you can use:
- Write : Serializing
- Read : Deserializing
- Modify : File Modification
- Delete : Deletion of Sections or Objects
Sections are basically similar to namespaces that you can group your objects,arrays and pointers.
[Section-Name] # This is the section entry/name
ObjectName="Value" #these are the objects accompanied with their values
Object2= 21
Array="Dave","John","Micheal"
Next=@NextSection
[NextSection]
isActive=false
Members=30
You can add as many objects as you want in any section, TSCL can have any object type because after parsing. Its Typecaster will handle the conversion of the objects value.
[Section1]
Obj=true #boolean
Obj2=200 #Integer
obj3="Name" #String
Obj4=20.80 #float
# And so forth....
TSCL arrays can be any data type now. declaring arrays is simple. You just have to put commas to add a new element to your array:
[Section]
Array="One","Two","Three" # An array of strings
Array2=1,2,3 # An array of integers
Array3=3.2,3.1,3.0 # An Array of floats
# and so on....
Instead of nesting with messy curly braces or retyping a section inside a section, You can just use pointers instead. Pointers are basically objects that point to a Section.
[Section1]
Point=@Section2
[Section2]
isActive=true
Note: Your Pointer value has to always have a '@' symbol at the very start, other wise its just a regular object. And also your Pointer has to have the same name as your target Section
You can also insert comments in your tscl file with the '#' character, because the Parser will ignore any comments and whitespaces. So you can put as much whitespace in between your objects.
TSCL has two modes you can toggle in the Initializer class. Simply set the static bool "isUniversal" to true or false, true if you want to use TSCL's SetFile in Initializer to pass your file, that way all 3 classes will use Initializers Filename instead of their own in their constructor. However when false the 3 classes wont use the initializers, instead it will use what you pass on its constructor.
There is also "isVerbose", which basically prints all the errors in your tscl file. by setting it to true, it prints the errors on your console, but if its false it does not.
Note: Both isVerbose and isUniversal is false by default.
TSCL's data pipeline is relatively simple. Depending on your config whether isUniversal is set to true or false. TSCL's 3 main operations will first scan and tokenize your file/s upon initialization of their classes.
After you have initialized the operations. you can then begin deserializing, serializing or modifying your tscl file.
File/s->Tokenizer(Scans and Tokenizes)->Parser->TypeCaster
To use TSCL just add the namespace on top of your file and call Write to serialize and Read to deserialize. You can also use the Token struct if you want to parse an entire sections objects and use em on your program/app.
using TSCL; // Just Include this namespace to use: Read,Write and Modify
namespace Test{
public class Test{
string[] arr;
public Test(string filename){
Initialize.setFile("FilePath.tscl") //make sure you set your file before using: Read, Write and Modify
Token[] tokens;
//Deserializing
Read read = new Read()// Initialize read
read.setSection("Section1"); //We then set which section to start with
int data = read.GetValue<int>("Object_Name"); //after setting we can grab our datas value with the GetValue().
arr = read.GetArrayValue<string>("Array_Name"); //Or if its an array we can go ahead and use the GetArrayValue().
tokens = read.getSectionObjects("NextSection"); // We can also grab objects of Sections and manually use them.
// in the parameters you can put a section name to advance to that section or use the current section by
// leaving the parameter blank.
initiateFile();
}
public void initiateFile(){ // Serializing
using(Write write = new Write()) // Initialize Write
write.AddSection("SectionName"); // This is how we add our section
write.SetSection("SectionName"); //After adding our section, we need to set to use it, otherwise our current section is null
write.AddObject("key","value",Types.OBJECT) // this is how add our objects, arrays and pointers to our section, object value can be
//int, bool or string. But array values are only string.
write.WriteToFile(); //After we are done, we call the writetofile method, to confirm it.
}
public void FileModification() // File Modification
{
Modify mod = new Modify() //always make sure the file exists
mod.SetSection("Section1"); // Always set your target section before modifying
mod.ModifyObject("Object_Name","NewValue"); // Modify
}
pubic void Delete()
{
string[] skipSections = { "Section1","Section2"}; // Sections you want to skip
Delete del = new Delete("file.tscl",skipSections); // Add your file and array of sections you want to skip when initializing
del.DeleteObject("ObjectName","Section3"); // for deleting an object in a section
del.DeleteSection("Section4"); // for deleting an entire section
}
}
}
To install TSCL you can simple download this on Nuget or in Visual Studio, just go to Manage NuGet Packages and search up TSCL.
This Project is under the GNU General Public License. See the License File for more details.