Add a feature to the progress bar that displays additional variables … (#256)

* Add a feature to the progress bar that displays additional variables and their values.
```julia
using Term.Progress
a = 10
b = 0.1
extra_info = Dict("Current loss" => a, "Learning rate" => b)
pbar = ProgressBar(; extra_info)
job = addjob!(pbar; N = 5)
start!(pbar)
for i in 1:5
    a = 10-i
    b = 0.1i
    println("Epoch $i")
    pbar.extra_info = Dict("Current loss" => a, "Learning rate" => b)
    update!(job)
    render(pbar)
    sleep(1)
end
stop!(pbar)
```

And the output will be:
```
Epoch 1
...
─────────────────────────── progress ───────────────────────────
Running... ● ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ● 5/5 100%
Current loss  : 5
Learning rate : 0.5
```
	modified:   src/progress.jl

* Modify the results of the test set corresponding to https://github.com/abcdvvvv/Term.jl/blob/4145a63d52c1185cb828f162931e7d8103a71545/src/progress.jl#L115

	modified:   test/15_test_progress.jl

Author: abcdvvvv

src/progress.jl

@@ -112,7 +112,7 @@ mutable struct ProgressJob
     )
         return new(
             id,
-            isnothing(N) ? 0 : 1,
+            0,
             N,
             description,
             columns,
@@ -183,9 +183,11 @@ end
 Update a job's progress `i` by setting its value or adding `+1`.
 """
 function update!(job::ProgressJob; i = nothing)
-    (!isnothing(job.N) && job.i ≥ job.N) && return stop!(job)
-
-    job.i += something(i, 1)
+    if !isnothing(job.N) && job.i ≥ job.N
+        stop!(job)
+    else
+        job.i += something(i, 1)
+    end
     return nothing
 end
 
@@ -249,7 +251,8 @@ Arguments:
     - `running`: true if the progress bar is active
     - `paused`: false when the bar is running but briefly paused (e.g. to update `jobs`)
     - `task`: references a `Task` for updating the progress bar in parallel
-    - `renderstatus`: a `RenderStatus` instance.
+    - `renderstatus`: a `RenderStatus` instance
+    - `extra_info`: a `Dict{String,<:Any}` to show extra information.
 """
 mutable struct ProgressBar
     jobs::Vector{ProgressJob}
@@ -267,21 +270,23 @@ mutable struct ProgressBar
     paused::Bool
     task::Union{Task,Nothing}
     renderstatus::Any
+    extra_info::Union{Dict{String,<:Any},Nothing}
 end
 
 """
     ProgressBar(;
-        width::Int=$(default_width()),
+        width::Int = $(default_width()),
         columns::Union{Vector{DataType}, Symbol} = :default,
         columns_kwargs::Dict = Dict(),
-        expand::Bool=false,
+        expand::Bool = false,
         transient::Bool = false,
         colors::Vector{RGBColor} = [
             RGBColor("(1, .05, .05)"),
             RGBColor("(.05, .05, 1)"),
             RGBColor("(.05, 1, .05)"),
         ],
-        refresh_rate::Int=60,  # FPS of rendering
+        refresh_rate::Int = 60,  # FPS of rendering
+        extra_info::Union{Dict{String,<:Any},Nothing} = nothing,
     )
 
 Create a ProgressBar instance.
@@ -294,6 +299,7 @@ function ProgressBar(;
     transient::Bool                         = false,
     colors::Union{String,Vector{RGBColor}}  = [RGBColor("(1, .05, .05)"), RGBColor("(.05, .05, 1)"), RGBColor("(.05, 1, .05)")],
     refresh_rate::Int                       = 60,  # FPS of rendering
+    extra_info::Union{Dict{String,<:Any},Nothing} = nothing,
 )
     columns = columns isa Symbol ? get_columns(columns) : columns
 
@@ -313,6 +319,7 @@ function ProgressBar(;
         false,
         nothing,
         RenderStatus(),
+        extra_info,
     )
 end
 
@@ -485,7 +492,7 @@ function render(pbar::ProgressBar)
     end
 
     # get variables
-    njobs, height = length(pbar.jobs) + 1, console_height()
+    njobs, height = 1 + length(pbar.jobs) + length(pbar.extra_info), console_height()
     iob = pbar.buff
 
     # on the first render, create sticky region
@@ -522,6 +529,14 @@ function render(pbar::ProgressBar)
         write(iob, contents * coda)
     end
 
+    # render the extra information
+    if !isnothing(pbar.extra_info)
+        max_len = maximum(length.(keys(pbar.extra_info)))
+        for (k, v) in pbar.extra_info
+            write(iob, "\n" * k * " "^(max_len - length(k)) * " : " * string(v))
+        end
+    end
+
     # restore position and write
     move_to_line(iob, pbar.renderstatus.scrollline)
     return print(String(take!(iob)))

test/15_test_progress.jl

@@ -15,19 +15,19 @@ using ProgressLogging
 
     j1 = addjob!(pbar; description = "test", N = 10)
     @test render(j1) isa String  # coverage
-    @test jobcolor(j1) == "(190, 35, 112)"
+    @test jobcolor(j1) == "(209, 16, 112)"
 
     @test j1.id == 1
     @test j1.N == 10
-    @test j1.i == 1
+    @test j1.i == 0
     @test j1.description == "test"
     @test j1.started
     @test j1.columns isa Vector{AbstractColumn}
 
     update!(j1)
-    @test j1.i == 2
+    @test j1.i == 1
     update!(j1; i = 10)
-    @test j1.i == 12
+    @test j1.i == 11
 
     @test getjob(pbar, j1.id).id == j1.id