pretty-fast

    0.2.7 • Public • Published

    Pretty Fast

    Pretty Fast is a source-map-generating JavaScript pretty printer, that is pretty fast.

    Build Status

    Install

    npm install pretty-fast
    

    Usage

    var prettyFast = require("pretty-fast");
    
    var uglyJS = "function ugly(){code()}";
    
    var pretty = prettyFast(uglyJS, {
      url: "test.js",
      indent: "  "
    });
    
    console.log(pretty.code);
    // function ugly() {
    //   code()
    // }
    
    console.log(pretty.map);
    // [object SourceMapGenerator]
    

    (See the mozilla/source-map library for information on SourceMapGenerator instances, and source maps in general.)

    Options

    • url - The URL of the JavaScript source being prettified. Used in the generated source map. If you are prettifying JS that isn't from a file or doesn't have a URL, you can use a dummy value, such as "(anonymous)".

    • indent - The string that you want your code indented by. Most people want one of " ", " ", or "\t".

    • ecmaVersion - Indicates the ECMAScript version to parse. See acorn.parse documentation for more details. Defaults to "latest".

    Issues

    Please use Bugzilla

    Goals

    • To be pretty fast, while still generating source maps.

    • To avoid fully parsing the source text; we should be able to get away with only a tokenizer and some heuristics.

    • Preserve comments.

    • Pretty Fast should be able to run inside Web Workers.

    Non-goals

    • Extreme configurability of types of indentation, where curly braces go, etc.

    • To be the very fastest pretty printer in the universe. This goal is unattainable given that generating source maps is a requirement. We just need to be Pretty Fast.

    • To perfectly pretty print exactly as you would have written the code. This falls out from both not wanting to support extreme configurability, and avoiding full on parsing. We just aim to pretty print Pretty Well.

    Keywords

    none

    Install

    npm i pretty-fast

    DownloadsWeekly Downloads

    59

    Version

    0.2.7

    License

    BSD

    Unpacked Size

    58.6 kB

    Total Files

    10

    Last publish

    Collaborators

    • moz-glean
    • mozilla-npm
    • rehandalal
    • mythmon
    • andrew-sunada
    • jkratzer
    • factorui.npm
    • project-nimbus-publishing
    • gijs
    • nchevobbe
    • brizental
    • aplacitelli
    • hamiltonulmer
    • mozrhelmer
    • knowtheory
    • mozilla-devtools
    • nickfitzgerald
    • loganfsmyth
    • jasonlaster11
    • tromey