Runline.U 0.1.2

Runline U

Runline.U is the .NET Standard client library for connecting to Runline U. Use of Runline services requires an active Runline customer account and any required service credentials.

The package is publicly downloadable for customer convenience, but it remains subject to the included proprietary license.

Install

dotnet add package Runline.U

Usage

using Runline.U.Client;

using var client = new UClient(host: "eval.runline.com", port: 40001);

client.Publish(
    "ABC_CORP/OTHER_REPORT_GROUP/OTHER_REPORT_NAME",
    new[]
    {
        new object[] { "Symbol", "LastPrice" },
        new object[] { "MSFT", 529.24 }
    });

UReport report = client.Get("ABC_CORP/MY_REPORT_GROUP/MY_REPORT_NAME");
object[][] firstPage = report?.FirstPage;

Primary/Backup HubServers

Use endpoint-based construction when an application should hot fail over to a backup HubServer and automatically fail back after the primary completes a publish/subscribe/get health check.

using var client = new UClient(
    new UClientEndpoint("primary.runline.com", 40001),
    new UClientEndpoint("backup.runline.com", 40001));

Backup AuthServer And Token Renewal

When retrieving tokens with credentials, provide a backup AuthServer URL to have the client try the primary AuthServer first and then the backup if the primary fails.

var token = client.GetAuthNTokenWithBackup(
    "https://primary-auth.runline.com:40151/api/v1/basicauthntoken",
    "https://backup-auth.runline.com:40151/api/v1/basicauthntoken",
    password,
    entity);
client.Authenticate(token, entity);

For credential-free reconnects, authenticate with an initial token and configure token renewal. Reconnects renew from the latest in-memory token, trying the primary renew AuthServer first and then the backup. If renewal fails, the current token is used as a fallback.

client.AuthenticateWithTokenRenewal(
    initialToken,
    entity,
    "https://primary-auth.runline.com:40151/api/v1/renewauthntoken",
    "https://backup-auth.runline.com:40151/api/v1/renewauthntoken",
    tokenRenewalIntervalMinutes: 30);

Target Framework

The package targets netstandard2.0, so it can be used by .NET Framework 4.8 and .NET 8 applications.

Examples

The NuGet package includes a complete example server and companion Excel workbook under:

examples/Runline.U.ExampleServer/

Copy that directory out of the package cache, configure the environment variables described in its README.md, and run:

dotnet run --project .\Runline.U.ExampleServer.csproj

Migrating from UpTickXL

New applications should use Runline.U.Client.UClient and Runline.U.Client.UReport. Existing UpTickXL .NET applications generally need only straightforward compile-time renames from UpTickXLClient to UClient, UpTickXLReport to UReport, and UpTick.UpTickXL.Client to Runline.U.Client.