-
Notifications
You must be signed in to change notification settings - Fork 23
an extensible framework for JavaScript syntax tree shaping
License
olov/jsshaper
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
JSShaper is an extensible framework for JavaScript syntax tree shaping, created by Olov Lassus <olov.lassus@gmail.com>. The JSShaper web site is available at <http://jsshaper.org>. There's a google group at <http://groups.google.com/group/jsshaper> Follow me on <http://twitter.com/olov> or visit me at <http://lassus.se>. JSShaper and its plugins are implemented in JavaScript. Syntax tree shaping means performing complex manipulations to a syntax tree representation of your textual source code, and then turning it back into source code again. JSShaper goes very far to keep all your source code formatting, intendation, whitespace and comments. JSShaper comes with a number of plugins, some of which are listed below: annotation-printer: prints /* @annotations */ asserter: provides c-style assertions by shaping assert(f(x) === 3) into assert(f(x) === 3, "f(x) === 3, function myfn, file myfilename.js, line 14") bitwiser: static analysis. requires @bitwise annotation for the bitwise operators | (or), & (and), to detect misspelling of the logical operators ||, &&. stringconverter: detects the ""+expr pattern and turns it into String(expr) restricter: adds run-time checking for restrict mode programs by converting operators into function calls in a compatible way. it comes with a small run-time library. <http://restrictmode.org> logger: formatted logging with great detail (file, function, line) watcher: trap (watch) object modifications for debugging purposes It also comes with a few small and simple examples (src/examples). Get the source code from <https://github.com/olov/jsshaper>: git clone git://github.com/olov/jsshaper.git cd jsshaper git submodule init git submodule update JSShaper is young, not very documented, and may crash with horrible error messages. Thanks for being an early adopter and reporting bugs or annoyances. Contributors are welcome! JSShaper is designed to run with node.js or in the browser. It uses AMD. Run it like this: node run-shaper.js filename [shape1 .. shapeN] where shape is a plugin (see plugins/) or builtin (--tree or --source) example: node run-shaper.js myfile.js plugins/annotater.js plugins/bitwiser.js --source example: node run-shaper.js myfile.js plugins/annotater.js plugins/restricter.js --source For restricter (the restrict mode checker), you can also run the more convenient run-restricter: example: node run-restricter.js myfile.js JSShaper can also execute on the fly, in your browser. Check out example-restrict-mode-on-the-fly.html for an example of how to use that to get restrict mode checking without a precomplilation step. If you want to restrict mode check your node.js code, plugins/restricter/restrict-mode.js can be loaded with require once and its helper functions (such as __add) will be accessible to all other modules. JSShaper and its plugins are Open Source and licensed under the MIT license, see LICENSE file for terms and conditions. JSShaper uses the parser from the Mozilla Narcissus JavaScript-in-JavaScript interpreter <https://github.com/mozilla/narcissus>, under the terms of the MPL 1.1 license. For full Narcissus licensing information read the src/narcissus/LICENSE file.
About
an extensible framework for JavaScript syntax tree shaping
Resources
License
Stars
Watchers
Forks
Releases
No releases published
Packages 0
No packages published