TLio.Client
1.3.0-preview.6
See the version list below for details.
dotnet add package TLio.Client --version 1.3.0-preview.6
NuGet\Install-Package TLio.Client -Version 1.3.0-preview.6
<PackageReference Include="TLio.Client" Version="1.3.0-preview.6" />
<PackageVersion Include="TLio.Client" Version="1.3.0-preview.6" />
<PackageReference Include="TLio.Client" />
paket add TLio.Client --version 1.3.0-preview.6
#r "nuget: TLio.Client, 1.3.0-preview.6"
#:package TLio.Client@1.3.0-preview.6
#addin nuget:?package=TLio.Client&version=1.3.0-preview.6&prerelease
#tool nuget:?package=TLio.Client&version=1.3.0-preview.6&prerelease
TLio.Client
The scripting engine for TLio — parses and executes TLio scripts against any structured data format. Format-neutral: format support is registered through the provider pattern.
dotnet add package TLio.Client
Quick start (JSON)
using Newtonsoft.Json.Linq;
using TLio.Client;
using TLio.Json;
var options = ParseOptions<JToken>.CreateDefault();
var engine = new ScriptEngine<JToken>(options.CommandsProvider, options.FunctionsProvider);
var result = engine.Execute(scriptJson, data, JsonExecutionContext.CreateDefault());
A script is a plain array of command objects:
[
{ "command": "put", "path": "$.status", "value": "active" },
{ "command": "add", "path": "$.createdAt", "value": "=datetime()" },
{ "command": "remove", "path": "$.tempId" }
]
Writing the script in XML or YAML
The same script has an XML and a YAML spelling. The notation is independent of the format of the data — only the paths inside the script have to speak the data's path language. JSON works out of the box; the other two register in a line each:
var engine = new ScriptEngine<JToken>(options.CommandsProvider, options.FunctionsProvider)
.UseXmlScripts() // TLio.Xml
.UseYamlScripts(); // TLio.Yaml
engine.Execute(scriptText, data, context); // notation detected from the text
engine.Execute(scriptText, ScriptFormat.Xml, data, context); // or stated outright
<script>
<put path="$.status">active</put>
<add path="$.createdAt">=datetime()</add>
<remove path="$.tempId"/>
</script>
- command: put
path: $.status
value: active
- command: add
path: $.createdAt
value: "=datetime()"
- command: remove
path: $.tempId
Text that does not parse yields an empty script carrying the reason in
TLioScript.ParseWarnings rather than throwing.
What's in the box
ScriptEngine<TNode>— parse and execute scripts in any of the three notationsCompiledScript<TNode>— parse once, execute many timesParseOptions<TNode>— command and function registriesTLioConvert— fluent convenience API
Registering extension packs
options.CommandsProvider.RegisterETL<JToken>(); // TLio.Extensions.ETL
options.FunctionsProvider.RegisterText<JToken>(); // TLio.Extensions.Text
options.FunctionsProvider.RegisterMath<JToken>(); // TLio.Extensions.Math
options.FunctionsProvider.RegisterTimeDate<JToken>(); // TLio.Extensions.TimeDate
Pick a format adapter
| Format | Package | Context factory |
|---|---|---|
| JSON (Newtonsoft) | TLio.Json |
JsonExecutionContext.CreateDefault() |
| JSON (System.Text.Json) | TLio.Json.SystemText |
SystemTextJsonExecutionContext.CreateDefault() |
| XML | TLio.Xml |
XmlExecutionContext.CreateWithSlashPaths() / CreateWithNativeXPath() |
| YAML | TLio.Yaml |
YamlExecutionContext.CreateDefault() |
License
MIT — see the repository.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- TLio.Commands (>= 1.3.0-preview.6)
- TLio.Core (>= 1.3.0-preview.6)
- TLio.Functions (>= 1.3.0-preview.6)
-
net8.0
- TLio.Commands (>= 1.3.0-preview.6)
- TLio.Core (>= 1.3.0-preview.6)
- TLio.Functions (>= 1.3.0-preview.6)
-
net9.0
- TLio.Commands (>= 1.3.0-preview.6)
- TLio.Core (>= 1.3.0-preview.6)
- TLio.Functions (>= 1.3.0-preview.6)
NuGet packages (3)
Showing the top 3 NuGet packages that depend on TLio.Client:
| Package | Downloads |
|---|---|
|
TLio.Yaml
TLio YAML adapter: INodeAdapter and IItemsFetcher implementations. Depends on YamlDotNet. |
|
|
TLio.Xml
TLio XML adapter: INodeAdapter and IItemsFetcher implementations backed by System.Xml.Linq (XElement) and XPath. |
|
|
TLio.FormatConverter
Format conversion for TLio: the convert and convertValue commands, MultiFormatScriptRunner, and the JSON, XML and YAML adapters they convert through. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.6.0-preview.1 | 101 | 11/3/2026 |
| 1.5.2 | 70 | 11/16/2026 |
| 1.5.1 | 201 | 11/2/2026 |
| 1.5.0 | 162 | 11/2/2026 |
| 1.5.0-preview.5 | 74 | 11/2/2026 |
| 1.5.0-preview.3 | 101 | 10/23/2026 |
| 1.5.0-preview.2 | 76 | 10/23/2026 |
| 1.5.0-preview.1 | 78 | 10/22/2026 |
| 1.4.1 | 244 | 10/22/2026 |
| 1.4.0 | 171 | 10/19/2026 |
| 1.3.0 | 153 | 10/19/2026 |
| 1.3.0-preview.9 | 71 | 10/19/2026 |
| 1.3.0-preview.8 | 73 | 10/19/2026 |
| 1.3.0-preview.7 | 67 | 10/19/2026 |
| 1.3.0-preview.6 | 66 | 10/19/2026 |
| 1.3.0-preview.5 | 71 | 10/19/2026 |
| 1.3.0-preview.4 | 78 | 10/19/2026 |
| 1.3.0-preview.3 | 79 | 10/18/2026 |
| 1.3.0-preview.2 | 74 | 10/18/2026 |
| 1.3.0-preview.1 | 79 | 10/12/2026 |