nancy Getting started with nancy Setup Nancyfx with Dotnet core v1.1, Kestrel, and Visual Studio Code on *nix systems

Example

Prerequiste steps:

1. Get dotnet core for your platform:

   Dotnet Core

2. Follow instructions and make sure dotnet core is working
3. Get Visual Studio Code for your platform:

   VS Code

4. Launch Visual Studio Code (VS code) and install the C# extension then reload

Create self hosted NancyFx project:

1. Setup a project with a correct project directory structure.

   Open Bash Terminal and type:

   mkdir nancydotnetcore
   cd nancydotnetcore
   mkdir src 
   mkdir test
   touch global.json
   

2. Open global.json and enter the following code:

   {
       "projects":["src", "test"]
   }
   

3. In Bash terminal:

   cd src 
   mkdir NancyProject1
   dotnet new 
   

   Open folder NancyProject1 in VS code

   You will get a warning: "Required assets to build and debug are missing from 'nancyproject1'."

   Click "Yes"

   Also you will see: There are unresolved dependencies from 'project.json'. Please execute the restore command to continue.

   Click "Close" we will get to this soon.

4. Add the dependencies, open "project.json" and overwrite it with the following:

   {
       "version": "1.0.0-*",
       "buildOptions": {
           "debugType": "portable",
           "emitEntryPoint": true
       },
   
       "frameworks": {
           "netcoreapp1.1": {
               "dependencies": {
                   "Microsoft.AspNetCore.Hosting": "1.1.0",
                   "Microsoft.AspNetCore.Server.Kestrel": "1.1.0",
                   "Microsoft.AspNetCore.Owin": "1.1.0",
                   "Nancy": "2.0.0-barneyrubble",
                   "Microsoft.NETCore.App": {
                       "type": "platform",
                       "version": "1.1.0"
                   }
               }
           }
       }
   }
   

   VS code will ask to restore click "Restore"

5. Create folder "Modules" in VSCode project

   In the Modules folder add a file named "IndexModule.cs" then copy and save the following:

   namespace NancyProject1
   {
       using Nancy;
       public class IndexModule : NancyModule
       {
           public IndexModule()
           {
               Get("/", _ => "Hello dotnet core world!");
           }
       }
   }
   

6. In the root directory of the project create a file called "Startup.cs" and copy and paste the following:

   namespace NancyProject1
   {
       using Microsoft.AspNetCore.Builder;
       using Nancy.Owin;
   
       public class Startup
       {
           public void Configure(IApplicationBuilder app)
           {
               app.UseOwin(x => x.UseNancy());
           }
       }
   }
   

7. Open file "Program.cs" and overwrite the content with the following and save:

   namespace NancyProject1
   {
       using System.IO;
       using Microsoft.AspNetCore.Builder;
       using Microsoft.AspNetCore.Hosting;
   
       public class Program
       {
           public static void Main(string[] args)
           {
               var host = new WebHostBuilder()
                   .UseContentRoot(Directory.GetCurrentDirectory())
                   .UseKestrel()
                   .UseStartup<Startup>()
                   .Build();
   
               host.Run();
           }
       }
   }
   

8. Done! Now lets run this and see the output.

   Click the debug symbol in VS Code, and Click the run button. It should compile and start the project.

   Open the browser @ http://localhost:5000

9. Pat yourself on the back and enjoy!