Gần đây mình thường hay phải chạy mấy cái rake task siêu to khổng lồ, ngồi nhìn cái màn hình log ra mấy dòng chữ nhạt nhẽo cũng chán. Nhẩm nghĩ liệu có cái thư viện nào giúp mình hiển thị trạng thái của tiến trình đang chạy lên màn hình không, ấy thế là mình khám phá ra cái thư viện hay ho này. Ruby-progressbar là một lựa chọn khá tuyệt vời cho việc hiển thị progress chạy của một hàm, một job hay một task bất kỳ trong Ruby. Nó có một số ưu điểm như sau:

• là gem lâu đời và vẫn dùng tốt từ 2008 đến nay
• có test suite đầy đủ
• không có dependencies
• được sử dụng bởi rất nhiều dự án mã nguồn mở
• trải nghiệm tốt
• có nhiều contributors và được maintain thường xuyên

Hãy bắt đầu tìm hiểu và cùng trải nghiệm nó thôi!

Cài đặt

Bạn có thể cài luôn vào gem

gem install ruby-progressbar

sau đó trong script đặt thêm require 'ruby-progressbar'

hoặc đặt vào Gemfile

gem 'ruby-progressbar'

Sử dụng như nào?

Cách khởi tạo đơn giản thôi.

progressbar = ProgressBar.create

Dòng lệnh này tạo một cái progress bar đơn giản bắt đầu từ 0 với độ đo lớn nhất là 100, sẽ hiển thị trên màn hình như thế này:

Progress: |                                                                       |

Ngoài ra bạn có thể có nhiều option để tạo một progress bar, ví dụ:

ProgressBar.create(:title => "Items", :starting_at => 20, :total => 200)

Cái này sẽ output ra như sau:

Items: |=======                                                                |

Dưới đây là mô tả chi tiết về các options bạn có thể sử dụng:

Cập nhật progress

Biết cách tạo ra nó rồi, vậy làm thế nào để cập nhật progress của bar? Dưới đây là một vài phương thức mà thư viện cung cấp:

Có thể minh họa bằng hình ảnh như sau:

Stopping

Bạn có thể dừng progress bar bằng một trong bốn cách sau:

Quan sát minh họa:

Finishing

Mặc định, bạn sẽ thấy thanh hiển thị kết thúc khi progress đạt giá trị bằng với total. Nếu không muốn progress bar tự động kết thúc, hãy truyền option autofinish: false khi khởi tạo.

progressbar = ProgressBar.create(:starting_at => 9, :total => 10)
progressbar.increment

# Sử dụng .finished? để kiểm tra trạng thái kết thúc
progressbar.finished? # => true

progressbar = ProgressBar.create(:starting_at => 9, :total => 10, :autofinish => false)
progressbar.increment

progressbar.finished? # => false

Refreshing

Nếu bạn cần hiển thị lại progress bar để cho người dùng trải nghiệm real-time hơn, hãy dùng #refresh. #refresh không tác động đến vị trí hiện tại của progress mà sẽ cập nhật log thời gian Elapsed time và Estimated time.

Tiến trình không rõ điểm kết thúc

Đôi khi bạn sẽ gặp trường hợp phải thực hiện một công việc mà không biết rõ tổng khối lượng của nó là bao nhiêu. Điều này có thể xảy ra khi bạn đang download một đống files hoặc khi bạn đang xử lý một tập các jobs chưa được load hoàn toàn.

Những lúc như thế bạn có thể set giá trị của total là nil và tiếp tục tăng progress của bar nhưu bình thường. Lúc này thanh hiển thị sẽ cho bạn thấy progress đang chạy nhưng không rõ là bao nhiêu và bao giờ sẽ hoàn thành. Ví dụ

progressbar = ProgressBar.create(:starting_at => 20, :total => nil)

sẽ output ra giống giống như hình phía trên.

Tại bất cứ thời điểm nào khi bạn biết được giá trị total là bao nhiêu, có thể set cho nó bằng phương thức

progressbar.total = 100

Lúc này progress bar sẽ chuyển thành trạng thái như này:

Progress: |========                                                            |

Logging

Khi sử dụng progress bar, bạn có thể sẽ muốn log một cái output nào đó cho người dùng. Nếu bạn thử sử dụng một câu lệnh puts, bạn sẽ thấy rằng nó viết đè lên thanh hiển thị. Ví dụ khi bạn puts "hello" sau khi một progress được chạy, màn hình có thể trông như này:

helloess: |=======                                                             |
Progress: |========                                                            |

Điều này xảy ra bởi progressbar phải luôn vẽ lại nó mỗi lần progress thay đổi. Đây là giới hạn của việc output trên terminal. Để có thể tránh điều này, hãy sử dụng phương thức #log .

progressbar = ProgressBar.create
progressbar.progress = 20
progressbar.log 'hello'

hello
Progress: |=============                                                       |

Phương thức #Log sẽ tự động clear progress bar, in text rồi vẽ lại bar ở dòng tiếp theo. Vì vậy nếu sử dụng phương thức này, bạn sẽ luôn chỉ nhìn thấy một thanh hiển thị duy nhất trên màn hình mà thôi.

Kết luận

Trên đây là kha khá những gì mà mọi người có thể sử dụng để ứng dụng gem Ruby-progressbar tạo một script cool ngầu trong lập trình với Ruby. Thông tin chi tiết hơn hãy tham khảo Ruby-progressbar Wiki . Happy coding!