Trivial 4.0.0-preview4

This is a prerelease version of Trivial.
There is a newer version of this package available.
See the version list below for details.
The owner has unlisted this package. This could mean that the package is deprecated, has security vulnerabilities or shouldn't be used anymore.
Install-Package Trivial -Version 4.0.0-preview4
dotnet add package Trivial --version 4.0.0-preview4
<PackageReference Include="Trivial" Version="4.0.0-preview4" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Trivial --version 4.0.0-preview4
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Trivial, 4.0.0-preview4"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install Trivial as a Cake Addin
#addin nuget:?package=Trivial&version=4.0.0-preview4&prerelease

// Install Trivial as a Cake Tool
#tool nuget:?package=Trivial&version=4.0.0-preview4&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Includes utilities and services for tasks, security, JSON, etc.


using Trivial.Tasks;


Set an action with a specific interceptor to control its execution.

  • Interceptor.Debounce: You may request to invoke a specific action several times in a short time but only the last one should be executed and previous ones should be ignored. A sample is real-time search suggestion.
  • Interceptor.Throttle: You may want to execute an action only once in a short time even if you invoke several times. A sample is the submit button in a form.
  • Interceptor.Times: You can define an action can be only executed only when invoke in the specific times range and others will be ignored. A sample is double click.
  • Interceptor.Multiple: A handler to execute for the specific times and the state will be reset after a while.

Following is an example for debounce.

// Set an action with interceptor.
var action = Interceptor.Debounce(() =>
    // Do something...
}, TimeSpan.FromMilliseconds(200));

// Invoke somewhere.


Create a linear retry policy by LinearRetryPolicy or a customized one to process an action with the specific retry policy. And you can use ObservableTask to observe the state of an action processing.


Contains the helper functions and extension functions for network, such as HTTP web client and its content.

using Trivial.Net;

And you can also use JsonHttpClient to serialize the JSON format response with retry policy supports. And HttpUri for HTTP URI fields accessing.


using Trivial.Security;


Convert a PEM (OpenSSL RSA key) or an XML string to the RSAParameters struct.

var parameters = RSAParametersConvert.Parse(pem);

And you can convert back by using the extension method ToPrivatePEMString or ToPublicPEMString. And the extension method ToXElement to XML.

Symmetric & Hash

Use a symmetric algorithm to encrypt and decrypt a string by calling SymmetricUtilities.Encrypt and SymmetricUtilities.DecryptText functions.

For hash algorithm, you can call HashUtilities.ToHashString function to get hash from a plain string and call HashUtilities.Verify to verify.

Access token

Provide a set of tools for OAuth including following models.

  • TokenInfo The access token and other properties.
  • AppAccessingKey The app identifier and secret key.
  • OAuthClient The token container with the ability to resolve the access token and create the JSON HTTP web client to access the resources required authentication.

And you can also implement the OAuthBasedClient base class to create your own business HTTP web client factory with OAuth supports.


Create a JSON web token to get the string encoded by initializing a new instance of the JsonWebToken class or the JsonWebTokenParser class.

var sign = HashSignatureProvider.CreateHS512("a secret string");
var jwt = new JsonWebToken<JsonWebTokenPayload>(new JsonWebTokenPayload
    Id = Guid.NewGuid().ToString("n"),
    Issuer = "example"
}, sign);

// Get authenticiation header value.
var header = jwt.ToAuthenticationHeaderValue();

// Parse.
var jwtSame = JsonWebToken<Model>.Parse(jwtStr, sign); // jwtSame.ToEncodedString() == header.Parameter

Secure string

Use the extension methods in the SecureStringExtensions class to convert the secret between SecureString and String/StringBuilder/Byte[].

You can also use the class RSASecretExchange to transfer the secret with RSA encryption.


using Trivial.Text;


Includes writable JSON DOM JsonObject and JsonArray. And includes lots of useful converter like following.

  • JsonJavaScriptTicksConverter, and its nullable value conveters and fallback converters, to convert DateTime or DateTime? from/to JavaScript ticks number in JSON.
  • JsonUnixTimestampConverter, and its nullable value conveters and fallback converters, to convert DateTime or DateTime? from/to Unix timestamp number in JSON.
  • JsonNumberConverter and JsonNumberConverter.NumberStringConverter, to read number string in JSON.
  • JsonStringListConverter and its character separated converters (such as JsonStringListConverter.WhiteSpaceSeparatedConverter), to convert a string list from/to a string in JSON.
  • JsonObjectConverter, to convert JsonObject and JsonArray.


Read CSV or TSV file into a list of the specific models. For example, you have a model class CsvModel with string properties A and B, now you can map to the CSV file.

var csv = new CsvParser("abcd,efg\nhijk,lmn");
foreach (var model in csv.ConvertTo<CsvModel>(new[] { "A", "B" }))
    Console.WriteLine("{0},{1}", model.A, model.B);


using Trivial.Data;


Save a number of model in memory cache by generic class DataCacheCollection.


using Trivial.Maths;


There are a lot of arithmetic functions.

Arithmetic.IsPrime(2147483647); // True
Arithmetic.Gcd(192, 128); // 64


Get the number symbols as you want. And get the numerals in English.

// twelve thousand three hundred and forty-five point six seven

// 1.2M

And ChineseNumerals for Chinese and JapaneseNumerals for Japanese.

Angle and polar point

  • Angle Angle.
  • PolarPoint The point in polar coordinates.
  • SphericalPoint The point in spherical coordinates.


  • NullableValueSimpleInterval<T> Interval, such as [20, 100).

Rectangular coordinates

  • OneDimensionalPoint The point in 1D (line) coordinates.
  • TwoDimensionalPoint The point in 2D (flat) coordinates.
  • ThreeDimensionalPoint The point in 3D (stereoscophic) coordinates.
  • FourDimensionalPoint The point in 4D (spacetime) coordinates.


  • IO
  • Geography
  • Reflection
  • CommandLine

NuGet packages (5)

Showing the top 5 NuGet packages that depend on Trivial:

Package Downloads

The useful utilities for console application including command dispatcher, arguments parser and some rich user interface console controls.


A core library of NuScien framework which provides a solution to build community and enterprise projects based on resource entity and accessories with ACL and CMS built-in.


A library with basic chemical models.


A library for web API.


The MIME constants.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
5.0.0 19 11/27/2021
4.0.0 210 11/9/2021
3.8.0 195 11/9/2021
3.7.2 2,552 4/22/2021
3.7.0 614 3/17/2021
3.6.2 214 3/17/2021
3.6.0 3,261 11/12/2020
3.5.2 3,978 4/13/2020
3.5.1 646 4/12/2020
3.5.0 623 4/1/2020
3.4.3 599 3/20/2020
3.4.2 582 3/12/2020
3.4.1 630 2/25/2020
3.4.0 801 2/20/2020
3.3.0 847 2/14/2020
3.2.0 1,134 1/22/2020
3.1.0 1,167 12/30/2019
3.0.1 1,023 12/26/2019
2.2.0 425 2/19/2020
2.1.0 775 12/24/2019
2.0.3 710 12/3/2019
1.2.0 3,004 5/20/2019
1.1.0 929 5/8/2019
1.0.0 771 5/1/2019