deno progress

Usage

First we create a Progressbar, giving it a fmt string and options || total,
telling it when it will be considered complete. then we will do tick()

import { Progressbar } from "https://deno.land/x/deno_progress@<version>/mod.ts";

const bar = new Progressbar("|:bar|", { total: 100, width: 50 });
const id = setInterval(() => {
  bar.tick(2);
  if (bar.complete === true) {
    clearInterval(id);
  }
}, 100);

Options

Tokens:

Methods

tick(length, tokens)

tick the progress bar with the given length and optional tokens

render(force, tokens)

render the progress bar with optional tokens and optional force

interrupt(msg)

interrupt the progress bar and write a message above it.

terminate()

terminate the progress bar

Custom Tokens

You can define custom tokens by adding

{ name: "value" };

object parameter to tick() method

import { Progressbar } from "https://deno.land/x/deno_progress@<version>/mod.ts";
const bar = new Progressbar(":current: :token1 :token2", { total: 3 });
bar.tick({
  token1: "Hello",
  token2: "World!\n",
});

The above example would result in the result output below:

1: Hello World!

Examples

a simple example

import { Progressbar } from "https://deno.land/x/deno_progress@<version>/mod.ts";

const bar = new Progressbar("  :title |:bar| eta: :eta :percent", {
  total: 100,
});

const id = setInterval(() => {
  bar.tick(1, { title: "progress " });
  if (bar.complete === true) {
    clearInterval(id);
  }
}, 50);

More examples can be found on the example folder

Contributing

Give your pr a descriptive title

examples:

• feat: add a new feature
• fix(render): fix render method

For further information you can read the Contribiting guidelines

Credits

Ported from node-progress. Thanks for the work and inspiration!

License

MIT.