HUMANiT.Core 1.0.3

HUMANiT Core

This package provides platform features that we miss in .NET, but that find valuable for our own daily software development. -- the people of HUMANiT

This package is covered by over 800 automated tests and offers an API that is documented extensively inline.

Features

• Inspections: Pre and post verification of parameters and variables to check their conditions. Fast and reliable.
• Domains: Consitent domain objects.
• Shipping: Consitent shipping models.
• Vault: Cache with multiple shelves (sub-caches), simple lifetime principles. Fast, thread-safe, reliable; also for SharePoint.
• Object analysis: Provides an easy test whether a generic type is null-able.
• Call result: Generic carrier of a call result such as of a standard method or a Web service call.
• Type converter: Converts enumeration values into pre-defined strings and vice versa.
• Cryptography: Creation and verification of cryptographic salted hashes; fast; using RFC2898 instead of the insecure MD5.
• Randomizer: Generates random codes of different lengths and passwords as well as numbers, first names (>400), last names (>200), full names (>97k), URLs (>39k) and emails (>9m).
• Extensions: Enhancements and validations to datesdatetimes, datetimeoffsets, passwords, PINs, phone numbers, names, emails, and exceptions.
• Exception support: Provides easy ways to throw an exception for reached code that was expected to be unreachable.

Extensions will move into their own NuGet package in a future version, so if you use them, consider that a future package upgrade may cause compiler errors and you will need to add the HUMANiT.Core.Extensions package (yet unavailable).

This package contains features which we require for our own software; therefore, some features are highly custom. If you require a fix, an enhancement, or a more configurable solution, please contact us.

Contact

• Twitter -- stay in touch (@HUMANiTnz)
• Facebook -- message with us (@HUMANiTnz)
• support@humanit.nz -- contact us via email

License

MIT -- free software, hell yeah 🤩

Quickstart

Inspections

Pre and post verification of parameters and variables to check their conditions. Fast and reliable.

Inspections are the incarnation of verification. Data verification is checking rules and ensure they are correct. A passed inspection means we can trust data is of a certain state and our code can be based on that. A failed inspection leads to an exception highlighting at which point we came aware of a problem with expected data quality.

Use parameter inspections to verify that parameters, that were passed into a method or constructor, are of an expected qyality. When such an inspection fails, it throws argument exceptions such as ArgumentNullException and ArgumentOutOfRangeException. Examples:

Inspect.Param.IsTrue(birthday <= DateTimeOffset.Today());
Inspect.Param.IsNotEmpty(vehicleList, nameof(vehicleList));
Inspect.Param.IsNotNullOrWhitespace(lastName, nameof(lastName), "Last name is mandatory.");

Use value inspections to verify that a method returned what it promised. When such an inspection fails, it throws an InvalidOperationException. Examples:

var numberOfThings = Inspect.Param.IsBetween(CountThings(), 0, 99);
var details = Inspect.Param.IsNotNull(LoadDetails(name), message: $"{name}'s details missing.");

Domains

Consitent domain objects.

Quickstart guidance will come.

Shipping

Consitent shipping models.

Quickstart guidance will come.

Vault

Cache with multiple shelves (sub-caches), simple lifetime principles. Fast, thread-safe, reliable; also for SharePoint.

Quickstart guidance will come.

Object analysis

Provides an easy test whether a generic type is null-able.

Quickstart guidance will come.

Call result

Generic carrier of a call result such as of a standard method or a Web service call.

Quickstart guidance will come.

Type converter

Converts enumeration values into pre-defined strings and vice versa.

Quickstart guidance will come.

Cryptography

Creation and verification of cryptographic salted hashes; fast; using RFC2898 instead of the insecure MD5.

Quickstart guidance will come.

Randomizer

Generates random codes of different lengths and passwords as well as numbers, first names (>400), last names (>200), full names (>97k), URLs (>39k) and emails (>9m).

Quickstart guidance will come.

Extensions

Enhancements and validations to datesdatetimes, datetimeoffsets, passwords, PINs, phone numbers, names, and exceptions.

Quickstart guidance will come.

Exception support

Provides easy ways to throw an exception for reached code that was expected to be unreachable.

Quickstart guidance will come.