Suave Web Services

I’m on this quest to learn F#. It is a multi-year project because of a couple of reasons

  • I don’t spend enough time on it
  • I’m not very bright

Today’s adventure has been using the which is a web framework library and web server. If you’re looking to throw up a quick web service to act as a microservice it doesn’t get much lighter weight than Suave. At the same time you can make more complex processes if necessary.

The Monsters Weekly - Episode 84 - Integration Testing with Entity Framework Core

Entity Framework Core makes it easy to write tests that execute against an in-memory store but sometimes we want to actually run our tests against a real relational database. In this episode, Monster Dave looks at how to create an integration test that runs against a real SQL Server database.

Blog Post
GitHub Repo

Follow @aspnetmonsters

The Monsters Weekly - Episode 83 - A Book on ASP.NET Core

Today we have the pleasure of announcing the release of a new source of reference for building an application in ASP.NET Core MVC.
Over the last two years we have had the great fortune of serving the ASP.NET community, sharing in our learning, getting tonnes of feedback and having a great time exploring the next version of ASP.NET.  In this episode, we shamelessly plug the table of contents for our newly released book. Join the Monsters to hear more about what is sure to be a timeless classic, coffee table material in every household.

Get the Book on ASP.NET Core MVC

Announcing the Microsoft Press “ASP.NET Core Application Development” Book from the ASP.NET Monsters

Buy Now

ASP.NET Core Application Development

Through four complete sprints, this book takes you through every step needed to build brand new cross-platform web apps with ASP.NET Core, and make them available on the Internet. You won’t just master Microsoft’s revolutionary open source ASP.NET Core technology: you’ll learn how to integrate the immense power of MVC, Docker, Azure Web Apps, Visual Studio and Visual Studio Code, C#, JavaScript, TypeScript, and Entity Framework.

Working through the authors’ carefully designed sprints, you’ll start with a blank canvas, move through software architecture and design, adjusting to user feedback, recovering from mistakes, builds, testing, deployment, maintenance, refactoring, and more. Along the way, you’ll learn techniques for delivering state-of-the-art software to users more rapidly and repeatably than ever before.

The Monsters Weekly - Episode 82 - Node Services

I can’t remember if NodeJS is still cool or if people are only using it ironically now as they port their applications to something else. In either case there are still a lot of great node modules out there which it would be great to access from our ASP.NET application. In this episode we’ll look at Node Services an approach to call out to Node from inside an ASP.NET MVC Core controller. 



Integration Testing with Entity Framework Core and SQL Server

Originally posted to:

Entity Framework Core makes it easy to write tests that execute against an in-memory store. Using an in-memory store is convenient since we don’t need to worry about setting up a relational database. It also ensures our unit tests run quickly so we aren’t left waiting hours for a large test suite to complete.

While Entity Framework Core’s in-memory store works great for many scenarios, there are some situations where it might be better to run our tests against a real relational database. Some examples include when loading entities using raw SQL or when using SQL Server specific features that can not be tested using the in-memory provider. In this case, the tests would be considered an integration test since we are no longer testing our Entity Framework context in isolation. We are testing how it will work in the real world when connected to SQL Server.

The Sample Project

For this example, I used the following simple model and DbContext classes.

public class Monster
public int Id { get; set; }
public string Name { get; set; }
public bool IsScary { get; set; }
public string Colour { get; set; }
public class MonsterContext : DbContext
public MonsterContext(DbContextOptions<MonsterContext> options)
: base(options)
public DbSet<Monster> Monsters { get; set; }

In an ASP.NET Core application, the context is configured to use SQL Server in the Startup.ConfigureServices method.

{% codeblock lang:csharp %} services.AddDbContext(options => { options.UseSqlServer("DefaultConnection"); }); {% endcodeblock %}

The DefaultConnection is defined in appsettings.json which is loaded at startup.

{% codeblock lang:javascript %} { "ConnectionStrings": { "DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=monsters_db;Trusted_Connection=True;MultipleActiveResultSets=true" } } {% endcodeblock %}

The MonsterContext is also configured to use Migrations which were initialized using the dotnet ef migrations add InitialCreate command. For more on Entity Framework Migrations, see the official tutorial.

As a simple example, I created a query class that loads scary monsters from the database using a SQL query instead of querying the Monsters DbSet directly.

{% codeblock lang:csharp %} public class ScaryMonstersQuery { private MonsterContext _context; public ScaryMonstersQuery(MonsterContext context) { _context = context; } public IEnumerable Execute() { return _context.Monsters .FromSql("SELECT Id, Name, IsScary, Colour FROM Monsters WHERE IsScary = {0}", true); } } {% endcodeblock %}

To be clear, a better way to write this query is _context.Monster.Where(m => m.IsScary == true), but I wanted a simple example. I also wanted to use FromSql because it is inherently difficult to unit test. The FromSql method doesn’t work with the in-memory provider since it requires a relational database. It is also an extension method which means we can’t simply mock the context using a tool like Moq. We could of course create a wrapper service that calls the FromSql extension method and mock that service but this only shifts the problem. The wrapper approach would allow us to ensure that FromSql is called in the way we expect it to be called but it would not be able to ensure that the query will actually run successfully and return the expected results.

An integration test is a good option here since it will ensure that the query runs exactly as expected against a real SQL Server database.

The Test

I used xunit as the test framework in this example. In the constructor, which is the setup method for any tests in the class, I configure an instance of the MonsterContext connecting to a localdb instance using a database name containing a random guid. Using a guid in the database name ensures the database is unique for this test. Uniqueness is important when running tests in parallel because it ensures these tests won’t impact any other tests that aer currently running. After creating the context, a call to _context.Database.Migrate() creates a new database and applies any Entity Framework migrations that are defined for the MonsterContext.

{% codeblock lang:csharp %} public class SimpleIntegrationTest : IDisposable { MonsterContext _context; public SimpleIntegrationTest() { var serviceProvider = new ServiceCollection() .AddEntityFrameworkSqlServer() .BuildServiceProvider(); var builder = new DbContextOptionsBuilder(); builder.UseSqlServer($"Server=(localdb)\\mssqllocaldb;Database=monsters_db_{Guid.NewGuid()};Trusted_Connection=True;MultipleActiveResultSets=true") .UseInternalServiceProvider(serviceProvider); _context = new MonsterContext(builder.Options); _context.Database.Migrate(); } [Fact] public void QueryMonstersFromSqlTest() { //Add some monsters before querying _context.Monsters.Add(new Monster { Name = "Dave", Colour = "Orange", IsScary = false }); _context.Monsters.Add(new Monster { Name = "Simon", Colour = "Blue", IsScary = false }); _context.Monsters.Add(new Monster { Name = "James", Colour = "Green", IsScary = false }); _context.Monsters.Add(new Monster { Name = "Imposter Monster", Colour = "Red", IsScary = true }); _context.SaveChanges(); //Execute the query ScaryMonstersQuery query = new ScaryMonstersQuery(_context); var scaryMonsters = query.Execute(); //Verify the results Assert.Equal(1, scaryMonsters.Count()); var scaryMonster = scaryMonsters.First(); Assert.Equal("Imposter Monster", scaryMonster.Name); Assert.Equal("Red", scaryMonster.Colour); Assert.True(scaryMonster.IsScary); } public void Dispose() { _context.Database.EnsureDeleted(); } } {% endcodeblock %}

The actual test itself happens in the QueryMonstersFromSqlTest method. I start by adding some sample data to the database. Next, I create and execute the ScaryMonstersQuery using the context that was created in the setup method. Finally, I verify the results, ensuring that the expected data is returned from the query.

The last step is the Dispose method which in xunit is the teardown for any tests in this class. We don’t want all these test databases hanging around forever so this is the place to delete the database that was created in the setup method. The database is deleted by calling _context.Database.EnsureDeleted().

Use with Caution

These tests are slow! The very simple example above takes 13 seconds to run on my laptop. My advice here is to use this sparingly and only when it really adds value for your project. If you end up with a large number of these integration tests, I would consider splitting the integration tests into a separate test suite and potentially running them on a different schedule than my unit test suite (e.g. Nightly instead of every commit).

The Code

You can browse or download the source on GitHub.

The Monsters Weekly - Episode 81 - Invoking View Components as Tag Helpers

A new feature in ASP.NET Core 1.1 allows us to invoke view components as tag helpers. Monster Dave shows us how to enable this new feature.

Related Episode - View Components

Creating a New View Engine in ASP.NET Core

Originally posted to:

Earlier in November, the ASP.NET Monsters had the opportunity to take part in the ASP.NET Core hackathon at the Microsoft MVP Summit. In past years, we have used the hackathon as an opportunity to spend some time working on GenFu. This year, we wanted to try something a little different.

The Crazy Idea

A few months ago, we had Taylor Mullen on The Monsters Weekly to chat about Razor in ASP.NET Core. At some point during that interview, it was pointed that MVC is designed in a way that a new view engine could easily be plugged into the framework. It was also noted that implementing a view engine is a really big job. This got us to thinking…what if we could find an existing view engine of some sort. How easy would it be to get actually put a new view engine in MVC?

And so, that was our goal for the hackathon. Find a way to replace Razor with an alternate view engine in a single day of hacking.

Finding a Replacement

We wanted to pick something that in no way resembled Razor. Simon suggested Pug (previously known as Jade), a popular view template engine used in Express. In terms of syntax, Pug is about as different from Razor as it possibly could be. Pug uses whitespace to indicate nesting of elements and does away with angle brackets all together. For example, the following template:

a(href='') Google

would generate this HTML:

<a href="">Google</a>

Calling Pug from ASP.NET Core

The first major hurdle for us was figuring out a way to compile pug templates from within an ASP.NET Core application. Pug is a JavaScript based template engine and we only had a single day to pull this off so a full port of the engine to C# was not feasible.

Our first thought was to use Edgejs to call Pug’s JavaScript compile function. Some quick prototyping showed us that this worked but Edgejs doesn’t have support for .NET Core. This lead us to explore the JavaScriptServices packages created by the ASP.NET Core team. Specifically the Node Services package which allows us to easily call out to a JavaScript module from within an ASP.NET Core application.

To our surpise, this not only worked, it was also easy! We created a very simple file called pugcompile.js.

var pug = require('pug');
module.exports = function (callback, viewPath, model) {
var pugCompiledFunction = pug.compileFile(viewPath);
callback(null, pugCompiledFunction(model));

Calling this JavaScript from C# is easy thanks to the Node Services package. Assuming model is the view model we want to bind to the template and mytemplate.pug is the name of the file containing the pug template:

{% codeblock lang:csharp %} var html = await _nodeServices.InvokeAsync("pugcompile", "mytemplate.pug", model); {% endcodeblock %}

Now that we had proven this was possible, it was time to integrate this with MVC by creating a new MVC View Engine.

Creating the Pugzor View Engine

We decided to call our view engine Pugzor which is a combination of Pug and Razor. Of course, this doesn’t really make much sense since our view engine really has nothing to do with Razor but naming is hard and we thought we were being funny.

Keeping in mind our goal of implenting a view engine in a single day, we wanted to do this with the simplest way possible. After spending some time digging through the source code for MVC, we determined that we needed to implement the IViewEngine interface as well as implement a custom IView.

The IViewEngine is responsible for locating a view based on a ActionContext and a ViewName. When a controller returns a View, it is the IViewEngine‘s FindView method that is responsible for finding a view based on some convetions. The FindView method returns a ViewEngineResult which is a simple class containing a boolean Success property indicating whether or not a view was found and an IView View property containing the view if it was found.

{% codeblock lang:csharp %} /// /// Defines the contract for a view engine. /// public interface IViewEngine { /// /// Finds the view with the given using view locations and information from the /// . /// /// The . /// The name of the view. /// Determines if the page being found is the main page for an action. /// The of locating the view. ViewEngineResult FindView(ActionContext context, string viewName, bool isMainPage); /// /// Gets the view with the given , relative to /// unless is already absolute. /// /// The absolute path to the currently-executing view, if any. /// The path to the view. /// Determines if the page being found is the main page for an action. /// The of locating the view. ViewEngineResult GetView(string executingFilePath, string viewPath, bool isMainPage); } {% endcodeblock %}

We decided to use the same view location conventions as Razor. That is, a view is located in Views/{ControllerName}/{ActionName}.pug.

Here is a simplified version of the FindView method for the PugzorViewEngine:

{% codeblock lang:csharp %} public ViewEngineResult FindView( ActionContext actionContext, string viewName, bool isMainPage) { var controllerName = GetNormalizedRouteValue(actionContext, ControllerKey); var checkedLocations = new List(); foreach (var location in _options.ViewLocationFormats) { var view = string.Format(location, viewName, controllerName); if(File.Exists(view)) return ViewEngineResult.Found("Default", new PugzorView(view, _nodeServices)); checkedLocations.Add(view); } return ViewEngineResult.NotFound(viewName, checkedLocations); } {% endcodeblock %}

You can view the complete implentation on GitHub.

Next, we created a class called PugzorView which implements IView. The PugzorView takes in a path to a pug template and an instance of INodeServices. The MVC framework calls the IView‘s RenderAsync when it is wants the view to be rendered. In this method, we call out to pugcompile and then write the resulting HTML out to the view context.

{% codeblock lang:csharp %} public class PugzorView : IView { private string _path; private INodeServices _nodeServices; public PugzorView(string path, INodeServices nodeServices) { _path = path; _nodeServices = nodeServices; } public string Path { get { return _path; } } public async Task RenderAsync(ViewContext context) { var result = await _nodeServices.InvokeAsync("./pugcompile", Path, context.ViewData.Model); context.Writer.Write(result); } } {% endcodeblock %}

The only thing left was to configure MVC to use our new view engine. At first, we thought we could easy add a new view engine using the AddViewOptions extension method when adding MVC to the service collection.

.AddViewOptions(options =>
options.ViewEngines.Add(new PugzorViewEngine(nodeServices));

This is where we got stuck. We can’t add a concrete instance of the PugzorViewEngine to the ViewEngines collection in the Startup.ConfigureServices method because the view engine needs to take part in dependency injection. The PugzorViewEngine has a dependency on INodeServices and we want that to be injected by ASP.NET Core’s dependency injection framework. Luckily, the all knowning Razor master Taylor Mullen was on hand to show us the right way to register our view engine.

The recommended approach for adding a view engine to MVC is to create a custom setup class that implements IConfigureOptions<MvcViewOptions>. The setup class takes in an instance of our IPugzorViewEngine via constructor injection. In the configure method, that view engine is added to the list of view engines in the MvcViewOptions.

{% codeblock lang:csharp %} public class PugzorMvcViewOptionsSetup : IConfigureOptions { private readonly IPugzorViewEngine _pugzorViewEngine; /// /// Initializes a new instance of . /// /// The . public PugzorMvcViewOptionsSetup(IPugzorViewEngine pugzorViewEngine) { if (pugzorViewEngine == null) { throw new ArgumentNullException(nameof(pugzorViewEngine)); } _pugzorViewEngine = pugzorViewEngine; } /// /// Configures to use . /// /// The to configure. public void Configure(MvcViewOptions options) { if (options == null) { throw new ArgumentNullException(nameof(options)); } options.ViewEngines.Add(_pugzorViewEngine); } } {% endcodeblock %}

Now all we need to do is register the setup class and view engine the Startup.ConfigureServices method.

services.AddTransient<IConfigureOptions<MvcViewOptions>, PugzorMvcViewOptionsSetup>();
services.AddSingleton<IPugzorViewEngine, PugzorViewEngine>();

Like magic, we now have a working view engine. Here’s a simple example:


public IActionResult Index()
ViewData.Add("Title", "Welcome to Pugzor!");
ModelState.AddModelError("model", "An error has occurred");
return View(new { People = A.ListOf<Person>() });


block body
h2 Hello
p #{ViewData.title}
th Name
th Title
th Age
each val in people
td= val.firstName
td= val.title
td= val.age


<p>Welcome to Pugzor! </p>
<table class="table">
<tr><td>Gabriel</td><td>Mr. </td><td>62</td></tr>
<tr><td>Isaiah</td><td>Air Marshall</td><td>39</td></tr>
<tr><td>Sean</td><td>Mr. </td><td>5</td></tr>
<tr><td>Lillian</td><td>Mr. </td><td>3</td></tr>
<tr><td>Allison</td><td>Mr. </td><td>21</td></tr>
<tr><td>Jonathan</td><td>Air Marshall</td><td>63</td></tr>

All the features of pug work as expected, including templage inheritance and inline JavaScript code. Take a look at our test website for some examples.

Packaging it all up

So we reached our goal of creating an alternate view engine for MVC in a single day. We had some time left so we thought we would try to take this one step further and create a NuGet package. There were some challenges here, specifically related to including the required node modules in the NuGet package. Simon is planning to write a separate blog post on that topic.

You can give it a try yourself. Add a reference to the pugzor.core NuGet package then call .AddPugzor() after .AddMvc() in the Startup.ConfigureServices method.

{% codeblock lang:chsarp %} public void ConfigureServices(IServiceCollection services) { // Add framework services. services.AddMvc().AddPugzor(); } {% endcodeblock %}

Razor still works as the default but if no Razor view is found, the MVC framework will try using the PugzorViewEngine. If a matching pug template is found, that template will be rendered.


Wrapping it up

We had a blast working on this project. While this started out as a silly excercise, we sort of ended up with something that could be useful. We were really surprised at how easy it was to create a new view engine for MVC. We don’t expect that Pugzor will be wildly popular but since it works we thought we would put it out there and see what people think.

We have some open issues and some ideas for how to extend the PugzorViewEngine. Let us know what you think or jump in and contribute some code. We accept pull requests :-)

The Monsters Weekly - Episode 80 - ASP.NET 1.1 was Released...Time to Pump the Brakes?

ASP.NET Core 1.1, .NET Core 1.1, EF Core 1.1 and a multitude of other packages have all been released, but is now the time to adopt?

In this episode Monsters Dave and James talk about the release of ASP.NET 1.1 and how it will affect your projects. They mash on the tooling, upgrading a package and their experiences so far and hint at a few topics that are coming in future episodes.

For additional details on the release, be sure to check out these links:

Please , like and share, or comment and ask questions below.

The Monsters Weekly - Episode 79 - Code Labs with Jon Galloway

If you’re looking for content that will walk you through, step-by-step, as you transition to ASP.NET Core MVC, you’re in for a treat.

In this episode of the Monsters, Jon Gallaway joins us live on set at Channel 9 studios to talk about the .NET Core community, the Community Standups and, of course, a series of free labs that you can dive into to embrace your inner Core and learn more about the future of MVC.

Check out the labs yourself on GitHub:

Please , like and share, or comment and ask questions below.