Dtlaz.Parser 1.2.0

🧬 DTL Parser for .NET

Domain Transport Language Parser - Parse • Convert • Secure • Transform

Parser for DTL (Domain Transport Language) - Ultra-compact, schema-driven, cryptographic data transport format for .NET.

📖 Specification: dtlaz.org | 🌐 AlifZetta: axz.si

🇦🇪 Product of Dubai

Installation

dotnet add package Dtlaz.Parser

Or via NuGet Package Manager:

Install-Package Dtlaz.Parser

Quick Start

using DTL;
using DTL.Converters;

// Parse DTL content
var doc = DTLParser.Parse(@"
@dtlv1.0^dtHC^pMedical^c1^s0^w0^h0
@sec^hash^0x0^none^0

PATIENTS|id:s,name:s,age:i|2|S0|W0|C1
P001|John Doe|45
P002|Jane Smith|32
");

// Access tables
var patients = doc.GetTable("PATIENTS");
foreach (var row in patients.Rows)
{
    Console.WriteLine($"{row["name"]} is {row["age"]} years old");
}

// Create new document
var newDoc = DTLParser.CreateDocument("dtWEB", "pAPI");
DTLParser.AddTable(newDoc, "USERS", 
    new Dictionary<string, string> 
    { 
        { "id", "s" }, 
        { "name", "s" }, 
        { "active", "b" } 
    },
    new List<Dictionary<string, object?>>
    {
        new() { ["id"] = "U001", ["name"] = "Alice", ["active"] = true },
        new() { ["id"] = "U002", ["name"] = "Bob", ["active"] = false },
    }
);

// Write to DTL string
var dtlString = DTLParser.Write(newDoc);

Format Converters

JSON ↔ DTL

using DTL.Converters;

// JSON → DTL
var doc = JsonConverter.FromJson(@"{
    ""users"": [
        { ""id"": 1, ""name"": ""Alice"" },
        { ""id"": 2, ""name"": ""Bob"" }
    ]
}");

// DTL → JSON
var jsonStr = JsonConverter.ToJson(doc);

CSV ↔ DTL

// CSV → DTL
var doc = CsvConverter.FromCsv(@"id,name,score
1,Alice,95
2,Bob,87", tableName: "STUDENTS");

// DTL → CSV
var csvStr = CsvConverter.ToCsv(doc, "STUDENTS");

XML ↔ DTL

// XML → DTL
var doc = XmlConverter.FromXml(@"<users><user id=""1"">Alice</user></users>");

// DTL → XML
var xmlStr = XmlConverter.ToXml(doc);

Auto-detect Format

using DTL.Converters;

// Auto-detect and convert
var doc1 = AutoConverter.ConvertToDtl("{\"data\": [1,2,3]}");    // Detects JSON
var doc2 = AutoConverter.ConvertToDtl("id,name\n1,Alice");       // Detects CSV
var doc3 = AutoConverter.ConvertToDtl("<data>...</data>");       // Detects XML
var doc4 = AutoConverter.ConvertToDtl("@dtlv1.0^dtWEB^...");     // Detects DTL

// Convert DTL to any format
var json = AutoConverter.ConvertFromDtl(doc, "json");
var csv = AutoConverter.ConvertFromDtl(doc, "csv");
var xml = AutoConverter.ConvertFromDtl(doc, "xml");

Working with Tables

var doc = DTLParser.Parse(content);

// Get table
var users = doc.GetTable("USERS");

// Get rows
var rows = doc.GetRows("USERS");

// Query rows
var activeUsers = users.Where(r => (bool)r["active"]);
var admin = users.FirstOrDefault(r => r["id"]?.ToString() == "admin");

// Get column values
var names = users.GetColumn<string>("name");

// Get config value
var apiKey = doc.GetConfig("api_key");

// Check if table exists
if (doc.HasTable("SETTINGS"))
{
    // ...
}

// List all table names
foreach (var name in doc.TableNames)
{
    Console.WriteLine(name);
}

File Operations

// Parse from file
var doc = DTLParser.ParseFile("data.dtl");

// Write to file
DTLParser.WriteFile(doc, "output.dtl");

DTL Types

Target Frameworks

• .NET 6.0, 7.0, 8.0
• .NET Standard 2.0

Related Packages

License

MIT © Padam Sundar Kafle

🇦🇪 Product of Dubai | dtlaz.org • axz.si