progressbar

KO | EN

gitlite — search

#javascript #ai #go #android #rust #linux #docker #macos #nodejs #vue #awesome-list #security #pytorch #mcp

(★ 16)

Easy progress bars in Clojure.

progressbar 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# progressbar

Easy progress bars in Clojure.

## Installation

progressbar artifacts are published on [Clojars](https://clojars.org/progressbar):

Add progressbar to your `project.clj`:

```clj
   [progressbar "0.0.2"]
```

## Usage

`progressbar` transparently wraps any `map`able object to print feedback to
standard out as items in the seq are processed.

```clojure
user> (require '[progressbar.core :refer [progressbar]])
user> (doall (map identity (progressbar (range 10) :print-every 2)))
[====) # this is animated from [) to [====) using \r
(0 1 2 3 4 5 6 7 8 9)
```

The default progressbar looks like this:

```
[===)
```

and will grow infinitely large. By default, it will print an `=` for
every 10 items in the seq that are processed.

Note that if the input seq implements `clojure.lang.Counted`, the
default progressbar will be bounded, like:

```
[===        ]
```

### Options

<dl>
<dt>:print-every</dt>
<dd>The number of items each `=` represents</dd>
<dt>:progress-seq</dt>
<dd>A custom progress seq. An element from this seq will be printed every time an element from the wrapped seq is processed, unless the element from the progress seq is `nil`.</dd>
<dt>:count</dt>
<dd>If given, the progress bar will be bounded, indicating how close to completion we are</dd>
<dt>:width</dt>
<dd>If a count is given, this controls how wide the progress bar will be.</dd>
</dl>

### Extension

`progressbar` uses a protocol to determine what kind of progress seq
to use. We have extended `progressbar.progress-seq.ProgressSeq` to
return an "unbounded" (ie, like `[===)`) progress seq for
`java.lang.Object` and a "bounded" progress seq (ie, like `[===   ]`)
for any class that implements `clojure.lang.Counted`.

`progressbar.progress-seq.ProgressSeq` can be extended to new
arbitrary types in order to make progress seq selection automatic. For
example, an HTTP response could return its response bytes as a
`seq`-able type representing a stream of bytes, and
`progressbar.progress-seq.ProgressSeq` could be extended to that type
to return a bounded seq whose count is set from the `Content-Length`
header of the HTTP response.

### Custom progress seqs

Clients can pass a seq to `progressbar` as `:progress-seq`. The given
seq will be used as progress output:

```clojure
user> (doall (map identity (progressbar (range 10)
                                        :progress-seq [nil "two\n" nil "four\n" nil "six\n" nil "eight\n" nil "ten\n"])))
two
four
six
eight
ten
(0 1 2 3 4 5 6 7 8 9)
```

```clojure
user> (doall (map identity (progressbar (range 10 20)
                                        :progress-seq (iterate inc 0))))
0
1
2
3
4
5
6
7
8
9
(10 11 12 13 14 15 16 17 18 19)
```

**Warning: if the progress seq is shorter than the seq you are processing, some elements from the seq you are processing may not be processed!**

## TODO

- extend ProgressSeq to native java types

## License

Distributed under the Eclipse Public License, the same as Clojure.

progressbar

progressbar 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

progressbar

progressbar 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README