Marktek.Fluent.Testing.Engine 2.0.0.1

#Github Repo https://github.com/markcunninghamuk/MarkTek.FluentApi.Testing

Introduction (v1.0.0.15 onwards)

A flexible engine allowing you to focus on reusable components and removing the need to have messy, unreadable tests. Scenarios where you will consider using it:

• Data-based testing
• Enforcing maximum reuse of test scenarios (Single Responsibility Principle)
• Readable tests
• Complex domains where entity behavior is highly coupled
• You require test code to match production grade
• You require a standard approach to testing
• Fluent API, making it more focused
• Parallel test executions, most approaches load data at the start and wipe at the end, but for parallel runs this is not always a good approach

Note One thing to mention here, is you will need to know C# to use the framework.

Getting Started

To get started you will need to install the nuget package using the command

Install-Package Marktek.Fluent.Testing.Engine -Version 1.0.0.15

Once you start you need to know 1 thing: what is the data type of the primary key of your entities. In most cases for example databases, it is a big int. In systems like Dynamics 365 and Salesforce, it could be a Guid.

To get started you need to instantiate a RecordService. The RecordService is a generic class that allows you to pass in the datatype you are working with.

Example

My system uses Guids on the record and I require to create a record. When you create a new RecordService, you must pass in an AggregateId, The AggregateId is used to cleandown and the end, and is also the identifier of the parent record that you will create. Everything hangs off an aggregate in a relational database model. For NoSQL databases, you don't need to worry as much as you can create a complex object in one hit.

var service = new RecordService<Guid>(Guid.NewGuid());

Once you have instantiated the service you can call the following Methods, below is an example of what a test should typically look like

var service = new RecordService<Guid>(Guid.NewGuid());

service
    .CreateRecord(new ActiveOrder(service.AggregateId))
    .AssignAggregateId()
    .If(DateTime.Now.Hour > 15, x => x.CreateRelatedRecord(new OrderLine(Guid.NewGuid())))
    .ExecuteAction(new SetShippingDate())
    .Delay(5000)
    .ExecuteActionOnAggregate(new CancelOrder())
    .Delay(1000)
    .AssertAgainst(new MustBeCancelled())
    .Cleanup(new Cleanup());