Skip to content
forked from yuhsak/nqdm

Simple progress indicator. Python's tqdm ripoff for Node.js.

License

MIT, MIT licenses found

Licenses found

MIT
LICENSE
MIT
LICENSE-nqdm.md
Notifications You must be signed in to change notification settings

bring-shrubbery/aqdm

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

aqdm

Simple terminal progress indicator that works

  • ✅ Simple API to show progress of a loop
  • 🫡 Both CommonJS and ESM imports are supported
  • 🔥 Examples of usage provided below
  • 🥳 Written in TypeScript

Installation

npm install aqdm

Usage

With iterable objects

import aqdm from 'aqdm'

// Array, Generator, etc..
const arr = [...Array(1000)]

for(const v of aqdm(arr)) {
	// do something
}

Results:

  4.70% [=====>                                                            ] 00:00:04 00:01:37 [1923.72 iter/sec]

Specify times of iteration instead of iterables

for(const i of aqdm(300)) {
	// do something
}

Results:

  4.70% [=====>                                                            ] 00:00:04 00:01:37 [1923.72 iter/sec]

Manualy process

const prgrs = aqdm()
while(true) {
	prgrs.process()
}

Results:

  327 [=============================================================================] 00:00:04 [2089.72 iter/sec]

Options

length

You can manually specify total length of items when you works with iterable objects without length property. (Typically for generators.)

function* gen(num) {
	for (let i = 0; i < num; i++) {
		yield i
	}
}

const g = gen(100)

for(const v of aqdm(g, {length: 100})){
	// do something
}

dest

Choose where to write progress indicator ('stdout' or 'stderr'), another value will be ignored.
Defaults to be 'stdout'.

for(const v of aqdm(arr, {dest: 'stderr'})) {
	// now aqdm will write the progress into process.stderr
}

callback

You can define your own callback function being called per iteration.

const cb = ({current, total, ratio, elapsed, remain, perSec}) => {
	console.log({current, total, ratio, elapsed, remain, perSec})
}

for(const v of aqdm(arr, {callback: cb})) {
	// do something
}

silent

aqdm will display nothing when set this option to true. (designed to use with callback function.)

for(const v of aqdm(arr, {silent: true})) {
	// now aqdm displays nothing.
}

About

Simple progress indicator. Python's tqdm ripoff for Node.js.

Topics

Resources

License

MIT, MIT licenses found

Licenses found

MIT
LICENSE
MIT
LICENSE-nqdm.md

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published

Languages

  • TypeScript 100.0%