Popularity
8.4
Stable
Activity
0.0
Stable
63
8
1

Monthly Downloads: 54
Programming language: Haskell
License: MIT License
Tags: System    
Latest version: v0.3.3.0

ascii-progress alternatives and similar packages

Based on the "System" category.
Alternatively, view ascii-progress alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of ascii-progress or a related project?

Add another 'System' Package

README

ascii-progress

hackage version Build Status packagename on Stackage LTS 8 packagename on Stackage Nightly


A simple Haskell progress bar for the console. Heavily borrows from TJ Holowaychuk's Node.JS project progress.

demo

Packages Using ascii-progress

Basic Usage

import Control.Concurrent (threadDelay)
import Control.Monad (unless)
import System.Console.AsciiProgress (Options(..), displayConsoleRegions,
                                     isComplete, def, newProgressBar, tick)

main :: IO ()
main = displayConsoleRegions $ do
    pg <- newProgressBar def { pgWidth = 50 }
    loop pg
  where
    loop pg = do
        b <- isComplete pg
        unless b $ do
            threadDelay $ 200 * 1000
            tick pg
            loop pg

Full documentation on hackage

Multiple progress bar support

Though still rudimentary, there's support for running multiple concurrent progress bars. The multi-example shows off this feature: demo-multi

Examples

The bin directory contains the example above and a more complex example which uses http-conduit to download an image from imgur, printing the progress using the package.

To build the examples, just configure and compile with -fexamples:

git clone https://github.com/yamadapc/haskell-ascii-progress
cabal install -j --only-dep -fexamples
cabal configure -fexamples
cabal run example
# ...
cabal run download-example

Options

ascii-progress uses an Options data type for configuring the progress bar. Available options are:

pgFormat :: String

A format String for the progress bar. The following placeholders are supported:

  • ":eta" (ETA displayed in seconds)
  • ":current" (current tick)
  • ":total" (total number of ticks)
  • ":percent" (percentage completed)
  • ":elapsed" (elapsed time in seconds)
  • ":bar" (the actual progress bar)

Example

main = do
    pg <- newProgressBar def { pgFormat = ":current/:total [:bar]" }
    -- ...

pgCompletedChar :: Char

The character used on the completed part of the bar

There's an example which mimicks the NPM3 progress-bar. It looks like:

Working ╢████████████████████████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░╟

pgPendingChar :: Char

The character used on the completed part of the bar

pgTotal :: Int

The total amount of ticks for the bar to be completed

pgWidth :: Int

The progress bar's total width in columns

pgOnCompletion :: Maybe String

What to output when the progress bar is done. The same format placeholders used in pgFormat may be used.

pgGetProgressStr :: Options -> Stats -> String

If all else fails, you can provide a function which determines how a progress-bar is rendered.

Installing

This package is published to hackage as ascii-progress, so you can install it with:

cabal install ascii-progress

It's also part of stackage.

License

This code is licensed under the MIT license for Pedro Tacla Yamada. For more information please refer to the LICENSE file.


*Note that all licence references and agreements mentioned in the ascii-progress README section above are relevant to that project's source code only.