Skip to content

webappsuk/CoreLibraries

Repository files navigation

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.