Titanic.Helpers 1.3.3

titanic-csharp

C# libraries for Titanic!

Packages

Installation

Add the NuGet packages or reference the projects directly:

dotnet add package Titanic.API
dotnet add package Titanic.CDN
dotnet add package Titanic.Updater

Titanic.API Usage

using Titanic.API;
using Titanic.API.Requests;

var api = new TitanicAPI();

// Blocking request
var user = new GetUserRequest(1).BlockingPerform(api);

// Async request with callbacks
new GetUserRequest(1).Perform(api,
    onSuccess: user => Console.WriteLine(user.Name),
    onError: ex => Console.WriteLine(ex.Message)
);

// Further documentation can be found here:
// https://api.titanic.sh/docs

Titanic.Updater Usage

using Titanic.Updater;
using Titanic.Updater.Models;
using Titanic.Updater.Versioning;

UpdateManagerSettings settings = new()
{
    Exit = () => Console.WriteLine("Exit called!"),
    ReplaceCurrentExecutable = false,
    IncludeClientIdentifierInOutputPath = true,
};

var clientInfo = new ModdedClientInformation
{
    ClientIdentifier = "my-client",
    VersionKind = OsuVersionKind.BuildNumber,
    InstalledVersion = "b20130815",
    InstalledStream = "stable"
};

UpdateManager manager = new(settings);
ModdedReleaseEntry? update = manager.CheckUpdateForClient(client);

if (update != null)
{
    if (!update.IsExtractable)
    {
        Console.WriteLine($"Update found: {update.Version}, but not extractable");
        return;
    }
    Console.WriteLine($"Update found: {update.Version}");
    DownloadedUpdate downloadedUpdate = manager.DownloadClientUpdate(client, update);
    Console.WriteLine($"Update downloaded to {downloadedUpdate.Path}");
    manager.InstallClientUpdate(downloadedUpdate);
}

Titanic.CDN Usage

using Titanic.CDN;
using Titanic.CDN.Requests;

var cdn = new TitanicCDN();

var health = new GetHealthRequest().BlockingPerform(cdn);
var data = new DownloadObjectRequest("public/client/release-1.0.0.zip").BlockingPerform(cdn);

// The following requests require an access key
cdn.AccessKey = "your-access-key";

var session = new GetSessionRequest().BlockingPerform(cdn);
var files = new ListFilesRequest("public/client/", limit: 100).BlockingPerform(cdn);

var uploadRequest = new UploadFileRequest("public/client/release-1.0.0.zip", data, contentType: "application/octet-stream");
var upload = uploadRequest.BlockingPerform(cdn);

new DeleteCDNAdminFileRequest("public/client/release-1.0.0.zip").BlockingPerform(cdn);