Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Generates bumpspark-style sparklines as PNG (including Data URI support) from Ruby and Rails.

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 exe
Octocat-spinner-32 lib
Octocat-spinner-32 spec
Octocat-spinner-32 .document
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .rspec
Octocat-spinner-32 .ruby-version
Octocat-spinner-32 .rvmrc
Octocat-spinner-32 .travis.yml
Octocat-spinner-32 Gemfile
Octocat-spinner-32 LICENSE.txt
Octocat-spinner-32 README.md
Octocat-spinner-32 Rakefile
Octocat-spinner-32 TODO.markdown
Octocat-spinner-32 bumpspark.gemspec
README.md

Bumpspark

Build Status Code Climate

Generate "bumpspark"-style sparklines from Ruby & Rails. Bumpsparks are sparklines which show discrete data points and highlight extremes.

Note: This library is based on _why's `bumpspark' code, originally discussed and collaborated on at RedHanded.

It has been refactored and built out as a gem suitable for inclusion in Rails projects (and standalone Ruby code).

Credits

Thanks to the original collaborators:

  • _why (concept, BMP implementation)
  • jzp (png)
  • MenTaLguY (transparency)

Installation

gem install bumpspark

Usage

From Rails

Add bumpspark as a dependency:

gem 'bumpspark'

Use bumpspark_tag from your views or helpers, passing it the data points you'd like graphed.

<%= bumpspark_tag [12, 34, 12, 42, 12, 23] %>

From Ruby

Simply create a Bumpspark::Graph instance and call to_png on it.

require 'bumpspark'

graph = Bumpspark::Graph.new [12, 34, 12, 42, 12, 23]

File.open('bumpspark.png', 'wb') do |file|
  file.write graph.to_png
end

From the commandline

Generate a bumpspark directly from the commandline.

% cat temperature.txt
23 25 33 22 25 33 22

% cat temperature.txt | bumpspark > temperature.png

Note on Patches/Pull Requests

Please check the TODO file for information on things that need doing.

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.

Copyright

Copyright (c) 2009-2012 Bruce Williams, et al. See LICENSE for details.

Something went wrong with that request. Please try again.