mirror of
https://github.com/nodejs/node.git
synced 2026-11-09 15:11:11 -05:00
Rich Trott
d7aa8fa088
Update ESLint to 2.1.0. ESLint has a number of potentially-useful new features but this change attempts to be minimal in its changes. However, some things could not be avoided reasonably. ESLint 2.1.0 found a few lint issues that ESLing 1.x missed with template strings that did not take advantage of any features of template strings, and `let` declarations where `const` sufficed. Additionally, ESLint 2.1.0 removes some granularity around enabling ES6 features. Some features (e.g., spread operator) that had been turned off in our configuration for ESLint 1.x are now permitted. PR-URL: https://github.com/nodejs/node/pull/5214 Reviewed-By: Michaël Zasso <mic.besace@gmail.com> Reviewed-By: jbergstroem - Johan Bergström <bugs@bergstroem.nu> Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Roman Reiss <me@silverwind.io> Reviewed-By: Myles Borins <myles.borins@gmail.com>
104 lines
2.3 KiB
Markdown
104 lines
2.3 KiB
Markdown
Flexible ascii progress bar.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
$ npm install progress
|
|
```
|
|
|
|
## Usage
|
|
|
|
First we create a `ProgressBar`, giving it a format string
|
|
as well as the `total`, telling the progress bar when it will
|
|
be considered complete. After that all we need to do is `tick()` appropriately.
|
|
|
|
```javascript
|
|
var ProgressBar = require('progress');
|
|
|
|
var bar = new ProgressBar(':bar', { total: 10 });
|
|
var timer = setInterval(function () {
|
|
bar.tick();
|
|
if (bar.complete) {
|
|
console.log('\ncomplete\n');
|
|
clearInterval(timer);
|
|
}
|
|
}, 100);
|
|
```
|
|
|
|
### Options
|
|
|
|
These are keys in the options object you can pass to the progress bar along with
|
|
`total` as seen in the example above.
|
|
|
|
- `total` total number of ticks to complete
|
|
- `width` the displayed width of the progress bar defaulting to total
|
|
- `stream` the output stream defaulting to stderr
|
|
- `complete` completion character defaulting to "="
|
|
- `incomplete` incomplete character defaulting to "-"
|
|
- `clear` option to clear the bar on completion defaulting to false
|
|
- `callback` optional function to call when the progress bar completes
|
|
|
|
### Tokens
|
|
|
|
These are tokens you can use in the format of your progress bar.
|
|
|
|
- `:bar` the progress bar itself
|
|
- `:current` current tick number
|
|
- `:total` total ticks
|
|
- `:elapsed` time elapsed in seconds
|
|
- `:percent` completion percentage
|
|
- `:eta` estimated completion time in seconds
|
|
|
|
## Examples
|
|
|
|
### Download
|
|
|
|
In our download example each tick has a variable influence, so we pass the chunk
|
|
length which adjusts the progress bar appropriately relative to the total
|
|
length.
|
|
|
|
```javascript
|
|
var ProgressBar = require('../');
|
|
var https = require('https');
|
|
|
|
var req = https.request({
|
|
host: 'download.github.com',
|
|
port: 443,
|
|
path: '/visionmedia-node-jscoverage-0d4608a.zip'
|
|
});
|
|
|
|
req.on('response', function(res){
|
|
var len = parseInt(res.headers['content-length'], 10);
|
|
|
|
console.log();
|
|
var bar = new ProgressBar(' downloading [:bar] :percent :etas', {
|
|
complete: '=',
|
|
incomplete: ' ',
|
|
width: 20,
|
|
total: len
|
|
});
|
|
|
|
res.on('data', function (chunk) {
|
|
bar.tick(chunk.length);
|
|
});
|
|
|
|
res.on('end', function () {
|
|
console.log('\n');
|
|
});
|
|
});
|
|
|
|
req.end();
|
|
```
|
|
|
|
The above example result in a progress bar like the one below.
|
|
|
|
```
|
|
downloading [===== ] 29% 3.7s
|
|
```
|
|
|
|
You can see more examples in the `examples` folder.
|
|
|
|
## License
|
|
|
|
MIT
|