dotnet add package HmxLabs.Core --version 0.1.0
NuGet\Install-Package HmxLabs.Core -Version 0.1.0
<PackageReference Include="HmxLabs.Core" Version="0.1.0" />
paket add HmxLabs.Core --version 0.1.0
#r "nuget: HmxLabs.Core, 0.1.0"
// Install HmxLabs.Core as a Cake Addin
// Install HmxLabs.Core as a Cake Tool
HMx Core consists of a range of utility code that we have found to be useful in the past across a number of different internal projects or client engagements. Although only open sourced in 2018 much of the code is considerably older. As such there are things in here that have been superseded by either updates to the .NET framework itself (such as much of the threading code since the advent of the TPL) or common adoption of other open source libraries.
Having said all that, we still find it useful. Broadly it consists of the following:
- Config utilities. This is particularly useful if targeting .NET Core or Mono to run on Linux and wanting to use linux style (Key=value) configuration files to keep things consistent with other parts of your system on Linux
- Date/Time utility functions and a common interface for providing the time (necessary for making any kind of time based code testable).
- A parser for Dreamweaver template markup
- Some utility file and directory functions
- A parser for the Dropbox info file to locate the Dropbox folder on a user’s machine
- A common logging façade and some very simple implementations. We use this however because its written with a mind to be able to write tests that also check for the presence or absence of certain types of logging. Yes, we’re that OCD about our tests sometimes. As such there is “in memory” logger implementation which makes little sense from a production use perspective but is handy for testing. For real production use you’d likely want a log4Net implementation.
- Some email code which is largely just wrappers and standardised config and utility methods over the .NET framework
- Socket/TCP code that handles things like framing the data over the wire (length prefix protocol provided, other protocols can be used), keep alive messages and dropped connection detection.
- Serialization code to help provide standardised serialization interfaces. Again, this is also written with a view to make code more testable too.
- Mostly just implementations of the IAsyncResult interface that also deal with processing the work on another thread. As mentioned above though this is largely superseded by the TPL at this point and probably shouldn’t be used.
Much of the code is documented inline and the XML documentation files are included as part of the downloads. We are looking into hosting MSDN style documentation online but this is not yet available.
There is a decent amount of test coverage which in some regards can also serve as example code too.
HMx Labs Core is Open Source software and is licensed under an MIT style license. This allows use in both free and commercial applications without restriction. The complete licence text is available on the HMx Labs website or here
Contributing, Bug Reports and Support
If you’ve found a bug or thought of a new feature that would be useful feel free to either implement it and raise a pull request for us or if you’d like us to take a look then just get in touch.
Support is provided very much on a best effort only basis and by electronic means (emails, pull requests, bug reports etc) only.
Unless you’re a client of HMx Labs of course, in which case just give us a call!
|Versions Compatible and additional computed target framework versions.
|net45 is compatible. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed.
This package has no dependencies.
NuGet packages (1)
Showing the top 1 NuGet packages that depend on HmxLabs.Core:
Testing extensions used by test code for multiple HMx Labs projects
This package is not used by any popular GitHub repositories.