README

exprs

The command-line interface for exprs.sh.

exprs is a micromodule hosting and registry service for JavaScript. No worry about setting lint, formatting, transpilations or test runners. Just write and share your code.

Features

Just expression. A micromodule is a single expression of JavaScript, which will do one thing well.
Immutable. All micromodules are immutable and would never dissapear.
Deterministic. With aliasing, your dependencies are not unintentionally upgraded and are always the exact same.
Transpile on install. The transpilation runs on the installtion phase, so module users can select supporting environments instead of authors.
No task setup. Common tasks like linting and formatting are integrated into the platform.
No name collision. All micromodules have an unique name and can have alias names under your namespace.

Get started

Install the package from npm:

npm install --global exprs

# or with `yarn`
yarn global add exprs

Install a micromodule:

exprs add @nkzawa/leftPad

Use it on your applications as always you do with node modules:

const leftPage = require("@nkzawa/leftPad");

Commands

exprs install

Install micromodules defined in package.json. This command is the default so you can execute it as just exprs.

exprs install

# or just
exprs

dependencies and devDependencies are defined on the exprs field:

{
  "exprs": {
    "dependencies": {
      "@nkzawa/leftPad": "leftPad_a01",
      "@username/aliasName": "moduleName_b12",
      "someModule_c23": "someModule_c23"
    }
  }
}

To not install devDependencies, use the --production option:

exprs --production

exprs add <module|alias...>

Install a micromodule from the registry and add it to package.json.

exprs add @nkzawa/leftPad

To install as devDependencies, run with the --dev (or -d) option:

exprs add --dev @nkzawa/leftPad

exprs upgrade [alias...]

Upgrade aliases to the latest version of micromodules.

exprs upgrade

exprs remove <module|alias...>

Uninstall a micromodule and remove it from package.json.

exprs remove @nkzawa/leftPad

exprs help

Display the help message.

exprs help

Integration with npm

When your npm package has dependencies on exprs micromodules, you want to setup a npm hook script to install micromodules along with npm install:

{
  "scripts": {
    "install": "exprs"
  },
  "dependencies": {
    "exprs": "*"
  }
}

License

MIT

Usage no npm install needed!