Haystack 2.0.0

dotnet add package Haystack --version 2.0.0                
NuGet\Install-Package Haystack -Version 2.0.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Haystack" Version="2.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Haystack --version 2.0.0                
#r "nuget: Haystack, 2.0.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Haystack as a Cake Addin
#addin nuget:?package=Haystack&version=2.0.0

// Install Haystack as a Cake Tool
#tool nuget:?package=Haystack&version=2.0.0                

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.
Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.0.0 494 5/30/2022
1.1.1 680 6/6/2020
1.0.4 444 5/9/2020
1.0.3 565 4/3/2019
1.0.2 543 3/20/2019
1.0.1 551 3/20/2019
0.0.3 842 12/23/2018
0.0.2 687 11/26/2018
0.0.1 650 11/25/2018