1.0.1 • Published 8 years ago

ratel v1.0.1

Weekly downloads
1
License
MIT
Repository
-
Last release
8 years ago

honey-badger-cli

A command-line interface for HoneyBadger, a WIP ES2015+ to ES5 transpiler + bundler + minifier in Rust.

Usage

honey-badger-cli [options]
honey-badger-cli --version

Options:
  -h --help                       Show this screen.
  --version                       Show version.
  -e STRING, --string=STRING      Specifies an input string.
  -f FILE, --file=FILE            Specifies the input file.
  -o FILE, --output=FILE          Specifies the output file.
  --pretty                        Don't minify the output.
  --ast                           Print out the Abstract Syntax Tree of the input.

Installing as cli executable

You can install the executable globally from NPM using npm install -g honey-badger-cli or by executing npm link in the project directory.

Running the tests

Recompiles HoneyBadger and runs all tests using Mocha.

The test suite is using node.green's compat-table which features ES2015, ES2016 and ES2017 examples.

$ npm test

Development

Execute make in the project directory. Please also refer to the scripts section of package.json.

In case you want to work on a local copy of HoneyBadger, add the following lines to native/Cargo.toml:

[dependencies.badger]
path = "../../HoneyBadger"

Programmatic usage

import Badger from 'honey-badger-cli';
const instance = new Badger();

instance.getVersion()

Returns a string containing the application's version.

instance.getUsage()

Returns a string containing usage information.

instance.process(Object options)

Transpiles the given input, returns optionally a string.

options is an object which can take the following values:

keytypepurpose
fileStringInput path.
astBooleanWhether to return the AST.
outputStringOutput path.
stringStringInput string.

instance.badger

Allows access to the rust module implementing the following methods:

instance.badger.transform(String string, Boolean minify)

Returns a string.

Transforms the given input string into ES5 code. When minify is set to true, the output string will be minified.

instance.badger.parse(String string)

Returns a String with the AST of the given input string.

Changelog

0.0.3

  • Updating to HoneyBadger 0.2.1
  • Updating documentation
  • Ensuring a trailing newline using -e/--string

0.0.2

  • Updating to HoneyBadger 0.2.0
  • Updating documentation
  • Adding -e/--string to provide a string
  • Adding stand-alone executable
  • Adding unit tests
  • Adding tests from node.green's compat-table
  • improved API

Licenses

  • MIT
  • Apache License Version 2.0
1.0.1

8 years ago

1.0.0

9 years ago