Yeoman generator for ASP.NET Core apps at Washington State University
npm install generator-wsu-fais-vs15##### forked to start from generator-aspnet
!Version
!Downloads per month
> NOTE: The content has been updated for .NET Core 1.1.0 (project.json based). For more info see https://github.com/OmniSharp/generator-wsu-fais-vs15/wiki/Version-info
Yeoman generator for ASP.NET Core projects
- Dependencies:
- Node.js: brew install node for Mac OS X, choco install nodejs for Windows OS
- Yeoman: npm install -g yo
- Bower npm install -g bower
- Install: npm install -g generator-wsu-fais-vs15
- Run: yo aspnet
See also: Building Projects with Yeoman on docs.asp.net
> NOTE: Starting from RTM release Web Application and Web Application Basic project templates use Bundler Minifier tool instead of NPM based build systems like Gulp or Grunt. The Bundler tool is installed as part of tooling support for the project, the project.json contains relevant scripting integration and one can use that tool independently from console using its CLI interface. Visit Bundler tool WIKI for details.
Also see ASP NET Community Standup - June 21st, 2016 - Mads Visits for detailed information about this change introduction.
* yo aspnet shows a wizard for generating a new ASP.NET Core app
* yo aspnet --help shows flags and other configurable options
Full, template based projects available in generator:
- Empty Web Application
- Empty Web Application (F#)
- Console Application
- Console Application (F#)
- Web Application
- Web Application Basic [without Membership and Authorization]
- Web Application Basic [without Membership and Authorization] \(F#)
- Web API Application
- Web API Application (F#)
- Nancy ASP.NET Application
- Class Library
- Class Library (F#)
- Unit Test project (xUnit.net)
- Unit Test project (xUnit.net) (F#)
The Empty Web 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 project provides templates which are used in Visual Studio for creating ASP.NET Core applications.
> NOTE: Starting from RC2 dotnet release the web application template project no longer ships with built-in EF migration. For this reason you should call dotnet ef database update to scaffold database using template provided migrations!
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 Core
The Unit test project uses xUnit: a free, open source, community-focused unit testing tool for the .NET Framework
The templates that use client-side libraries are calling the bower install script to install Bower managed dependencies. You can skip the installation process by passing the --skip-install option to the generator, e.g. yo aspnet --skip-install. This should allow for a better experience when Development has been enabled.
The project type and application name can be specified as optional command line arguments:
yo aspnet [projecttype [applicationname] [uiframework]]
The valid project types are:
- emptyweb for Empty Web Application
- consoleapp for Console Application
- web for Web Application
- webbasic for Web Application Basic
- webapi for Web API Application
- nancy for Nancy ASP.NET Application
- classlibrary for Class Library
- unittest Unit Test project (xUnit.net)
The valid UI framework types are:
- bootstrap for Bootstrap (this is the default and does not have to be specified explicitly)
- semantic for Semantic UI
> Example: yo aspnet webbasic "my semantic app" semantic will create a "Web Application Basic" project called "my semantic app" using the Semantic UI framework.
> Example: yo aspnet webbasic "my bootstrap app" OR yo aspnet webbasic "my bootstrap app" bootstrap will create a "Web Application Basic" project called "my bootstrap app" using the Bootstrap framework.
The goal of generator-wsu-fais-vs15 is to provide an experience consistent with creating new ASP.NET Core dotnet cli projects
and files in Visual Studio 2015.
The list of related generators can be seen on our Wiki section
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:json
* aspnet:jsonschema
* aspnet:jsx
* aspnet:middleware
* aspnet:mvccontroller
* aspnet:mvcview
* aspnet:nuget
* aspnet:packagejson
* aspnet:program
* aspnet:readme
* aspnet:startup
* aspnet:stylesheet
* aspnet:stylesheetless
* aspnet:stylesheetscss
* aspnet:taghelper
* aspnet:textfile
* aspnet:tfignore
* aspnet:typescript
* aspnet:typescriptconfig
* aspnet:typescriptjsx
* aspnet:usersecrets
* aspnet:webapicontroller
Note: files generated are created in the working directory, no conventions are forced
Creates AngularJS controller file using $scope
Example:
``
yo aspnet:angularcontroller filename
Produces filename.js
Creates AngularJS controller file using Controller As syntax.
Example:
`
yo aspnet:angularcontrolleras filename
Produces filename.js
Creates AngularJS directive file.
Example:
`
yo aspnet:angulardirective filename
Produces filename.js
Creates AngularJS factory file.
Example:
`
yo aspnet:angularfactory filename
Produces filename.js
Creates AngularJS module file
Example:
`
yo aspnet:angularmodule filename
Produces filename.js
Creates a new appsettings.json file
Example:
`
yo aspnet:appsettings
Produces appsettings.json
Creates a new bower.json and configuration file.
Example:
`
yo aspnet:bowerjson
Produces bower.json and .bowerrc
Creates a new ASP.NET Core class
Example:
`
yo aspnet:class Contact
Produces /Contact.cs
Creates a new CoffeeScript file
Example:
`
yo aspnet:coffeescript filename
Produces filename.coffee
Creates a new Docker configuration file.
To create Docker image with SQLite support for EntityFramework use --sqlite option
Example:
`
yo aspnet:dockerfile
Creates a new Dockerfile
Are you curious about Docker, Linux containers and ASP.NET Core 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]](http://tattoocoder.com/asp-net-5-continuous-integration-with-travis-ci-tutum-docker-webhooks-and-azure/)
- ASP.NET 5 on Docker talk at NDC {London} by Mark Rendle
Creates a new .gitignore file
Example:
`
yo aspnet:gitignore
Produces .gitignore
Creates a new Grunt file
Example:
`
yo aspnet:gruntfile
Produces Gruntfile.js
Creates a new Gulp file
Example:
`
yo aspnet:gulpfile
Produces gulpfile.js
Creates a new HTML file
Example:
`
yo aspnet:htmlpage filename
Produces filename.html
Creates a new ASP.NET Core interface
Example:
`
yo aspnet:interface IContact
Produces /IContact.cs
Creates a new JavaScript file
Example:
`
yo aspnet:javascript filename
Produces filename.js
Creates a new JSON file
Example:
`
yo aspnet:json filename
Produces filename.json
Creates a new JSON schema file
Example:
`
yo aspnet:jsonschema filename
Produces filename.json
Creates a new React JSX file
Example:
`
yo aspnet:jsx filename
Produces filename.jsx
Creates a new C# middleware class file
Example:
`
yo aspnet:middleware filename
Produces filename.cs
Creates a new ASP.NET Core MvcController class
Example:
`
yo aspnet:mvccontroller ContactController
Produces /ContactController.cs
Read more about MVC Controllers on docs.asp.net
Creates a new ASP.NET Core MvcView page file
Example:
`
yo aspnet:mvcview ContactView
Produces /ContactView.cshtml
Read more about MVC Views on docs.asp.net
Creates a new NuGet.config file. The support for unstable development--unstable
feed is provided by option.
Example:
`
yo aspnet:nuget --unstable
Produces NuGet.config with unstable NuGet feed
Creates a new package.json file
Example:
`
yo aspnet:packagejson
Produces package.json
Creates a new Program.cs file
Example:
`
yo aspnet:program
Produces Program.cs
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
Creates a new Startup.cs file
Example:
`
yo aspnet:startup
Produces Startup.cs
Creates a new CSS file
Example:
`
yo aspnet:stylesheet style
Produces style.css
Creates a new Less class file
Example:
`
yo aspnet:stylesheetless filename
Produces filename.less
Creates a new Sass SCSS class file
Example:
`
yo aspnet:stylesheetscss filename
Produces filename.scss
Creates a new TagHelper class file
Example:
`
yo aspnet:taghelper filename
Produces filename.cs
Creates a new Text file
Example:
`
yo aspnet:textfile filename
Produces filename.txt
Creates a new .tfignore file
Example:
`
yo aspnet:tfignore
Produces .tfignore
Creates a new TypeScript file
Example:
`
yo aspnet:typescript filename
Produces filename.ts
Creates a new TypeScript configuration file
Example:
`
yo aspnet:typescriptconfig
Produces tsconfig.json
Creates a new JSX-enabled TypeScript file
Example:
`
yo aspnet:typescriptjsx filename
Produces filename.tsx
Adds UserSecrets information to ASP.NET Core project.json file.project.json
The generator do not update existing keys if found and does
not create new file.
Example:
`
yo aspnet:usersecrets
This will add following keys to project.json:
- "userSecretsId" key
- "Microsoft.Extensions.Configuration.UserSecrets" key under "dependencies"
Creates a new ASP.NET Core WebApiController class
Example:
`
yo aspnet:webapicontroller ValuesController
Produces /ValuesController.cs`
Read more about Web API MVC concepts on docs.asp.net
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.