generator-powder
Advanced tools
Generator for scaffolding out Powder.js applications
Powder.js is a combination of existing frameworks, tools and libraries that allows fast and simple web app creation.
Server-side of powder.js is powered by Express.js with data and sessions stored in MongoDB accessed using Mongoose.js.
Server-side templating is done via Linkedin version of Dust.js.
If needed, basic local authorisation can be generated using passport.js.
Client-side is built using Angular.js with ngRoute, Twitter Bootstrap and jQuery.
All the client-side app code is managed and compiled by Browserify and minified using Uglify.js (when not in debug mode).
Bower is used for the client-side dependencies which are loaded directly from core template. All dependencies available on CDNs might be replaced to those before deploying.
Gulp.js is used as a build-tool.
In addition to build and testing tasks, gulp as well handles all the things related to encapsulating bower dependencies into project without any additional actions from the developer. It as well created version of layout with libraries located on CDN. If you'd like to include your own libraries, please add CDN locations to gulp/tasks/cdn.js.
Testing is done using jshint for linting and mocha.js with should.js for automated testing.
Default test suite includes two different test files - one for API using simple JSON, and one for browser using zombie.js.
In addition, powder.js utilizes asyncawait and promises (using bluebird) to simplify asynchronous code.
Bunyan is used as a logger. Logs can be found in ./logs/ folder.
$ npm install -g yo generator-powder
$ yo powder
$ yo powder
Creates a new powder.js application.
$ yo powder:controller myName
Generates a new controller named myNameController and it's dependencies and injects it into main app.
$ yo powder:directive myName
Generates a new angular directive named myNameDirective and injects it into main app.
$ yo powder:filter myName
Generates a new angular filter named myNameFilter and injects it into main app.
$ yo powder:service myName
Generates a new angular service named myNameService and injects it into main app.
$ yo powder:model myName
Generates a new mongoose model named myName and injects it into main app.
Once installed, you can create a basic application by following the prompts.
$ yo powder
_-----_
| |
|--(o)--| .--------------------------.
`---------´ | Welcome to Yeoman, |
( _´U`_ ) | ladies and gentlemen! |
/___A___\ '__________________________'
| ~ |
__'.___.'__
´ ` |° ´ Y `
You're using the fantastic Powder generator.
[?] What do you want to call your app?
...
To run your application, just go into the newly created directory and type gulp.
$ cd HelloWorld
$ gulp
...
listening on port 8080
Route logic is moved into the /controllers/ directory and its subdirectories.
For the sake of simplicity /controllers/ directory has two default subdirectories: /controllers/api/ and /controllers/main/.
For example, a route for your home page, would use a /controllers/main/index.js file such as:
// export index
exports.index = {
path: '/',
method: 'get',
returns: function(req, res) {
return res.render('index');
}
};
This file would define the routes and the logic for the home page. The advantage of keeping routes and logic segregated in individual files starts to show as the application grows. If something fails, it's very easy to pinpoint where things went wrong.
When a new controller is created, the generator will also create both client and server-side templates, routes and all needed client javascript files for you.
Data models are separated from the controller logic resulting in cleaner, more organized code. Data models live in the /models/ folder.
Dust JavaScript templates are the default server-side templating language. [Angular templates] are used in client-side.
Server-side templates are loaded from the /views/ directory.
Client-side templates are loaded from the /public/templates/ directory.
Powder.js utilizes Asyncawait and promises (using bluebird) to simplify asynchronous code.
This allows simplifying this code which is considered your typical js callback hell:
function foo(callback) {
firstAsyncCall(function (err, resultA) {
if (err) { callback(err); return; }
secondAsyncCallUsing(resultA, function (err, resultB) {
if (err) { callback(err); return; }
thirdAsyncCallUsing(resultB, function (err, resultC) {
if (err) {
callback(err);
} else {
callback(null, doSomethingWith(resultC));
}
});
});
});
}
To simple and readable code like this:
var foo = async (function() {
var resultA = await (firstAsyncCall());
var resultB = await (secondAsyncCallUsing(resultA));
var resultC = await (thirdAsyncCallUsing(resultB));
return (doSomethingWith(resultC));
});
Note that await function will only work with functions that return promises.
If you are using libraries or third-party functions that do not return promises, you can use bluebirds .promisify() or .promisifyAll() functions to turn them into promises and allow usage with asyncawait.
For more info, please refer to asyncawait and bluebird docs.
Add more docs and subgenerators.
FAQs
Powder.js generator for yeoman
The npm package generator-powder receives a total of 6 weekly downloads. As such, generator-powder popularity was classified as not popular.
We found that generator-powder demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Socket researchers identified a malicious Chrome extension that manipulates Raydium swaps to inject an undisclosed SOL transfer, quietly routing fees to an attacker wallet.
Research
/Security News
Another wave of Shai-Hulud campaign has hit npm with more than 500 packages and 700+ versions affected.
Product
Add real-time Socket webhook events to your workflows to automatically receive software supply chain alert changes in real time.