C#
Clone or download
Latest commit 727f6b9 Jun 14, 2018
Permalink
Failed to load latest commit information.
.nuget Case:16223 Updated the projects to set the SolutionDir relative to th… Jul 23, 2015
Cryptography Updated NodaTime and protobuf nuget references. Mar 6, 2017
Database #51 Fixed passing null to SQL parameters. Oct 17, 2017
Documentation Refs #37 - Forgot how to link in markdown Mar 28, 2017
ILMerge Fixed incorrect path in ILMerge.targets Jan 7, 2017
Initializer #27 The search directories are now normalised before being de-duplic… Oct 4, 2016
Logging #47 Fixes some bugs with the EmailLogger Oct 6, 2017
Performance Updated NodaTime and protobuf nuget references. Mar 6, 2017
PowerShell #7 Fixed issue with Default Collections on Configurations Oct 2, 2016
Scheduling #35 Work on Ambiguous PeriodicSchedule constructors. Apr 7, 2017
Serialization Updated NodaTime and protobuf nuget references. Mar 6, 2017
Service Downgrading protobuf nuget as the new version requires .Net Standard Mar 6, 2017
Testing #1 Updated Moq version - missing project files. Oct 4, 2016
Utilities #55 - Normalise line endings. Jun 11, 2018
.gitignore Issue #37 : pre-delete and DocFx build uncommented following successf… Mar 27, 2017
BuildTasks.sln #2,#3 WIP Rewriting Build system Oct 11, 2015
BuildTasks.sln.GhostDoc.xml #36 Moved NodaTime converter helper patterns into TimeHelpers for ea… Apr 20, 2017
CONTRIBUTING.md Update CONTRIBUTING.md Aug 31, 2015
Common.proj Fixed main solution not building from a clean checkout. Mar 18, 2017
CommonAttributes.cs Case:16223 Refactored common project properties and assembly attribut… Jul 12, 2015
CoreLibraries.sln Fixed incorrect path in ILMerge.targets Jan 7, 2017
CoreLibraries.sln.DotSettings #47 Added an EmailLogger. Aug 11, 2017
CoreLibraries.sln.GhostDoc.user.dic #36 Moved NodaTime converter helper patterns into TimeHelpers for ea… Apr 20, 2017
CoreLibraries.sln.GhostDoc.xml #36 Moved NodaTime converter helper patterns into TimeHelpers for ea… Apr 20, 2017
CoreLibraries.sln.vsdoc #5 WIP New cryptography system Oct 2, 2016
ILMerge.sln #2,#3 WIP Rewriting Build System Oct 10, 2015
ILMerge.sln.GhostDoc.xml #23 Explicitly pass TargetFrameworkVersion and TargetPlatform to ILM… Oct 4, 2016
Initializer.sln #27 The search directories are now normalised before being de-duplic… Oct 4, 2016
Initializer.sln.GhostDoc.xml #23 Explicitly pass TargetFrameworkVersion and TargetPlatform to ILM… Oct 4, 2016
PerfSetup.sln #2,#3 WIP Rewriting Build System Oct 10, 2015
PerfSetup.sln.GhostDoc.xml #2,#3 WIP Rewriting Build System Oct 10, 2015
license.md Updated copyright dates Jun 14, 2018
nuget.png Case:16223 Code cleanup Aug 28, 2015
readme.md Update readme.md Apr 6, 2017

readme.md

Web Applications UK Ltd Utilities

This library contains a treasure trove of utilities built up over a decade by Web Applications UK for simplifying the building and deployment of enterprise scale .NET solutions. The code has been successfully used, in various forms, for a number of years in production environments driving millions of transactions.

As part of our ethos to have a positive impact on our wider community we are open sourcing them for everyone's benefit. We've also included the last three years of development history, showing how the utilities have evolved. Please let us know if you find the code useful in your own projects!

We have carefully sanitised the code to protect our commercial customers interests, but if you do manage to spot any sensitive data please notify us directly using our support email.

Using the libraries

All the code present here is also available on nuget.org, as a collection of 9 inter-connected NuGets and can be installed into your .NET projects using NuGet. Alternatively, you can look for the individual NuGet files, or the compiled binaries in the releases.

The official NuGets are strongly named and digitally signed by Web Applications UK, using a separate, secure process, that guarantees the NuGets authenticity. Although you can build your own NuGets from the source included here, the ability to upload them to nuget.org is not provided to protect casual users. If you wish to use a customised version of a library, we recommend building and including the dll directly (but remember to include the License!).

We will accept relevant pull requests, and issues, so please consider contributing.

Building the libraries

The libraries are built using Visual Studio 2017. They can also be built using msbuild, and for that reason build dependencies are included as project references in projects (see "Incorrect solution build ordering when using msbuild.exe").

We are big fans of ReSharper and recommend using it. All our code makes use of ReSharper code annotations to refine code inspection.

We are continually migrating the code to the latest versions of .NET and C#, but this is a rolling process. If there's some code that you particularly would like to see working in a previous version of .NET then you can try looking at the history of the files to see how they've changed through each version.

Documentation

The libraries are well documented with inline XML comments and provide useful intellisense. Full API documentation can be found on the GitHub pages.

We plan on expanding the documentation to include tutorials and example code, in the meantime, there are some useful blogs on thargy.com, and we hope to provide more tutorials and examples soon, particularly if the NuGets prove popular.

License

See License.

Contributing

See Contributing.