Accelergreat xunit testing tools. Accelergreat is an integration testing package that helps to simplify and speed up the writing of integration tests, as well as taking away the challenging task of managing external dependencies.
The fastest way to write and run integration tests in .NET
Stop fighting with slow, brittle integration tests. Accelergreat automatically manages your test dependencies, runs tests in parallel, and resets databases in milliseconds. Focus on writing great tests, not test infrastructure.
🚀 Why Developers Love Accelergreat
Lightning Fast Database Resets
Transactions Mode: 0-3ms database resets using savepoints
Parallel Execution: Tests run simultaneously across multiple environments
Smart Pooling: Intelligent resource management scales with your machine
Zero Boilerplate
Auto-managed Dependencies: Databases, APIs, and services configured automatically
Clean Test Code: No setup/teardown code cluttering your tests
Familiar APIs: Works with your existing xUnit knowledge
Production-Ready
Multiple Database Providers: SQL Server, SQLite
Microservices Support: Test complex multi-service scenarios
Environment Configuration: Development and CI configs
public class Startup : IAccelergreatStartup
{
public void Configure(IAccelergreatBuilder builder)
{
builder.AddAccelergreatComponent<ProductDatabaseComponent>();
builder.AddAccelergreatComponent<ProductApiComponent>();
}
}
public class ProductDatabaseComponent : SqlServerEntityFrameworkDatabaseComponent<ProductDbContext>
{
public ProductDatabaseComponent(IConfiguration configuration) : base(configuration)
{
}
}
3. Create Your First Test
public class ProductTests : AccelergreatXunitTest
{
public ProductTests(IAccelergreatEnvironmentPool environmentPool) : base(environmentPool)
{
}
[Fact]
public async Task CreateProduct_ShouldPersistToDatabase()
{
// Arrange - Get auto-managed database
var dbContext = GetComponent<ProductDatabaseComponent>().DbContextFactory.NewDbContext();
var product = new Product { Name = "Test Product", Price = 99.99m };
// Act
dbContext.Products.Add(product);
await dbContext.SaveChangesAsync();
// Assert
var saved = await dbContext.Products.FindAsync(product.Id);
saved.Should().NotBeNull();
saved.Name.Should().Be("Test Product");
// Database automatically resets after each test!
}
}
4. Run Tests
dotnet test
That's it! Your tests now run in parallel with ultra-fast database resets.
public class RedisComponent : IAccelergreatComponent
{
private ConnectionMultiplexer _redis;
public async Task InitializeAsync(IAccelergreatEnvironmentPipelineData environmentData)
{
_redis = await ConnectionMultiplexer.ConnectAsync("localhost:6379");
environmentData.Add("RedisConnection", _redis);
}
public async Task ResetAsync()
{
await _redis.GetDatabase().FlushDatabaseAsync();
}
public async ValueTask DisposeAsync()
{
await _redis.DisposeAsync();
}
}
Environment-Based Configuration
// Set environment via environment variable
Environment.SetEnvironmentVariable("ACCELERGREAT_ENVIRONMENT", "development");
// Or configure via user secrets
dotnet user-secrets set "ACCELERGREAT:SqlServerEntityFramework:ResetStrategy" "Transactions"
🎨 Complete Example
Here's a full example showing Accelergreat's power:
public class ECommerceIntegrationTests : AccelergreatXunitTest
{
public ECommerceIntegrationTests(IAccelergreatEnvironmentPool environmentPool) : base(environmentPool)
{
}
[Fact]
public async Task PlaceOrder_ShouldProcessPaymentAndUpdateInventory()
{
// Arrange
var dbContext = GetComponent<ECommerceDatabaseComponent>().DbContextFactory.NewDbContext();
var httpClient = GetComponent<ECommerceApiComponent>().CreateClient();
// Add test product
var product = new Product { Name = "Gaming Laptop", Price = 1299.99m, Stock = 10 };
dbContext.Products.Add(product);
await dbContext.SaveChangesAsync();
// Act
var response = await httpClient.PostAsJsonAsync("/api/orders", new
{
ProductId = product.Id,
Quantity = 2,
CustomerEmail = "test@example.com"
});
// Assert
response.Should().BeSuccessful();
var order = await response.Content.ReadFromJsonAsync<Order>();
order.Should().NotBeNull();
order.Total.Should().Be(2599.98m);
// Verify database changes
var updatedProduct = await dbContext.Products.FindAsync(product.Id);
updatedProduct.Stock.Should().Be(8); // Stock decreased
var savedOrder = await dbContext.Orders.FindAsync(order.Id);
savedOrder.Should().NotBeNull();
savedOrder.Status.Should().Be(OrderStatus.Processing);
}
}
public class Startup : IAccelergreatStartup
{
public void Configure(IAccelergreatBuilder builder)
{
builder.AddAccelergreatComponent<ECommerceDatabaseComponent>();
builder.AddAccelergreatComponent<ECommerceApiComponent>();
}
}
🚀 Migration Guide
From Traditional Integration Tests
// Before: Manual Entity Framework setup/teardown
public class OrderTests : IClassFixture<DatabaseFixture>
{
private readonly DatabaseFixture _fixture;
public OrderTests(DatabaseFixture fixture)
{
_fixture = fixture;
}
[Fact]
public async Task Test()
{
using var dbContext = _fixture.CreateDbContext();
// Manual cleanup before test
dbContext.Orders.RemoveRange(dbContext.Orders);
dbContext.Products.RemoveRange(dbContext.Products);
await dbContext.SaveChangesAsync();
// Test code
var product = new Product { Name = "Test" };
dbContext.Products.Add(product);
await dbContext.SaveChangesAsync();
// Manual cleanup after test (or risk affecting other tests)
dbContext.Orders.RemoveRange(dbContext.Orders);
dbContext.Products.RemoveRange(dbContext.Products);
await dbContext.SaveChangesAsync();
}
}
// After: Accelergreat handles everything
[Fact]
public async Task Test()
{
var dbContext = GetComponent<TestDatabaseComponent>().DbContextFactory.NewDbContext();
// Test code - database auto-resets between tests!
var product = new Product { Name = "Test" };
dbContext.Products.Add(product);
await dbContext.SaveChangesAsync();
// No cleanup needed - next test gets fresh database
}
From WebApplicationFactory
// Before: Manual WebApplicationFactory
public class ApiTests : IClassFixture<WebApplicationFactory<Program>>
{
private readonly WebApplicationFactory<Program> _factory;
public ApiTests(WebApplicationFactory<Program> factory)
{
_factory = factory;
}
}
// After: Accelergreat component
public class ApiTests : AccelergreatXunitTest
{
public ApiTests(IAccelergreatEnvironmentPool environmentPool) : base(environmentPool)
{
}
[Fact]
public async Task Test()
{
var client = GetComponent<ApiComponent>().CreateClient();
// Test with auto-configured database!
}
}
🎯 Best Practices
1. Component Order Matters
public void Configure(IAccelergreatBuilder builder)
{
builder.AddAccelergreatComponent<DatabaseComponent>(); // First
builder.AddAccelergreatComponent<ApiComponent>(); // Second (depends on DB)
}
2. Use Environment-Specific Configuration
// Development: Fast transactions
// CI: Reliable snapshots
// Tests automatically run in parallel - no collections needed!
public class OrderCreationTests : AccelergreatXunitTest { }
public class OrderUpdateTests : AccelergreatXunitTest { }
public class ProductTests : AccelergreatXunitTest { }
// Optional: Use collections only for logical grouping
[Collection("SlowTests")]
public class LongRunningTests : AccelergreatXunitTest { }
4. Debugging Tips
// ⚠️ Important: In Visual Studio, don't click "Stop" during debugging
// Let tests complete naturally for proper cleanup
Accelergreat is completely free to use - No licensing fees, no restrictions, all features included.
All Features Available:
Transaction reset strategy
Microservices support
Database providers
Parallel execution
Environment pooling
📝 Documentation Notice: This documentation has been generated using Cursor AI to improve clarity and developer experience. While every effort has been made to proofread and ensure accuracy, if you encounter any issues or inaccuracies, please contact us at mail@accelergreat.net.
Made with ❤️ by developers, for developers. Transform your integration testing experience with Accelergreat 4.0.
