ubs

library0.7.1jsnpmunverified

Unified Build System (UBS) is a JavaScript build tool that uses YAML configuration files (build.yml) to define tasks, similar to Makefile but with a Travis CI-like syntax. Current version 0.7.1 (last release on npm, low activity). It allows executing tasks sequentially with dependency resolution, supports plugins (e.g., mocha, clean, packagejson, grab), and enables overriding settings via command-line or environment variables. Different from Grunt/Gulp/Cake by emphasizing minimal code and YAML-based definitions. Requires Node >=0.10.1.

devops

npm install ubs

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · UBS

ubs

devopsjavascriptv0.7.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ubs

✓ // Global command-line tool - no import needed

✗ const ubs = require('ubs')

UBS is used as a CLI tool, not as a library import. Running `ubs <target>` executes tasks based on build.yml.

CLI usage

✓ $ ubs clean test

✗ $ ubs init

Default target is 'install' if none specified.

build.yml

✓ // Configuration file in YAML format

Must be present in the current working directory.

Shows a minimal build.yml with mocha and clean plugins, and running the test task.

// Create build.yml // build.yml init: plugins: - mocha - clean settings: clean: path: ['lib/*.js'] mocha: useCoffee: true tasks: test: - clean - mocha // Run $ ubs test

Debug

Known issues

gotchaWatch mode is not implemented (see TODO). Continual rebuilds not supported.

fix

Use alternative tools like `chokidar-cli` or `nodemon` for file watching.

affects: >=0.0.0

gotchaOrder of tasks: dependencies are automatically added but may appear multiple times if not careful.

fix

Ensure task dependencies are acyclic; use `--help` to view execution order.

affects: >=0.0.0

gotchaEnvironment variable UBS_OPTS may conflict with command-line args; precedence described in docs but can confuse.

fix

Avoid using UBS_OPTS and CLI args for same setting; prefer CLI for explicit control.

affects: >=0.0.0

deprecatedCoffeeScript plugin support may be deprecated; not updated for modern CoffeeScript versions.

fix

Use JavaScript-based plugins instead.

affects: >=0.7.0

deprecatedPackage is no longer actively maintained; last release 0.7.1, no updates since 2016.

fix

Consider migrating to Gulp, Grunt, or npm scripts.

affects: >=0.7.1

Errors

Common errors & fixes

Error: Cannot find module 'yamljs'

Missing yamljs dependency

fix

Run `npm install yamljs` or install ubs with `--save`.

Error: ENOENT: no such file or directory, open 'build.yml'

Missing build.yml file in current directory

fix

Create a build.yml file in the project root.

Error: Plugin 'mocha' not found

Mocha plugin not available or not installed

fix

Ensure mocha plugin is listed in init.plugins and installed as npm module if required.

Upgrade

Version history

0.7.1latest on npm

Audit

Dependencies

yamljsrequiredParsing YAML build files

commanderrequiredCommand-line argument parsing

coffee-scriptoptionalOptional CoffeeScript support for plugins

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/oorabona/ubs ↗

packageubs ↗

homepagehttps://github.com/oorabona/ubs ↗