.NET Core 2.x REST API Template

Jon Mikel Inza

|
24,139 installs
| (3) | Free
Accelerate the creation of .NET Core 2.1.x API projects with minimal dependencies and a solution containing settings for DI/IoC, API versioning, automatic OpenAPI/Swagger documentation, separated layers, preconfigured mapping settings, preconfigured log settings, etc.

Description

This extension allows to create a .NET Core solution taking into account:

  • DI according to .NET Core 2.1.x practices (without external dependencies)
  • exception handling settings according to .NET Core 2.1.x practices (exception and validation filters are not required anymore)
  • AppSettings (.NET Core 2.1.x way)
  • mapping settings (based on Automapper)
  • OpenAPI basic configuration (can be enabled/disabled by configuration)
  • API Versioning (based on URL routes)
  • OpenAPI versioning
  • XML Comments included in Swagger

You will find here more information about how to install and use the extension.

Release notes

v0.3

  • API versioning (included in route url) based on .NET Core attributes
  • OpenAPI versioning integration

v0.4

  • updated solution structure to make it easier to understand
  • better VS integration within the "new project" menu
  • DI/IoT factorization (easier reuse in other projects)
  • test projects (using DI/IoT factorization, which improves "testability")
  • default XML comments to illustrate how to feed Swagger/OpenAPI comments
  • small fixes

v0.4.1

  • validation extension replaced by data annotations to increase simplicity (even though keeping the extension could make sense for rich business rules)

v0.4.2

  • fix to avoid issues with different local .NET Core versions

v0.5

  • Visual Studio 2019 upgrade

v0.5.1

  • Typo error fixes

v0.5.2

  • OpenAPI/Swagger documentation pragma instructions to build cleaner compilation messages

PragmaXMLComments.PNG

  • API return type examples and XML comments to build richer OpenAPI/Swagger documentation

ReturnTypeExample.PNG

v0.5.2.1

  • Updated tags for improved Visual Studio 2019 experience

v0.5.2.2

  • Bug fix

v0.5.2.3

  • Typo fix

v0.5.564.1

  • New versioning system

Upcoming features:

  • .NET Core 3.x upgrade has been published in preview here

I hope this will make you save some time. Feel free to send feedback.