Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jfelchner/ruby-progressbar
Ruby/ProgressBar is a text progress bar library for Ruby.
https://github.com/jfelchner/ruby-progressbar
cli progress progress-bar progressbar progressbars terminal
Last synced: about 13 hours ago
JSON representation
Ruby/ProgressBar is a text progress bar library for Ruby.
- Host: GitHub
- URL: https://github.com/jfelchner/ruby-progressbar
- Owner: jfelchner
- License: mit
- Created: 2009-02-16T22:06:07.000Z (almost 16 years ago)
- Default Branch: master
- Last Pushed: 2024-06-12T04:34:26.000Z (7 months ago)
- Last Synced: 2024-10-29T15:12:44.091Z (3 months ago)
- Topics: cli, progress, progress-bar, progressbar, progressbars, terminal
- Language: Ruby
- Homepage:
- Size: 991 KB
- Stars: 1,575
- Watchers: 24
- Forks: 132
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/contributing.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
- Code of conduct: CODE-OF-CONDUCT.md
Awesome Lists containing this project
- awesome-ruby-toolbox - ruby-progressbar - Ruby/ProgressBar is an extremely flexible text progress bar library for Ruby. The output can be customized with a flexible formatting system including: percentage, bars of various formats, elapsed time and estimated time remaining. (Developer Tools / CLI Progress Bars)
- awesome-ruby - Ruby/Progressbar - The most flexible text progress bar library for Ruby. (CLI Utilities)
- awesome-loading-indicators - Ruby/ProgressBar - Ruby/ProgressBar is a text progress bar library for Ruby. (Ruby)
README
Ruby/ProgressBar
================================================================================
The **ultimate** text progress bar library for Ruby! It'll **SMASH YOU OVER THE
HEAD** with a **PURE RUSH** of progress bar excitement!
Don't miss out on what all the kids are talking about! If you want everyone to
know that your gem or app can survive _in the cage_ then YOU WANT
**RUBY-PROGRESSBAR**!
It's Better Than The Other 186,312 Progress Bar Libraries Because
--------------------------------------------------------------------------------
* It has [stood the test of time][history] (2008-today)
* Full test suite
* [_**ZERO**_ dependencies][gemspec]
* Used by [tons of other open source projects][dependencies] (which means we
find out about bugs quickly)
* It's pretty [freakin' sweet](https://www.youtube.com/watch?v=On3IoVhf_GM)
* And most importantly... our awesome [contributors][contributors]
Basic Usage
--------------------------------------------------------------------------------
### Creation
It's simple to get started:
```ruby
progressbar = ProgressBar.create
```
Creates a basic progress bar beginning at `0`, a maximum capacity of `100` and
tells it to start.
```text
Progress: | |
```
### Marking Progress
Every call to `#increment` will advance the bar by `1`. Therefore:
```ruby
50.times { progressbar.increment }
```
Would output an advancing line which would end up here:
```text
Progress: |=================================== |
```
### Animation
Full Reference
--------------------------------------------------------------------------------
There's gotten to be too much awesome to pack into one page. Visit the
[wiki][wiki] for the full documentation.
Issues
--------------------------------------------------------------------------------
If you have problems, please create a [Github issue][issues].
Credits
--------------------------------------------------------------------------------
![The Kompanee][kompanee-logo]
ruby-progressbar is maintained by [The Kompanee, Ltd.][kompanee-site]
The names and logos for The Kompanee are trademarks of The Kompanee, Ltd.
License
--------------------------------------------------------------------------------
ruby-progressbar 1.0 is Copyright © 2011-2021 The Kompanee. It is free
software, and may be redistributed under the terms specified in the LICENSE
file.
ruby-progressbar 0.9.0 is Copyright © 2008 [Satoru Takabayashi][satoru]
[contributors]: https://github.com/jfelchner/ruby-progressbar/graphs/contributors
[dependencies]: https://github.com/jfelchner/ruby-progressbar/network/dependents
[gemspec]: https://github.com/jfelchner/ruby-progressbar/blob/master/ruby-progressbar.gemspec
[history]: https://github.com/jfelchner/ruby-progressbar/wiki/History
[issues]: https://github.com/jfelchner/ruby-progressbar/issues
[kompanee-logo]: https://kompanee-public-assets.s3.amazonaws.com/readmes/kompanee-horizontal-black.png
[kompanee-site]: http://www.thekompanee.com
[satoru]: http://0xcc.net
[wiki]: https://github.com/jfelchner/ruby-progressbar/wiki