benchmarked

benchmarked

Easily generate benchmarks from a glob of files.

Install

Install with npm:

$ npm install --save benchmarked

Install with yarn:

$ yarn add benchmarked

This is an opinionated wrapper for benchmarked.js to make it easier to do benchmarks. Concept is from remarkable

Usage

var suite = require('benchmarked')({
  cwd: 'benchmark',              // optionally define a base directory for code and fixtures
  fixtures: 'my-fixtures/*.txt', // path or glob pattern to fixtures
  code: 'my-functions/*.js',     // path or glob pattern to code files
  format: function(benchmark) {
    // optionally override default formatting.
    // return a string.
    // see examples/basic.js for a real example.
  }
});

// run the benchmarks
suite.run();

See the examples to get a better understanding of how this works.

API

Benchmarked

Create an instance of Benchmarked with the given options.

Params

• options {Object}

Example

var benchmarks = new Benchmarked();

.addFixtures

Add fixtures to run benchmarks against.

Params

• patterns {String|Array}: Filepaths or glob patterns.
• options {Options}

Example

benchmarks.addFixtures('fixtures/*.txt');

.addCode

Specify the functions to be benchmarked.

Params

• patterns {String|Array}: Filepath(s) or glob patterns.
• options {Options}

Example

benchmarks.addCode('fixtures/*.txt');

.addSuite

Add benchmark suite to the given fixture file.

Params

• fixture {Object}: vinyl file object

.run

Run the benchmarks.

Params

• options {Object}
• cb {Function}
• thisArg {Object}

Example

benchmarks.run();

About

Related projects

• base-cli: Plugin for base-methods that maps built-in methods to CLI args (also supports methods from a… more | homepage
• base-option: Adds a few options methods to base, like option, enable and disable. See the readme… more | homepage
• base-pkg: Plugin for adding a pkg method that exposes pkg-store to your base application. | homepage
• base: Framework for rapidly creating high quality node.js applications, using plugins like building blocks | homepage

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Contributors

Commits	Contributor
36	jonschlinkert
2	elidoran
2	jamescostian
1	leesei

Building docs

(This project's readme.md is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)

To generate the readme, run the following command:

$ npm install -g verbose/verb#dev verb-generate-readme && verb

Running tests

Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:

$ npm install && npm test

Author

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright © 2017, Jon Schlinkert. Released under the MIT License.

---

This file was generated by verb-generate-readme, v0.5.0, on April 26, 2017.