edcb

edcb is a build tool and task runner for Deno. It has support for formatting, linting, testing, code coverage, bundling, and more, and it can be used via command line or TypeScript import.

Features

• Formatting, linting, and testing of TypeScript code.
• Configurable HTTP server for developing web apps.
• File watcher with automatic reload via WebSockets.
• Dynamic generation of JavaScript bundles from TypeScript modules.
• Optional coverage file generation and upload to codecov.io.
• CLI with rich diagnostic output (sub-processes, call-tree, performance).
• TypeScript API for configuration and version locking.
• Easy CI integration (see ci.yml).

Usage

Install the edcb CLI with Deno:

deno install -f -A --unstable https://deno.land/x/edcb/cli.ts

These are basic commands:

# show help text and options
edcb
edcb check -h
edcb serve -h

# run formatter, linter, tests
edcb check

# start development server
edcb serve

Config

Before it does anything else, edcb will look for the dev.ts module in the working directory and run it if it exists. The edcb CLI then essentially becomes an alias for deno run -A --unstable dev.ts [args]. This allows one to lock a particular edcb version to a project, provide default values for options, and add complex configuration such as the bundles option.

The cli.ts module exports the cli function, which can be used to start the CLI manually using TypeScript. The specified options will serve as defaults. For example, one can specify the ignore option for the check command, which will then be used if the --ignore option was not provided on the command-line. This is an example of a dev.ts file:

// lock edcb to a particular version ('xyz' in this case)
import { cli } from "https://deno.land/x/edcb@xyz/cli.ts";

await cli({
  // default options for check
  check: {
    ignore: "docs",
  },
  // default options for serve
  serve: {
    port: 8080,
    root: ".",
    webRoot: "docs",
    // not available in the CLI
    bundles: [{
      source: "index.ts", // relative to root
      target: "index.js", // relative to webRoot
    }],
  },
});

Use individual commands by importing them from mod.ts:

import { check } from "./mod.ts";

await check({
  ignore: "deps",
});