Trivial 0.4.2

Trivial

This library includes utilities and services for tasks, IO, security, etc.

Tasks

Just add following namespace to your code file to use.

using Trivial.Tasks;

Debounce

Maybe a handler will be asked to process several times in a short time but you just want to process once at the last time because the previous ones are obsolete. A sample is real-time search. You can use following method to do so.

var task = HitTask.Debound(() => {
    // Do something...
}, TimeSpan.FromMilliseconds(200));

// Somewhere to raise.
task.ProcessAsync();

Throttle

A handler to be frozen for a while after it has processed.

var task = HitTask.Throttle(() => {
    // Do something...
}, TimeSpan.FromMilliseconds(10000));

// Somewhere to raise.
task.ProcessAsync();

Multiple

A handler to process for the specific times and it will be reset after a while.

var task = HitTask.Multiple(() => {
    // Do something...
}, 10, null, TimeSpan.FromMilliseconds(200));

// Somewhere to raise.
task.ProcessAsync();

Times

A handler to process for the specific times only and it will be reset after a while. A sample is double click.

var task = HitTask.Times(() => {
    // Do something...
}, 2, 2, TimeSpan.FromMilliseconds(200));

// Somewhere to raise.
task.ProcessAsync();

Retry

You can create a linear retry policy or even a customized to process an action with the specific retry policy. And you can use ObservableTask to observe the state of an action processing.

Mathematics

Just add following namespace to your code file to use.

using Trivial.Maths;

Arithmetic

There a lot of arithmetic functions.

Arithmetic.IsPrime(2147483647); // True
Arithmetic.IsPrime(21474836479); // False
await Arithmetic.IsPrimeAsync(2305843009213693951); // False

Arithmetic.Factorial(10); // 3628800

Arithmetic.Gcd(192, 128); // 64
Arithmetic.Lcm(192, 128); // 384

Numbers

You can get the number symbols as you want.

You can also get the number string in English words.

EnglishNumber.Default.ToString(12345.67);
// twelve thousand three hundred and forty-five point six seven

EnglishNumber.Default.ToString(12345, true);
// one two three four five

EnglishNumber.Default.ToApproximationString(1234567);
// 1.2M

And also for Chinese and Japanese.

ChineseNumber.Simplified.ToString(12345.67);
// 一万两千三百四十五点六七

ChineseNumber.SimplifiedUppercase.ToString(12345, true);
// 壹贰叄肆伍

JapaneseNumber.Default.ToApproximationString(1234567);
// 123.5万

Angle and polar point

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

Set

• 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.

Network

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.

Security

Just add following namespace to your code file to use.

using Trivial.Security;

RSA

You can convert a PEM (OpenSSL RSA key) or an XML string to the RSAParameters class.

var parameters = RSAUtility.Parse(pem);

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

Symmetric

You can encrypt and decrypt a string by symmetric algorithm.

// AES sample.
var original = "Original secret string";
var cipher = SymmetricUtilities.Encrypt(Aes.Create, original, key, iv);
var back = SymmetricUtilities.Decrypt(Aes.Create, cipher, key, iv); // back == original

Hash

For hash, you can call HashUtilities.ComputeHashString function to get hash and HashUtilities.Verify to verify.

Access token

We also provide a set of tools for OAuth including following models.

• TokenInfo The access token and other properties.
• AppAccessingKey The app identifier and secret key.

And you can implement the OpenIdTokenClient abstract class or TokenResolver abstract class to get and maintain the access token.

Secure string utiltiy

You can use the extension methods SecureStringUtiltiy to convert between SecureString and String/StringBuilder/Byte[].

IO

Contains the helper functions and extension methods for FileInfo and Stream.

using Trivial.IO;

Geography

Contains the models of geography.

using Trivial.Geography;

Geolocation

You can use Geolocation, Latitude, Longitude and other models for geolocation information.