Silvanna.Core 1.0.0

dotnet add package Silvanna.Core --version 1.0.0
                    
NuGet\Install-Package Silvanna.Core -Version 1.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="Silvanna.Core" Version="1.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Silvanna.Core" Version="1.0.0" />
                    
Directory.Packages.props
<PackageReference Include="Silvanna.Core" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Silvanna.Core --version 1.0.0
                    
#r "nuget: Silvanna.Core, 1.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.
#:package Silvanna.Core@1.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Silvanna.Core&version=1.0.0
                    
Install as a Cake Addin
#tool nuget:?package=Silvanna.Core&version=1.0.0
                    
Install as a Cake Tool

Silvanna πŸš€

High-Performance .NET Benchmarking Library - Next Generation Performance Testing

.NET License Build Status NuGet

🎯 What is Silvanna?

Silvanna is a modern, comprehensive benchmarking library for .NET applications designed to provide accurate, reliable, and detailed performance measurements. Inspired by BenchmarkDotNet, Silvanna offers an intuitive API, advanced features, and superior developer experience.

✨ Key Features

  • πŸ”₯ Fast & Accurate: Nanosecond precision with statistical analysis
  • πŸ’Ύ Memory Diagnostics: Track allocations, GC pressure, and memory patterns
  • πŸ“Š Rich Reporting: HTML, Markdown, JSON, and custom report formats
  • ⚑ Async Support: First-class support for async/await patterns
  • πŸŽ›οΈ Flexible Configuration: Fluent API and attribute-based setup
  • πŸ“ˆ Regression Detection: Automatic performance regression identification
  • πŸ”§ Extensible: Plugin architecture for custom diagnosers and reporters

πŸš€ Quick Start

Installation

dotnet add package Silvanna

Your First Benchmark

using Silvanna;

[SimpleBenchmark]
public class MyFirstBenchmark
{
    private List<int> data = Enumerable.Range(0, 1000).ToList();

    [Benchmark]
    public int Sum() => data.Sum();

    [Benchmark]
    public int SumLinq() => data.Aggregate(0, (a, b) => a + b);
}

class Program
{
    static void Main(string[] args)
    {
        BenchmarkRunner.Run<MyFirstBenchmark>();
    }
}

Sample Output

|    Method |     Mean |   Error |  StdDev | Allocated |
|---------- |---------:|--------:|--------:|----------:|
|       Sum | 2.150 ΞΌs | 0.042 ΞΌs| 0.039 ΞΌs|      0 B |
|   SumLinq | 8.847 ΞΌs | 0.175 ΞΌs| 0.164 ΞΌs|     32 B |

πŸ“– Documentation

πŸ› οΈ Advanced Usage

Parametrized Benchmarks

[SimpleBenchmark]
public class ParametrizedBenchmark
{
    [Params(100, 1000, 10000)]
    public int Size { get; set; }

    private int[] data;

    [GlobalSetup]
    public void Setup() => data = new int[Size];

    [Benchmark]
    public void ArrayFill() => Array.Fill(data, 42);
}

Custom Configuration

var config = new BenchmarkConfig()
    .WithWarmupCount(5)
    .WithIterationCount(100)
    .AddDiagnoser<MemoryDiagnoser>()
    .AddReporter<HtmlReporter>()
    .Build();

BenchmarkRunner.Run<MyBenchmarks>(config);

πŸ—οΈ Architecture

Silvanna is built with extensibility and performance in mind:

  • Core Engine: Handles benchmark execution and isolation
  • Measurement System: Collects timing, memory, and hardware metrics
  • Analysis Module: Statistical analysis and regression detection
  • Reporting Layer: Generates various output formats
  • Diagnostics: Pluggable diagnostic tools

🀝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

# Clone the repository
git clone https://github.com/Taiizor/Silvanna.git

# Build the project
dotnet build

# Run tests
dotnet test

# Run benchmarks (dogfooding!)
dotnet run --project benchmarks/Silvanna.Benchmarks

πŸ“Š Performance Goals

  • Overhead: < 1% measurement overhead
  • Accuracy: Β±1ns timing precision
  • Memory: < 100MB runtime footprint
  • Startup: < 10ms initialization time

πŸ—ΊοΈ Roadmap

  • βœ… Core benchmarking engine
  • βœ… Basic statistical analysis
  • πŸ”„ Memory diagnostics (in progress)
  • πŸ“… Hardware counter support
  • πŸ“… Cloud dashboard integration
  • πŸ“… IDE plugins (VS/Rider)

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

  • Inspired by BenchmarkDotNet
  • Statistical algorithms from MathNet.Numerics
  • Community contributors and testers

πŸ“ž Support


Made with ❀️ for the .NET community

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  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 is compatible.  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.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
.NET Framework net472 is compatible.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Silvanna.Core:

Package Downloads
Silvanna

Silvanna - High-Performance .NET Benchmarking Library. This is a metapackage that includes all Silvanna components.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0 217 10/31/2025