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

@under_koen/bsm

v1.5.0

Published

BSM (Basic Script Manager) is a useful tool that enables you to create clear and concise scripts without cluttering your `package.json` file.

Downloads

395

Readme

BSM (Basic Script Manager)

npm package Build Status Issues Semantic Release

BSM is a tool that enhances the functionality of NPM by allowing users to define their scripts in a separate files. This makes it easier to create and manage complex scripts using JavaScript, without cluttering your package.json file.

Getting started

Installation

Install BSM as a dev dependency or globally.

npm install --save-dev @under_koen/bsm
npm install -g @under_koen/bsm

Usage

Create a package.scripts.js or package.scripts.json file in the root of your project. This file will contain all of your scripts.

When using package.scripts.js, you can use the following syntax:

module.exports = {
  scripts: {
    build: {
      _default: "bsm clean ~.* --",
      esbuild: "esbuild ...",
    },
    clean: "rimraf dist/",
    lint: {
      _default: "bsm ~.* --",
      eslint: "eslint --ext .ts,.js .",
      prettier: "prettier --check .",
    },
  },
};

When using package.scripts.json, you can use the following syntax:

{
  "scripts": {
    "build": {
      "_default": "bsm clean ~.*",
      "esbuild": "esbuild ..."
    },
    "clean": "rimraf dist/",
    "lint": {
      "_default": "bsm ~.*",
      "eslint": "eslint --ext .ts,.js .",
      "prettier": "prettier --check ."
    }
  }
}

You can then run your scripts using the bsm command.

bsm build
bsm lint

You can also run sub-scripts.

bsm lint.eslint

Features

Script groups

You can group scripts by using an object or array.

module.exports = {
  scripts: {
    example: {
      test: "echo test script",
      variant: "echo variant script",
      subgroups: {
        test: "echo test script",
        variant: "echo variant script",
      },
    },
  },
};

In this example the following scripts are available:

  • bsm example.test
  • bsm example.variant
  • bsm example.subgroups.test
  • bsm example.subgroups.variant
module.exports = {
  scripts: {
    example: ["echo test script", "echo variant script"],
  },
};

In this example the following scripts are available:

  • bsm example (will run all scripts in the array)
  • bsm example.0
  • bsm example.1

Default scripts

You can define a default script for a group of scripts by using the _default key.

module.exports = {
  scripts: {
    example: {
      _default: "echo default script",
      variant: "echo variant script",
    },
  },
};

bsm example will execute the default script, while bsm example.variant will execute the variant script.

Specified scripts

Specified scripts replace the default script when an condition is met.

The order of precedence is as follows:

  • _ci
  • _[os]
  • _default

CI Specified scripts

You can specify CI specific scripts with _ci key.

module.exports = {
  scripts: {
    example: {
      _default: "echo default script",
      _ci: "echo ci script",
    },
  },
};

bsm example will execute the example._ci when running on a CI environment. When no CI specific script is found, the default script will be executed.

OS Specified scripts

You can specify OS specific scripts with _win32, _darwin, and _linux keys. All platforms can be seen here.

module.exports = {
  scripts: {
    example: {
      _default: "echo default script",
      _win32: "echo windows script",
      _darwin: "echo macos script",
      _linux: "echo linux script",
    },
  },
};

bsm example will execute the example._win32 on Windows, example._darwin on MacOS, and example._linux on Linux. When no OS specific script is found, the default script will be executed.

Chipset Specified scripts

You can specify OS specific scripts with _x64, _x32, and _arm64 keys. All Chipsets can be seen here.

module.exports = {
  scripts: {
    example: {
      _x64: "echo 64-bit",
      _x32: "echo 32-bit",
      _arm: "echo ARM",
      _arm64: "echo ARM64",
      _default: "echo Unknown",
    },
  },
};

bsm example will execute the example._win32 on Windows, example._darwin on MacOS, and example._linux on Linux. When no OS specific script is found, the default script will be executed.

Script arguments

All arguments passed to the bsm command after -- will be passed to all specified scripts.

module.exports = {
  scripts: {
    example: "echo",
  },
};
bsm example -- Hello World!

The above command will execute echo Hello World!.

Relative scripts

You can run scripts relative to the current script by using the ~ prefix.

module.exports = {
  scripts: {
    example: {
      _default: "bsm ~.variant",
      variant: "echo variant script",
    },
  },
};
bsm example

The above command will execute example.variant.

All scripts

You can run all scripts in a group by using a *. Ignores scripts that start with _.

module.exports = {
  scripts: {
    example: {
      test: "echo test script",
      variant: "echo variant script",
      _ignore: "echo ignore script",
    },
  },
};
bsm example.*

The above command will execute example.test and example.variant.

Hooks

Pre hooks

You can run scripts before a script by using _pre.

module.exports = {
  scripts: {
    example: {
      _pre: "echo pre script",
      _default: "echo default script",
    },
  },
};
bsm example

The above command will execute example._pre and example._default.

Post hooks

You can run scripts after a script by using _post. Does not run when a script fails.

module.exports = {
  scripts: {
    example: {
      _default: "echo default script",
      _post: "echo post script",
    },
  },
};
bsm example

The above command will execute example._default and example._post.

On error hooks

You can run scripts when a script fails by using _onError.

module.exports = {
  scripts: {
    example: {
      _default: "exit 1",
      _onError: "echo error script",
    },
  },
};
bsm example

The above command will execute example._default and example._onError. This will also exit with code 1.

Catch hooks

You can run scripts when a script fails by using _catch.

module.exports = {
  scripts: {
    example: {
      _default: "exit 1",
      _catch: "echo catch script",
    },
  },
};
bsm example

The above command will execute example._default and example._catch.

Finally hooks

You can run scripts when a script fails by using _finally.

module.exports = {
  scripts: {
    example: {
      _default: "echo default script",
      error: "exit 1",
      _finally: "echo finally script",
    },
  },
};
bsm example

The above command will execute example._default and example._finally.

bsm example.error

The above command will execute example.error and example._finally. And exit with code 1.

Functions

You can use functions in your scripts. This only work in javascript files.

module.exports = {
  scripts: {
    example: () => {
      console.log("Hello World!");
    },
  },
};
bsm example

The above command will execute the function and log Hello World!.

Async functions

You can use async functions in your scripts. This only work in javascript files.

import { setTimeout } from "timers/promises";

module.exports = {
  scripts: {
    example: async () => {
      await setTimeout(5000);
      console.log("Hello World!");
    },
  },
};
bsm example

The above command will execute the function and log Hello World! after 5 seconds.

Arguments

The function is passed an array of all arguments passed to the script after --.

module.exports = {
  scripts: {
    example: (args) => {
      console.log(args);
    },
  },
};
bsm example -- Hello World!

The above command will execute the function and log ["Hello", "World!"].

Return value

The function can return scripts, these will handled as if function was not used. Return value can be a string, an array, an object or another function.

module.exports = {
  scripts: {
    example: () => {
      return "echo Hello World!";
    },
  },
};
bsm example

The above command will execute echo Hello World!.

Extending

You can extend scripts by using the extends key. You can import scripts from other files or packages.

module.exports = {
  extends: ["@under_koen/bsm/package.scripts.js"],
  scripts: {},
};
bsm lint

The above command will execute lint coming from the package.scripts.js of @under_koen/bsm.

Extending with options (experimental)

You can extend scripts with options by using the extends key. You can import scripts from other files or packages.

// package.scripts.js
module.exports = {
  extends: [["./test", "World"]],
  scripts: {},
};
// test.js

module.exports = (name) => ({
  scripts: {
    test: `echo Hello ${name}!`,
  },
});
bsm test

The above command will execute echo Hello World!.

Trouble shooting

Script '/home/runner' not found

When using a unix based OS, you might get the following error:

Script '{home}' not found

This is caused by the ~ prefix being expanded by the shell. You can fix this by using bsm \~ instead of bsm ~. In version 1.0.1 and above we try to detect this and fix it automatically.

Future plans

  • [ ] Have support for workspaces / lerna
  • [ ] Have support for running scripts in parallel
  • [ ] Have support for specifying environment variables
  • [ ] Have support for an interactive mode
  • [ ] Jetbrains and VSCode integration

License

BSM is released under the MIT License.