Skip to content
This repository

Animated spinner for shell

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 lib
Octocat-spinner-32 .gitignore
Octocat-spinner-32 Gemfile
Octocat-spinner-32 README.md
Octocat-spinner-32 Rakefile
Octocat-spinner-32 shell-spinner.gemspec
README.md

Shell Spinner

Gem provides animated spinner for UNIX shell and could be used with rake tasks and any console scripts. It basically wraps any code and show spinner until code isn't completed.

Installation

gem install shell-spinner

In Rails 3, add this to your Gemfile and run the bundle command.

gem "shell-spinner"

Usage

The main gem function ShellSpinner accepts text string as first argument, which is not required, but it's better to have it for pretty output. And it accepts block of code. So spinner will be presented while block is running.

require 'shell-spinner'

# With message
ShellSpinner "Positive result" do
  Rake::Task["foo:bar"].invoke
end

# Spinner without message
ShellSpinner do
  sleep 1
end

# With exception
ShellSpinner "Code with exception" do
  sleep 2
  raise "Some exception"
end

This code produces output similar to:

> Positive result... done
> Code with exception... fail
> <exception message and backtrace>

I can't show you a spinner there, but promise - it appears :)

Something went wrong with that request. Please try again.