generator-aspnet
Yeoman generator for ASP.NET 5 projects
Getting Started
- Dependencies:
- Node.js:
brew install nodefor Mac OS X,choco install nodejsfor Windows OS - Yeoman:
npm install -g yo
- Node.js:
- Install:
npm install -g generator-aspnet - Run:
yo aspnet
Usage
-
yo aspnetshows a wizard for generating a new ASP.NET app -
yo aspnet --gruntgeneratesGruntfile.jsfiles for web templates instead ofgulpfile.js -
yo aspnet --helpshows flags and other configurable options
Template projects
Full, template based projects available in generator:
- Empty Application
- Console Application
- Web Application
- Web Application Basic [without Membership and Authorization]
- Web API Application
- Nancy ASP.NET Application
- Class Library
- Unit Test project
The Empty Application, Console Application, Web Application, Web Application Basic (a.k.a. Web Application No Auth), Web API Application and Class Library are based on the templates introduced with Visual Studio 2015. They are available and maintained in the ASP.NET Templates project.
ASP.NET Templates provide project templates which are used in Visual Studio for creating ASP.NET 5 applications.
The Nancy project is based on framework's "Hello World" template: Nancy Getting Started: Introduction
The Docker support with Dockerfile configuration files is based on the official Docker image for ASP.NET 5
Related yeoman generators
The goal of generator-aspnet is to provide an experience consistent with creating new ASP.NET 5 (DNX) projects
and files in Visual Studio 2015.
The list of related generators can be seen on our Wiki section
Sub Generators
The alphabetic list of available sub generators (to create files after the project has been created):
- aspnet:AngularController
- aspnet:AngularControllerAs
- aspnet:AngularDirective
- aspnet:AngularFactory
- aspnet:AngularModule
- aspnet:AppSettings
- aspnet:BowerJson
- aspnet:Class
- aspnet:CoffeeScript
- aspnet:Dockerfile
- aspnet:gitignore
- aspnet:Gruntfile
- aspnet:Gulpfile
- aspnet:HTMLPage
- aspnet:Interface
- aspnet:JavaScript
- aspnet:JScript
- aspnet:JSON
- aspnet:JSONSchema
- aspnet:JSX
- aspnet:Middleware
- aspnet:MvcController
- aspnet:MvcView
- aspnet:nuget
- aspnet:PackageJson
- aspnet:readme
- aspnet:StartupClass
- aspnet:StyleSheet
- aspnet:StyleSheetLess
- aspnet:StyleSheetScss
- aspnet:TagHelper
- aspnet:TextFile
- aspnet:tfignore
- aspnet:TypeScript
- aspnet:TypeScriptConfig
- aspnet:TypeScriptJSX
- aspnet:UserSecrets
- aspnet:WebApiContoller
** Note: files generated are created in the working directory, no conventions are forced **
AngularController
Creates AngularJS controller file using $scope
Example:
yo aspnet:AngularController filename
Produces filename.js
AngularControllerAs
Creates AngularJS controller file using Controller As syntax.
Example:
yo aspnet:AngularControllerAs filename
Produces filename.js
AngularDirective
Creates AngularJS directive file.
Example:
yo aspnet:AngularDirective filename
Produces filename.js
AngularFactory
Creates AngularJS factory file.
Example:
yo aspnet:AngularFactory filename
Produces filename.js
AngularModule
Creates AngularJS module file
Example:
yo aspnet:AngularModule filename
Produces filename.js
AppSettings
Creates a new appsettings.json file
Example:
yo aspnet:AppSettings
Produces appsettings.json
BowerJson
Creates a new bower.json and configuration file.
Example:
yo aspnet:BowerJson
Produces bower.json and .bowerrc
Class
Creates a new ASP.NET 5 Class
Example:
yo aspnet:Class Contact
Produces /Contact.cs
using System;
namespace MyNamespace
{
public class Contact
{
}
}CoffeeScript
Creates a new CoffeeScript file
Example:
yo aspnet:CoffeeScript filename
Produces filename.coffee
Dockerfile
Creates a new Docker configuration file.
By default Mono based definition file is created.
To create CoreCLR based definition file use --coreclr option
Example:
yo aspnet:Dockerfile
Creates a new Dockerfile
Are you curious about Docker, Linux containers and ASP.NET 5 Docker image and all these buzz words?
- Docker image for ASP.NET 5 (Docker Hub)
- Running ASP.NET 5 applications in Linux Containers with Docker (MSDN)
- ASP.NET 5 : Continuous Integration with Travis-CI, Tutum, Docker, Webhooks and Azure [Advanced]
gitignore
Creates a new .gitignore file
Example:
yo aspnet:gitignore
Produces .gitignore
Gruntfile
Creates a new Grunt file
Example:
yo aspnet:Gruntfile
Produces Gruntfile.js
Gulpfile
Creates a new Gulp file
Example:
yo aspnet:Gulpfile
Produces gulpfile.js
HTMLPage
Creates a new HTML file
Example:
yo aspnet:HTMLPage filename
Produces filename.html
Interface
Creates a new ASP.NET 5 Interface
Example:
yo aspnet:Interface IContact
Produces /IContact.cs
JavaScript
Creates a new JavaScript file
Example:
yo aspnet:JavaScript filename
Produces filename.js
JScript
Creates a new JavaScript file
Example:
yo aspnet:JScript filename
Produces filename.js
JSON
Creates a new JSON file
Example:
yo aspnet:JSON filename
Produces filename.json
JSONSchema
Creates a new JSON schema file
Example:
yo aspnet:JSONSchema filename
Produces filename.json
JSX
Creates a new React JSX file
Example:
yo aspnet:JSX filename
Produces filename.jsx
Middleware
Creates a new C# Middleware class file
Example:
yo aspnet:Middleware filename
Produces filename.cs
MvcController
Creates a new ASP.NET 5 MvcController class
Example:
yo aspnet:MvcController ContactController
Produces /ContactController.cs
using Microsoft.AspNet.Mvc;
// For more information on enabling MVC for empty projects, visit http://go.microsoft.com/fwlink/?LinkID=397860
namespace MyNamespace
{
public class ContactController : Controller
{
// GET: /<controller>/
public IActionResult Index()
{
return View();
}
}
}MvcView
Creates a new ASP.NET 5 MvcView page file
Example:
yo aspnet:MvcView ContactView
Produces /ContactView.cshtml
@*
For more information on enabling MVC for empty projects, visit http://go.microsoft.com/fwlink/?LinkID=397860
*@
@{
// ViewBag.Title = "ContactView Page";
}
nuget
Creates a new NuGet.config file. The support for unstable development
feed is provided by --unstable option.
Example:
yo aspnet:nuget --unstable
Produces NuGet.config with unstable NuGet feed
PackageJson
Creates a new package.json file
Example:
yo aspnet:PackageJson
Produces package.json
README
Creates a new REAMDE.md documentation file in Markdown format
You can optionally pass --txt option to use .txt extension.
Example:
yo aspnet:readme [--txt]
Produces readme.md
StartupClass
Creates a new Startup Class file
Example:
yo aspnet:StartupClass
Produces Startup.cs
StyleSheet
Creates a new CSS file
Example:
yo aspnet:StyleSheet style
Produces style.css
StyleSheetLess
Creates a new Less class file
Example:
yo aspnet:StyleSheetLess filename
Produces filename.less
StyleSheetSCSS
Creates a new Sass SCSS class file
Example:
yo aspnet:StyleSheetSCSS filename
Produces filename.scss
TagHelper
Creates a new TagHelper class file
Example:
yo aspnet:TagHelper filename
Produces filename.cs
TextFile
Creates a new Text file
Example:
yo aspnet:TextFile filename
Produces filename.txt
tfignore
Creates a new .tfignore file
Example:
yo aspnet:tfignore
Produces .tfignore
TypeScript
Creates a new TypeScript file
Example:
yo aspnet:TypeScript filename
Produces filename.ts
TypeScriptConfig
Creates a new TypeScript configuration file
Example:
yo aspnet:TypeScriptConfig
Produces tsconfig.json
TypeScriptJSX
Creates a new JSX-enabled TypeScript file
Example:
yo aspnet:TypeScriptJSX filename
Produces filename.tsx
UserSecrets
Adds UserSecrets information to ASP.NET5 project.json file.
The generator do not update existing keys if found and does
not create new project.json file.
Example:
yo aspnet:UserSecrets
This will add following keys to project.json:
- "userSecretsId" key
- "Microsoft.Extensions.Configuration.UserSecrets" key under "dependencies"
WebApiController
Creates a new ASP.NET 5 WebApiController class
Example:
yo aspnet:WebApiController ValuesController
Produces /ValuesController.cs
using System;
using System.Collections.Generic;
using System.Linq;
using Microsoft.AspNet.Mvc;
// For more information on enabling Web API for empty projects, visit http://go.microsoft.com/fwlink/?LinkID=397860
namespace MyNamespace.Controllers
{
[Route("api/[controller]")]
public class ValuesController : Controller
{
// GET: api/values
[HttpGet]
public IEnumerable<string> Get()
{
return new string[] { "value1", "value2" };
}
// GET api/values/5
[HttpGet("{id}")]
public string Get(int id)
{
return "value";
}
// POST api/values
[HttpPost]
public void Post([FromBody]string value)
{
}
// PUT api/values/5
[HttpPut("{id}")]
public void Put(int id, [FromBody]string value)
{
}
// DELETE api/values/5
[HttpDelete("{id}")]
public void Delete(int id)
{
}
}
}License
Copyright 2014-2016 OmniSharp
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent