CommonHelpers 1.2.0

CommonHelpers

This is a cross platform NET Standard 2.0 helper library containing a bunch of helper code that I used to rewrite several times a day while creating sample apps for developers. Due to the number of "File > New" projects I create every day, this packages saves me a significant amount of time. I hope it helps you as well. Enjoy!

Releases

NuGet.org (recommended)	GitHub Releases (all releases)
	Releases Page

Support

DevOps

Workflow	Status
dev
main
prerelease
release

Features

Extensions

Extensions for commonly used objects like; string, DateTime, and enum. As well as handy methods for File, Exception and Color objects. There's also the HttpClientExtensions where you can easily get download progress insights and a helper method to POST image data.

For example, you can quickly get easing function values using the EasingExtensions. Here's what the demo looks like for myFloatValue.BackEaseIn();

Collections

Special collection types that help in special scenarios (e.g. ObservableQueue and ObservableRangeCollection).

Common

This folder has some of the most frequently used classes (i.e. BindableBase, ViewModelBase, JsonHelper).

MVVM

Platform agnostic MVVM classes like DelegateCommand and RelayCommand.

Services

To make testing UI controls easier by quickly providing well formatted data from offline sample data and online API endpoints. This is really useful for quickly testing Load On Demand scenarios.

• BingImageService
• ComicVineApiService
• SampleDataService
• XkcdApiService

ComicVineService requires an API Key (it's free). All other services do not require an API key, just new up the class and start using it.

Examples

Sample Data Service

This is my most frequently used service. You can easily spin up data for Lists, Charts, DataGrids and more with a single method.

BarSeriesData.AddRange(SampleDataService.Current.GenerateCategoricalData());
ScatterSeriesData.AddRange(SampleDataService.Current.GenerateScatterPointData());
LineSeriesData.AddRange(SampleDataService.Current.GenerateDateTimeMinuteData());
SplineAreaSeriesData.AddRange(SampleDataService.Current.GenerateDateTimeDayData());

People.AddRange(SampleDataService.Current.GeneratePeopleData());
Employees.AddRange(SampleDataService.Current.GenerateEmployeeData(true));

Products.AddRange(SampleDataService.Current.GenerateProductData());
Categories.AddRange(SampleDataService.Current.GenerateCategoryData());

BingImageService

Easily fetch the Bing Image of Day.

using (var bingImageService = new BingImageService())
{
    var result = await bingImageService.GetBingImageOfTheDayAsync();
    image.Source = new UriImageSource{Uri = result};
}

xkcd API Service

Getting today's comic by calling GetNewestComic or get any comic by using GetComicAsync(comicNumber).

var xkcdService = new XkcdApiService();

// to fetch a comic, get the latest or pass a specific comic ID
XkcdComic xkcdComic;

if (lastXkcdComicNumber == 0)
{
    xkcdComic = await xkcdService.GetNewestComicAsync();
}
else
{
    xkcdComic = await xkcdService.GetComicAsync(lastXkcdComicNumber - 1);
}

lastXkcdComicNumber = xkcdComic.Num;

// This is an `ObservableQueue` (located in CommonHelpers.Collections)      
XkcdComics.Enqueue(xkcdComic);

ComicVineApiService

The ComicVine API is the only service in which you'll need an API key. You pass the key and a unique string name for your app to the constructor. Now you have access to thousands of items like Characters, Videos and more from the service.

var comicVineService = new ComicVineApiService(ApiKeys.ComicVineApiKey, ApiKeys.UniqueUserAgentString);

var apiResult = await comicVineService.GetCharactersAsync(CurrentCharactersCount);
CurrentCharactersCount = apiResult.Offset + apiResult.NumberOfPageResults;
TotalCharactersCount = apiResult.NumberOfTotalResults;

var characters = apiResult.Results;