Haystack 1.0.3

A grab-bag of unit-tested, performance-tested extensions to BCL types.

Install-Package Haystack -Version 1.0.3
dotnet add package Haystack --version 1.0.3
<PackageReference Include="Haystack" Version="1.0.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Haystack --version 1.0.3
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Design philosophy

Haystack is meant to be a small library that fills in some of the gaps in the BCL. By definition, it's kind of a dumping ground for little helper methods and wrappers.

Performance

Generally speaking, if there's more than one obvious way something could be implemented, the best-performing implementation was chosen. There is a performance testing project in the source that indicates where performance testing was done. That said, due to the nature of performance testing, only the best-performing alternative is kept. I.e. there is no performance testing code kept around for the lower-performing alternatives.

Performance results may be found in the PerformanceResults directory.

Versioning

Haystack uses semantic versioning. In a nutshell:

Given a version number MAJOR.MINOR.PATCH, increment the:

  1. MAJOR version when you make incompatible API changes,
  2. MINOR version when you add functionality in a backwards-compatible manner, and
  3. PATCH version when you make backwards-compatible bug fixes.

Credit

I wrote most of these methods myself. Chances are if you're here, you've written many of them in the past, too, and you're tired of writing them again.

There are some implementations that are cobbled together from other sources. When that's the case, I have left a note in the source code indicating where it was taken from.

Installation

Haystack is available as a nuget package targeting .NET Standard 1.3, which means it's compatible with a fairly wide range of .NET runtimes:

  • .NET Core 1.0+
  • .NET Framework 4.6+
  • Mono 4.6+
  • UWP 10+
  • Unity 2018.1
  • Etc.

Design philosophy

Haystack is meant to be a small library that fills in some of the gaps in the BCL. By definition, it's kind of a dumping ground for little helper methods and wrappers.

Performance

Generally speaking, if there's more than one obvious way something could be implemented, the best-performing implementation was chosen. There is a performance testing project in the source that indicates where performance testing was done. That said, due to the nature of performance testing, only the best-performing alternative is kept. I.e. there is no performance testing code kept around for the lower-performing alternatives.

Performance results may be found in the PerformanceResults directory.

Versioning

Haystack uses semantic versioning. In a nutshell:

Given a version number MAJOR.MINOR.PATCH, increment the:

  1. MAJOR version when you make incompatible API changes,
  2. MINOR version when you add functionality in a backwards-compatible manner, and
  3. PATCH version when you make backwards-compatible bug fixes.

Credit

I wrote most of these methods myself. Chances are if you're here, you've written many of them in the past, too, and you're tired of writing them again.

There are some implementations that are cobbled together from other sources. When that's the case, I have left a note in the source code indicating where it was taken from.

Installation

Haystack is available as a nuget package targeting .NET Standard 1.3, which means it's compatible with a fairly wide range of .NET runtimes:

  • .NET Core 1.0+
  • .NET Framework 4.6+
  • Mono 4.6+
  • UWP 10+
  • Unity 2018.1
  • Etc.

Release Notes

https://github.com/rianjs/Haystack/blob/master/release-notes.md

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
1.0.3 90 4/3/2019
1.0.2 77 3/20/2019
1.0.1 81 3/20/2019
0.0.3 156 12/23/2018
0.0.2 125 11/26/2018
0.0.1 128 11/25/2018