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

• Getting Started Guide
• Configuration Options
• Best Practices
• API Reference
• Project Specification

🛠️ 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

• GitHub Issues
• Discussions
• Stack Overflow

---

Made with ❤️ for the .NET community