Silvanna.Core
1.0.0
dotnet add package Silvanna.Core --version 1.0.0
NuGet\Install-Package Silvanna.Core -Version 1.0.0
<PackageReference Include="Silvanna.Core" Version="1.0.0" />
<PackageVersion Include="Silvanna.Core" Version="1.0.0" />
<PackageReference Include="Silvanna.Core" />
paket add Silvanna.Core --version 1.0.0
#r "nuget: Silvanna.Core, 1.0.0"
#:package Silvanna.Core@1.0.0
#addin nuget:?package=Silvanna.Core&version=1.0.0
#tool nuget:?package=Silvanna.Core&version=1.0.0
Silvanna π
High-Performance .NET Benchmarking Library - Next Generation Performance Testing
π― 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 | Versions 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. |
-
.NETFramework 4.7.2
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.10)
- System.Reflection.Emit (>= 4.7.0)
- System.Runtime.CompilerServices.Unsafe (>= 6.1.2)
- System.Text.Json (>= 10.0.0-rc.2.25502.107)
-
.NETStandard 2.1
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.10)
- System.Reflection.Emit (>= 4.7.0)
- System.Runtime.CompilerServices.Unsafe (>= 6.1.2)
- System.Text.Json (>= 10.0.0-rc.2.25502.107)
-
net6.0
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.10)
- System.Reflection.Emit (>= 4.7.0)
- System.Runtime.CompilerServices.Unsafe (>= 6.1.2)
- System.Text.Json (>= 10.0.0-rc.2.25502.107)
-
net8.0
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.10)
- System.Reflection.Emit (>= 4.7.0)
- System.Runtime.CompilerServices.Unsafe (>= 6.1.2)
- System.Text.Json (>= 10.0.0-rc.2.25502.107)
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 |