CommonHelpers 1.4.0
dotnet add package CommonHelpers --version 1.4.0
NuGet\Install-Package CommonHelpers -Version 1.4.0
<PackageReference Include="CommonHelpers" Version="1.4.0" />
paket add CommonHelpers --version 1.4.0
#r "nuget: CommonHelpers, 1.4.0"
// Install CommonHelpers as a Cake Addin #addin nuget:?package=CommonHelpers&version=1.4.0 // Install CommonHelpers as a Cake Tool #tool nuget:?package=CommonHelpers&version=1.4.0
CommonHelpers
This is a cross platform netstandard2.0
helper library containing a wide range of helper classes and data generation code that I used to write over and over, every day, while creating sample apps for developers.
Due to the number of "File > New" projects I create every day, this package has saved me a significant amount of time (the SampleDataService
alone is a game changer).
Releases
NuGet.org (recommended) | GitHub Releases (all releases) |
---|---|
Releases Page |
Features
Extensions
Helpful extensions for string
, DateTime
, and enum
... as well as common methods for ObservableCollection
, File
, Exception
, Color
and HttpClient
. See the CommonHelpers/Extensions folder for details.
For example, you can quickly get easing function values using the EasingExtensions
, such as myFloatValue.BackEaseIn()
:
Collections
Special collection types that help in special scenarios (e.g. ObservableQueue
and ObservableRangeCollection
).
Common
This folder has some of the most used classes. For example, BindableBase
, ViewModelBase
, JsonHelper
to name a few.
MVVM
Platform agnostic MVVM classes like DelegateCommand
and RelayCommand
.
Structs
This namespace contains structs that are currently missing from the platform or are just really handy to have. It currently contains Either<TSuccess, TError>
, which is a great help when using rails-based programming.
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
The ComicVineService requires an API Key, but a key is free. All other services do not require an API key, new-up the class and start using it right away.
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;
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- No dependencies.
NuGet packages (2)
Showing the top 2 NuGet packages that depend on CommonHelpers:
Package | Downloads |
---|---|
CommonHelpers.Maui
A .NET MAUI companion to the CommonHelpers library, containing MAUI-specific functionality like; extensions, behaviors, converters, and more. |
|
SemanticSDK
Provides Peppol Docuiment classes for exchange |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.4.0 | 441 | 9/12/2024 |
1.3.2 | 664 | 7/3/2024 |
1.3.1 | 1,072 | 5/24/2024 |
1.3.0 | 614 | 1/26/2024 |
1.2.1 | 669 | 7/28/2023 |
1.2.0 | 3,697 | 4/18/2022 |
1.2.0-rc | 191 | 4/18/2022 |
1.1.3 | 891 | 11/2/2021 |
1.1.3-rc | 233 | 11/2/2021 |
1.1.2 | 1,699 | 8/6/2020 |
1.1.1 | 597 | 7/15/2020 |
1.0.12 | 2,526 | 4/29/2019 |
1.0.11 | 757 | 4/21/2019 |
1.0.9 | 682 | 4/12/2019 |
1.0.8 | 1,041 | 11/17/2018 |
1.0.7 | 1,185 | 6/27/2018 |
1.0.6 | 1,075 | 6/21/2018 |
1.0.5 | 906 | 6/19/2018 |
1.0.4 | 1,033 | 6/19/2018 |
1.0.0 | 1,033 | 6/18/2018 |
Review releases on GitHub at bit.ly/CommonHelpers