\n\n## What's that\n\naster is reactive builder specialized for code processing and transformations. It's built with debugging in mind and makes building JavaScript code more reliable and faster.\n\n## Why one more\n\nSource maps are a great invention that is meant to simplify life by allowing developers to debug the original code (the one that they actually write, whatever language it is) on production.\n\nHowever, using them is pretty hard in any of existing build systems whenever you have at least one plugin in your build pipeline - and you most likely do - that doesn't support emitting them or even consuming from previous step; some plugins even treat code as simple strings discarding all it's inner logic and structure.\n\nYour code isn't just a string. It has a soul and rich inner world and aster is built to treat it like that. As result, it provides complex yet easy and fast transformations that are transparent for browser debugger out of the box.\n\nYou can think of aster for JS as of [rework](https://github.com/reworkcss/rework) for CSS.\n\n## But I like X builder! Should I throw it out?\n\nDefinitely no! aster doesn't try to fight your favorite build system. It has only one specific area that it's exceptionally good at - code processing. Everything else (CSS, images, publishing to CDN, etc.) is left for generic builders, and you can use them together.\n\nCurrently there are following bindings:\n\n * [grunt-aster](https://github.com/asterjs/grunt-aster) - binding for [Grunt](http://gruntjs.com/) JavaScript Task Runner.\n * [gulp-aster](https://github.com/asterjs/gulp-aster) - binding for [Gulp](http://gulpjs.com/) streaming build system.\n * ...more to come!\n\nIf you wish, you can define aster pipeline as custom task in any existing build system on your own since aster uses [RxJS](http://reactive-extensions.github.io/RxJS/) under the hood, which is interoperable with events, streams, promises, callbacks and any other asynchronous primitives and patterns out of the box.\n\n## API\n\naster is completely modular and main package is just a centralized API wrapper for core parts published as separate modules (check out their documentations for details):\n\n* [aster.src](https://github.com/asterjs/aster-src) - Single-pass source files reader.\n* [aster.watch](https://github.com/asterjs/aster-watch) - Continuous source files reader.\n* [aster.dest](https://github.com/asterjs/aster-dest) - File writer.\n* [aster.runner](https://github.com/asterjs/aster-runner) - Build pipeline runner with built-in logger.\n\n## Usage\n\nFirst, install `aster` as a development dependency:\n\n```shell\nnpm install --save-dev aster\n```\n\nThen, create build script and use it. Example (`require`s omitted):\n\n```javascript\naster.watch(['src/**/*.js', 'src/**/*.coffee', 'src/**/*.jsx'])\n.throttle(500)\n.map(changed(function (src) {\n return src.map(equery({\n 'if ($cond) return $expr1; else return $expr2;':\n 'return <%= cond %> ? <%= expr1 %> : <%= expr2 %>'\n }));\n}))\n.map(concat('built.js'))\n.map(umd({exports: 'superLib'}))\n.map(aster.dest('dist', {sourceMap: true}))\n.subscribe(aster.runner);\n```\n\naster doesn't provide task runner - npm is already good one, and we don't want to create one more bicycle. You can simply define every needed task as separate script, or use aster as part of existing builder as mentioned before.\n\n## Creating plugins\n\nCheck out aster's [Yeoman generator](https://github.com/asterjs/generator-aster).\n\nIt automizes the process of creating basic skeleton and Github repo for your plugin in few easy steps. When created, you just need to modify [`index.js`](https://github.com/asterjs/generator-aster/blob/master/app/templates/index.js) and [`test.js`](https://github.com/asterjs/generator-aster/blob/master/app/templates/test/test.js) files to reflect your intended plugin's functionality (detailed hints included right in code).\n\n## License\n\n[MIT License](http://en.wikipedia.org/wiki/MIT_License)\n\n[npm-url]: https://npmjs.org/package/aster\n[npm-image]: https://badge.fury.io/js/aster.png\n\n[travis-url]: http://travis-ci.org/asterjs/aster\n[travis-image]: https://secure.travis-ci.org/asterjs/aster.png?branch=master\n","maintainers":[{"name":"rreverser","email":"me@rreverser.com"}],"time":{"modified":"2022-06-13T03:35:17.405Z","created":"2014-02-03T23:32:43.065Z","0.0.0":"2014-02-03T23:33:54.102Z","0.0.1":"2014-04-29T17:23:52.285Z","0.0.2":"2014-05-10T21:41:01.337Z","0.0.4":"2014-05-11T23:18:40.574Z","0.0.6":"2014-05-16T11:33:32.558Z","0.0.7":"2014-05-16T12:16:01.892Z","0.0.8":"2014-05-16T15:35:15.038Z","0.0.9":"2014-05-16T16:35:30.600Z","0.1.0":"2014-07-03T20:39:23.305Z","0.1.1":"2014-09-27T09:07:13.146Z","0.1.2":"2014-09-27T09:30:38.315Z"},"readmeFilename":"README.md","author":{"name":"Ingvar Stepanyan","email":"me@rreverser.com","url":"https://github.com/RReverser"},"repository":{"type":"git","url":"https://github.com/asterjs/aster"},"homepage":"https://github.com/asterjs/aster","keywords":["ast","javascript","transform","modify"],"bugs":{"url":"https://github.com/asterjs/aster/issues"},"license":"MIT","users":{"andreaspizsa":true}}
![](\"https://avatars2.githubusercontent.com/u/6579498?s=300\")
\n