Simplify.System.Sources 1.6.3

Simplify.System Documentation

Provides classes to get assembly information and ambient context for wrapping DateTime.Now, DateTime.UtcNow, DateTime.Today properties.

Available at NuGet as binary package and source package

Getting Assembly Information

Provides IAssemblyInfo interface and AssemblyInfo class to get assembly information.

With AssemblyInfo, you can get assembly version, product name, description, copyright, and company name information.

General Usage

AssemblyInfo.Entry static ambient context provides information about the entry assembly.

Custom Usage

AssemblyInfo can be instantiated to get specified assembly information:

var assemblyInfo = new AssemblyInfo(Assembly.GetAssembly(typeof(SomeClass)));

Mocking DateTime.Now, DateTime.UtcNow, DateTime.Today

Provides ITimeProvider interface and TimeProvider class for mocking and using DateTime.Now, DateTime.UtcNow, DateTime.Today properties.

With TimeProvider.Current ambient context, you can easily get actual DateTime.Now, DateTime.UtcNow, DateTime.Today properties or mock them when needed.

By default, TimeProvider.Current is initialized with the SystemTimeProvider class, which wraps system DateTime.Now, DateTime.UtcNow, DateTime.Today properties.

Usage Example

// Will return actual DateTime.Now
var currentTime = TimeProvider.Current.Now;

Mocking Example with Moq

var fakeTimeProvider = new Mock<ITimeProvider>();
fakeTimeProvider.SetupGet(x => x.Now).Returns(new DateTime(2014, 10, 10));
TimeProvider.Current = fakeTimeProvider.Object;

// Will return fake value
var time = TimeProvider.Current.Now;

System Classes Extensions

Bytes Extensions

// Converts a byte array to a string.
public static string GetString(this byte[] bytes);

Double Extensions

// Checks whether two double values are approximately the same (the difference between values is less than Epsilon).
public static bool AreSameAs(this double a, double b);

String Extensions

// Converts a string to a byte array.
public static byte[] ToBytesArray(this string str);

// Converts the specified string representation of a date and time to its DateTime? equivalent using the specified format, invariant culture format information. The format of the string representation must match at least one of the specified formats exactly. The method returns a value if the conversion succeeded; otherwise, null.
public static DateTime? TryToDateTimeExact(this string s, string format);

DateTime Extensions

// Removes milliseconds from the DateTime.
public static DateTime TrimMilliseconds(this DateTime dt);