npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

bake-cli

v0.6.0

Published

Make like Task runner

Downloads

537

Readme

bake Build Status

Make like task runner

npm install bake-cli -g
  • Windows support \o/
  • Borrows heavily from npm in how recipes are executed
  • Recipes are executed with bash -c instead of executing each rule, line by line like Make does.
  • No need to prefix rules with $@ for silent output
  • Slightly easier variables substitution (eg. $VARIABLE instead of $(VARIABLE)
  • Variable declarations
  • No tab requirements
  • Path manipulation to prepend ./node_modules/.bin, like npm does for npm scripts.

What is Bake ?

Bake is a little experiment to implement a simple task runner similar to Make in JavaScript, while bringing in the convenience of npm scripts with $PATH and environment variables.

It takes a similar approach to Make with a very close syntax.

Recipes (or rules, the commands defined for a target / task), are executed with sh -c for unix, cmd.exe /d /s /c for windows platform.

For now, basic variable and target declarations are supported, along with basic prerequisite support (eg. task depending on other tasks).

The parser bake use is small and have its flaws, but for most Makefiles, bake is able to parse them correctly. It makes it possible and really easy to use Make on Windows (tested on Windows 10).

The Gist

Given the following Makefile

foo2:
	echo foo2

foo: prefoo
	echo foo

prefoo:
	echo prefoo

foobar: prefoobar
	echo foobar

prefoobar:
	echo blahblah

all: foo foo2 foobar

Run bake

$ bake
bake info Invoking foo target
bake info Invoking prefoo target
prefoo
foo
bake info Invoking foo2 target
foo2
bake info Invoking foobar target
bake info Invoking prefoobar target
blahblah
foobar
bake info ✔ Build sucess in 41ms

Usage

$ bake <target> [options]

Options:
  -h, --help         Show this help
  -v, --version      Show package version
  -d, --debug        Enable extended output

Targets:
  all                Run target all
  build              Run target build
  foo                Run target foo
  prefoo             Run target prefoo
  foobar             Run target foobar
  prefoobar          Run target prefoobar

$ bake init <template> [options]

  default           Scaffold an ES6 setup     (babel, eslint, ...)
  cli               Scaffold an ES6 CLI setup (minimist, ...)

todo

  • Environment variables bake_* similar to npm_* available in npm scirpts
  • Variable substitution for prerequities and targets (right now, replacement is done only for rules / recipes)
  • Implement pattern rules
  • Implement automatic variables
  • Implement mtime check (a target needs to be rebuilt if it does not exist of if it's older than any of the prerequities)

bake init

Basic scaffolding command

Its purpose is to init a project Makefile with sensible defaults for various development needs.

The default list of templates should be configurable. Adding new ones or overriding existing ones should be a simple process.

Looking in

  • ~/.config/bake/templates
  • ~/.bake/templates

Where the templates directories have the following structure:

templates/
  ├── es6
  │   ├── .babelrc
  │   ├── .eslintrc
  │   ├── Makefile
  │   ├── package.json
  │   └── .travis.yml
  └── frontend
      ├── Makefile
      ├── package.json
      └── webpack.config.js

The subdirectory name is the template name (invoked with bake init ).

If no name is defined, it defaults to "default"

  • Makefile - Is the template Makefile to use
  • package.json - JSON file to merge with project's package.json (usually to include devDependencies)
  • *.json - Every JSON files generated is merged with existing files (.eslintrc and .babelrc are handled as JSON files)
  • Every other top level files is copied to destination, existing files are skipped

The package.json file can have a "bake" field (removed when merged with package.json), with the following properties:

  • "scripts" - Similar to npm scripts, a list of hooks for bake to invoke
  • "scripts.start" - Executed when the generation process starts
  • "scripts.install" - Executed when the template has been generated
  • "description" - Optional description for this template (used on --help)

These hooks can be used to further customize the template generation (like running npm install in "scripts.install")

See the default template package.json file:

"bake": {
  "description": "Scaffold a basic ES6 setup",
  "scripts": {
    "start": "echo Starting generation of default template",
    "prestart": "echo prestart",
    "poststart": "echo poststart",
    "install": "npm install --loglevel http --cache-min Infinity",
    "preinstall": "echo Installing dependencies ...",
    "postinstall": "npm ls --depth 1"
  }
}

Note --cache-min Infinity is used to bypass the HTTP network checks to the registry for already installed packages.

Makefile

Here is a quick description of Makefiles syntax, with bake differences highlighted.

Bash scripting

help:
  echo """
    Some help message here:
    Run with bake help
  """

all: help

This, with Make, would throw an error

$ make help
echo """
/bin/sh: 1: Syntax error: Unterminated quoted string
Makefile:8: recipe for target 'help' failed
make: *** [help] Error 2

While, bake is ok with it

$ bake help
bake info Invoking help target

Some help message here
Run with bake help

bake info ✔ Build sucess in 43ms

Make like variables

somevar = anything after "=" is considered the value till the end of the line
OUT_FLAGS = output.js

build-js:
  cat a.min.js b.min.js > $OUT_FLAGS
  echo JS file built

The syntax and behavior is a bit different. Instead of using $(var) syntax, $var is used instead (that might changed to allow bash variables within recipes, which uses this syntax).

Task dependencies

Use prerequities to specify tasks that depends on other tasks.

Makefile

prebuild:
  echo done

build: prebuild

deploy: build

Output

$ bake deploy
bake info Invoking deploy target
bake info Invoking build target
bake info Invoking prebuild target
done
bake info ✔ Build sucess in 50ms

npm like environment

Recipes run in an environment very similar to the environment npm scripts are run in, namely the PATH environment variable.

path

If you depend on modules that define executable scripts, like test suites, then those executables will be added to the PATH for executing the scripts.

So, if your package.json has this:

{
  "name" : "foo" ,
  "dependencies" : { "bar" : "0.1.x" }
}

then you could run bake to execute a target that uses the bar script, which is exported into the node_modules/.bin directory on npm install.

Tests

npm test

Outputs help.

cli()
  .use('bake -h')
  .expect('bake <target...> [options]')
  .expect('Options:')
  .expect(0)
  .end(done);

bake foo.

cli()
  .use('bake foo')
  .expect('prefoo\nblahblah\nfoo')
  .expect(0)
  .end(done);

bake all.

cli()
  .use('bake')
  .expect('prefoo\nblahblah\nfoo\nfoo2\nblahblah\nfoobar')
  .expect(0)
  .end(done);

bake maoow - Outputs help on UNKNOWN_TARGET.

cli()
  .use('bake maoow')
  .expect('bake <target...> [options]')
  .expect('Options:')
  .expect(0)
  .end(done);

bake init.

cli({ cwd: join(__dirname, 'examples') })
  .use('bake init --skip')
  .expect('Running default template')
  .expect(/Makefile\s+already exists, skipping/)
  .expect(/Build success in \d+ms/)
  .expect(0)
  .end(done);