generator-gulp-angular-subtask

A helper generator for gulp-angular generator

*IMPORTANT NOTE: This subtask generator version was updated to fit generator-gulp-angular >= V0.11. **

If you are using previous versions please check at previous releases

Getting Started

Installation

Create a project using generator-gulp-angular
After you have a working project, install the generator-gulp-angular-subtask
```
npm install -g generator-gulp-angular-subtask
```
Run yo gulp-angular-subtask and set your defaults
Create subtasks following the examples below

Why should i use it?

For the time been, the great gulp-angular generator does not support sub tasks like controllers and directives.
So i decided to build a helper generator that creates those tasks for me and thought about sharing it.

This project will be deprecated when the team decide to support this issue.

Usage:

I currently support these sub tasks:

controller
directive
provider
factory
service
value
constant
filter
style (supports css, less, scss, sass, stylus. Only create the files, NOT implementing compass. see installation section)
partial

Options

To see the options available you can always use the help option on a task

yo gulp-angular-subtask:[SUBTASK] --help

Note that script-type, style-type and html-type will override your default option for the current command, meaning it is not permanently.

These are the options available

--dest : Set a destination where to save the file
--component : Set the destination to be under the component library
--bundle : Create the task's file under a specific bundle instead of the file name
--script-type : Generate Coffee or JavaScript template file
--service-value: Set value for the value / constant service [value, constant]
--style-type : Generate a style file based on a type {scss, sass, less, styl} [style]
--html-type : Generate html or jade partial [partial]
--skip-test : Generate a task without it spec file

Please note that for the time been, gulp-angular does not support coffescript. I'm using my IDEA's file watcher to generate a corresponding js file.
Also note that you can combine multiple options together.

Examples

Default: { language: 'js', style: 'css', html: 'html' }

Controllers

To Create a controller
```
yo gulp-angular-subtask:controller user
```
Produces

src/app/user/controllers/user-controller.js
Creating a controller under the components library
```
yo gulp-angular-subtask:controller navbar --component
```
Produces

src/app/components/navbar/controllers/navbar-controller.js
Creating a coffee script controller
```
yo gulp-angular-subtask:controller user --script-type=coffee
```
Produces

src/app/user/controllers/user-controller.coffee
Creating a controller under user specific library
```
yo gulp-angular-subtask:controller user --dest=specific/location
```
Produces

src/specific/location/user-controller.js
Creating a user details controller under the user bundle
```
yo gulp-angular-subtask:controller user-details --bundle=user
```
Produces

src/app/user/controllers/user-details-controller.js

Combining options

yo gulp-angular-subtask:controller user-details --component --bundle=user --script-type=coffee

Produces

src/app/component/user/controllers/user-details-controller.coffee

Directives

To Create a Directive
```
yo gulp-angular-subtask:directive user
```
Produces

src/app/user/directives/user-directive.js
Creating a directive under the components library
```
yo gulp-angular-subtask:directive navbar --component
```
Produces

src/app/components/navbar/directives/navbar-directive.js
Creating a coffee script directive
```
yo gulp-angular-subtask:directive user --script-type=coffee
```
Produces

src/app/user/directives/user-directive.coffee
Creating a directive under user specific library
```
yo gulp-angular-subtask:directive user --dest="specific/location"
```
Produces

src/specific/location/user-directive.js
Creating a user-details directive under the user bundle
```
yo gulp-angular-subtask:directive user-details --bundle=user
```
Produces

src/app/user/directives/user-details-directive.js

Combining options

yo gulp-angular-subtask:directive user-details --component --bundle=user --script-type=coffee

Produces

src/app/component/user/controllers/user-details-controller.coffee

Factories, Services and Provides

These sub tasks works exactly like the controllers and directives sub tasks. Please take a look at their examples to understand how to use their options.

Creating a Factory
```
yo gulp-angular-subtask:factory user-details
```
Produces

src/app/user-details/factories/user-details-factory.js
Creating a Service
```
yo gulp-angular-subtask:service user-details
```
Produces

src/app/user-details/services/user-details-service.js
Creating a Provider
```
yo gulp-angular-subtask:provider user-details
```
Produces

src/app/user-details/providers/user-details-provider.js

Values, Constants

Creating a Value
```
yo gulp-angular-subtask:value user-id --bundle=user
```
Produces

src/app/user/values/user-id-value.js
Creating a Constant with value from the cmd
```
yo gulp-angular-subtask:constant user-id --bundle=user --service-value=4343434
```
Produces

src/app/user/constants/user-id-constant.js with value of 4343434

Filters

These sub task works exactly like the controllers and directives sub tasks. Please take a look at their examples to understand how to use their options.

Creating a filter
```
yo gulp-angular-subtask:filter myFilter
```
Produces

src/app/user/filters/myFilter-filter.js

Styles

Creating a css file
```
yo gulp-angular-subtask:style user
```
Produces

src/app/user/styles/user.css
Creating a scss style
```
yo gulp-angular-subtask:style user --style-type="scss"
```
Produces

src/app/user/styles/user.scss

Partials

Creating a partial
```
yo gulp-angular-subtask:partial user
```
Produces

src/app/user/partials/user.html
Creating a jade partial
```
yo gulp-angular-subtask:partial user --html-type=jade
```
Produces

src/app/user/partials/user.jade

License

MIT

doronsever / generator-gulp-angular-subtask

readme