easy_pie_chart 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b09e31c313fa7636b8854333780320a5dc705b43
+  data.tar.gz: faae06003607c0ce3e9cdc68dc69c78e84d0a390
+SHA512:
+  metadata.gz: 270dd57d02a20fa246072fd1e0ee81de3bc2eb1d7fd2b4f30863db837eaddfa973d81cd7d89d4592b32ac6ff9fb5d200d8c72aa86d6a84a08d2d8f8639a7f9c6
+  data.tar.gz: 17207f6669f843d5dc0a34625c3ef4d3c0c40e1a40588bf851fcaeb6d0802829cc004fc84cb123eb58d882415e83058046976031d8e2cf4d58413d483f2cf892

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,11 @@
+source "http://rubygems.org"
+
+gem 'rails', '>= 3.0'
+
+group :development do
+  gem "rspec",    ">= 2.8.0"
+  gem "rdoc",     ">= 3.12"
+  gem "bundler",  ">= 1.0.0"
+  gem "jeweler",  ">= 1.8.4"
+  gem "simplecov",">= 0.5"
+end

data/Gemfile.lock

@@ -0,0 +1,109 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (3.2.8)
+      actionpack (= 3.2.8)
+      mail (~> 2.4.4)
+    actionpack (3.2.8)
+      activemodel (= 3.2.8)
+      activesupport (= 3.2.8)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      journey (~> 1.0.4)
+      rack (~> 1.4.0)
+      rack-cache (~> 1.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.1.3)
+    activemodel (3.2.8)
+      activesupport (= 3.2.8)
+      builder (~> 3.0.0)
+    activerecord (3.2.8)
+      activemodel (= 3.2.8)
+      activesupport (= 3.2.8)
+      arel (~> 3.0.2)
+      tzinfo (~> 0.3.29)
+    activeresource (3.2.8)
+      activemodel (= 3.2.8)
+      activesupport (= 3.2.8)
+    activesupport (3.2.8)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    arel (3.0.2)
+    builder (3.0.0)
+    diff-lcs (1.1.3)
+    erubis (2.7.0)
+    git (1.2.5)
+    hike (1.2.1)
+    i18n (0.6.0)
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    journey (1.0.4)
+    json (1.7.5)
+    mail (2.4.4)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.19)
+    multi_json (1.3.6)
+    polyglot (0.3.3)
+    rack (1.4.1)
+    rack-cache (1.2)
+      rack (>= 0.4)
+    rack-ssl (1.3.2)
+      rack
+    rack-test (0.6.1)
+      rack (>= 1.0)
+    rails (3.2.8)
+      actionmailer (= 3.2.8)
+      actionpack (= 3.2.8)
+      activerecord (= 3.2.8)
+      activeresource (= 3.2.8)
+      activesupport (= 3.2.8)
+      bundler (~> 1.0)
+      railties (= 3.2.8)
+    railties (3.2.8)
+      actionpack (= 3.2.8)
+      activesupport (= 3.2.8)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (>= 0.14.6, < 2.0)
+    rake (0.9.2.2)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.11.0)
+      rspec-core (~> 2.11.0)
+      rspec-expectations (~> 2.11.0)
+      rspec-mocks (~> 2.11.0)
+    rspec-core (2.11.1)
+    rspec-expectations (2.11.2)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.11.2)
+    simplecov (0.6.4)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.5.3)
+    simplecov-html (0.5.3)
+    sprockets (2.1.3)
+      hike (~> 1.2)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    thor (0.16.0)
+    tilt (1.3.3)
+    treetop (1.4.10)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.33)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (>= 1.0.0)
+  jeweler (>= 1.8.4)
+  rails (>= 3.0)
+  rdoc (>= 3.12)
+  rspec (>= 2.8.0)
+  simplecov (>= 0.5)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Kristian Mandrup
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,173 @@
+Easy as pie
+==============
+
+A little Rails wrapper for [easy-pie-chart](https://github.com/Nahrae/easy_pie_chart) which adds the assets to the asset pipeline and adds some useful Rails helpers.
+
+Usage
+-----------
+
+In Gemfile:
+
+`gem 'easy_pie_chart'`
+
+Configuration
+-----------
+
+In `application.css` manifest file:
+
+```css
+/*
+ * require jquery.easy-pie-chart
+*/
+```
+
+Using Compass, f.ex in `application.css.scss.erb`
+
+```
+@import 'jquery.easy-pie-chart';
+```
+
+In `application.js` manifest file:
+
+```javascript
+//= require jquery.easy-pie-chart
+```
+
+Optionally include `excanvas` as well, which can be used if/when canvas is not available!
+
+Easy pie chart
+-----------
+
+Easy pie chart is a jQuery plugin that uses the canvas element to render simple pie charts for single values.
+These chars are highly customizable and very easy to implement.
+
+![](https://github.com/rendro/easy-pie-chart/raw/master/img/easy-pie-chart.png)
+
+Get started
+-----------
+
+Follow Configuration instructions above and also include jQuery 1.7+.
+
+Add the pie-chart element to your site to represent chart and add the `data-percent` attribute with the percent number the pie chart should have:
+
+    <div class="chart" data-percent="73">73%</div>
+
+The engine adds a view helper `easy_pie_chart(percent, label = nil)` to all Rails views ;)
+Use as follows
+
+Simple HAML example:
+
+```haml
+= easy_pie_chart 73
+```
+
+ERB examples:
+
+Or with a custom label:
+
+```erb
+<%= easy_pie_chart (6/24.0 * 100), '6 done' %>
+```
+
+Customize `div` options, fx css `class`:
+
+```erb
+<%= easy_pie_chart (6/24.0 * 100), '6 done', :class => 'pie-chart' %>
+```
+
+Finally you have to initialize the plugin with your desired configuration:
+
+```javascript
+$(document).ready(function() {
+    $('.chart').easyPieChart({
+        //your configuration goes here
+    });
+});
+```
+
+Configuration parameter
+-----------------------
+
+You can pass a set of these options to the initialize function to set a custom behaviour and look for the plugin.
+
+<table>
+    <tr>
+        <th>Property (Type)</th>
+        <th>Default</th>
+        <th>Description</th>
+    </tr>
+    <tr>
+        <td><strong>barColor</strong></td>
+        <td>#ef1e25</td>
+        <td>The color of the circular bar. You can pass either a css valid color string like rgb, rgba hex or string colors. But you can also pass a function that accepts the current percentage as a value to return a dynamically generated color.</td>
+    </tr>
+    <tr>
+        <td><strong>trackColor</strong></td>
+        <td>#f2f2f2</td>
+        <td>The color of the track for the bar, false to disable rendering.</td>
+    </tr>
+    <tr>
+        <td><strong>scaleColor</strong></td>
+        <td>#dfe0e0</td>
+        <td>The color of the scale lines, false to disable rendering.</td>
+    </tr>
+    <tr>
+        <td><strong>lineCap</strong></td>
+        <td>round</td>
+        <td>Defines how the ending of the bar line looks like. Possible values are: <code>butt</code>, <code>round</code> and <code>square</code>.</td>
+    </tr>
+    <tr>
+        <td><strong>lineWidth</strong></td>
+        <td>3</td>
+        <td>Width of the bar line in px.</td>
+    </tr>
+    <tr>
+        <td><strong>size</strong></td>
+        <td>110</td>
+        <td>Size of the pie chart in px. It will always be a square.</td>
+    </tr>
+    <tr>
+        <td><strong>animate</strong></td>
+        <td>false</td>
+        <td>Time in milliseconds for a eased animation of the bar growing, or false to deactivate.</td>
+    </tr>
+    <tr>
+        <td><strong>onStart</strong></td>
+        <td>$.noop</td>
+        <td>Callback function that is called at the start of any animation (only if animate is not false).</td>
+    </tr>
+    <tr>
+        <td><strong>onStop</strong></td>
+        <td>$.noop</td>
+        <td>Callback function that is called at the end of any animation (only if animate is not false).</td>
+    </tr>
+</table>
+
+Public plugin methods
+-----------
+
+If you want to update the current percentage of the a pie chart, you can call the `update method. The instance of the plugin is saved in the jQuery-data.
+
+```javascript
+$(function() {
+    //create instance
+    $('.chart').easyPieChart({
+        animate: 2000
+    });
+    //update instance after 5 sec
+    setTimeout(function() {
+        $('.chart').data('easyPieChart').update(40);
+    }, 5000);
+});
+``
+
+## Contributing to easy_pie_chart
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+

data/Rakefile

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "easy_pie_chart"
+  gem.homepage = "http://github.com/kristianmandrup/easy_pie_chart"
+  gem.license = "MIT"
+  gem.summary = %Q{Rails asset wrapper for jQuery easy-pie-chart}
+  gem.description = %Q{Makes it easy to add Pie charts to Rails 3+ apps}
+  gem.email = "kmandrup@gmail.com"
+  gem.authors = ["Kristian Mandrup"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "easy_pie_chart #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.2

data/easy_pie_chart.gemspec

@@ -0,0 +1,72 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "easy_pie_chart"
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Nahrae Jin"]
+  s.date = "2015-01-02"
+  s.description = "Makes it easy to add Pie charts to Rails 4+ apps"
+  s.email = "jinnahrae@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "easy_pie_chart.gemspec",
+    "lib/easy_pie_chart.rb",
+    "lib/easy_pie_chart/engine.rb",
+    "lib/easy_pie_chart/view_helper.rb",
+    "spec/easy_pie_chart/view_helper_spec.rb",
+    "spec/spec_helper.rb",
+    "vendor/assets/javascripts/excanvas.js",
+    "vendor/assets/javascripts/jquery.easy-pie-chart.js",
+    "vendor/assets/javascripts/jquery.easy-pie-chart.js.coffee",
+    "vendor/assets/stylesheets/jquery.easy-pie-chart.css"
+  ]
+  s.homepage = "http://github.com/Nahrae/easy_pie_chart"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.24"
+  s.summary = "Rails asset wrapper for jQuery easy-pie-chart"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rails>, [">= 3.0"])
+      s.add_development_dependency(%q<rspec>, [">= 2.8.0"])
+      s.add_development_dependency(%q<rdoc>, [">= 3.12"])
+      s.add_development_dependency(%q<bundler>, [">= 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, [">= 1.8.4"])
+      s.add_development_dependency(%q<simplecov>, [">= 0.5"])
+    else
+      s.add_dependency(%q<rails>, [">= 3.0"])
+      s.add_dependency(%q<rspec>, [">= 2.8.0"])
+      s.add_dependency(%q<rdoc>, [">= 3.12"])
+      s.add_dependency(%q<bundler>, [">= 1.0.0"])
+      s.add_dependency(%q<jeweler>, [">= 1.8.4"])
+      s.add_dependency(%q<simplecov>, [">= 0.5"])
+    end
+  else
+    s.add_dependency(%q<rails>, [">= 3.0"])
+    s.add_dependency(%q<rspec>, [">= 2.8.0"])
+    s.add_dependency(%q<rdoc>, [">= 3.12"])
+    s.add_dependency(%q<bundler>, [">= 1.0.0"])
+    s.add_dependency(%q<jeweler>, [">= 1.8.4"])
+    s.add_dependency(%q<simplecov>, [">= 0.5"])
+  end
+end
+

data/lib/easy_pie_chart/engine.rb

@@ -0,0 +1,9 @@
+module EasyAsPie
+  module Rails
+    class Engine < ::Rails::Engine
+      initializer 'easy as pie config' do
+        ActionView::Base.send :include, EasyAsPie::ViewHelper
+      end
+    end
+  end
+end

data/lib/easy_pie_chart/view_helper.rb

@@ -0,0 +1,17 @@
+module EasyAsPie
+  module ViewHelper
+
+    # <div class="chart" data-percent="73">73%</div>
+    def easy_pie_chart percent, *args
+      raise ArgumentError, "Must take a percent argument" unless percent
+      pie_options = {:"data-percent" => percent, :class => 'chart'}
+      
+      options = args.extract_options!
+      pie_options.merge!(options || {})
+
+      label = args.first || "#{percent}%"
+
+      content_tag :div, label, pie_options
+    end
+  end
+end

data/lib/easy_pie_chart.rb

@@ -0,0 +1,2 @@
+require 'easy_pie_chart/view_helper'
+require 'easy_pie_chart/engine' if defined?(::Rails::Engine)

data/spec/easy_pie_chart/view_helper_spec.rb

@@ -0,0 +1,27 @@
+require 'spec_helper'
+
+describe EasyAsPie::ViewHelper do
+  include ControllerTestHelpers,  
+          EasyAsPie::ViewHelper
+
+  # <div class="chart" data-percent="73">73%</div>
+  describe '.easy_pie_chart percent, *args' do
+    context 'no arguments' do
+      specify do
+        expect { easy_pie_chart }.to raise_error(ArgumentError)
+      end
+    end
+
+    context '50%' do
+      specify do
+        easy_pie_chart(50).should == "<div class=\"chart\" data-percent=\"50\">50%</div>"
+      end
+    end
+
+    context "50%, 'of rooms'" do
+      specify do
+        easy_pie_chart(50, '50 rooms').should == "<div class=\"chart\" data-percent=\"50\">50 rooms</div>"
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,46 @@
+# coding: utf-8
+require 'rubygems'
+require 'rails'
+require 'json'
+require 'active_support'
+require 'action_pack'
+require 'action_view'
+require 'action_controller'
+require 'action_view/template'
+
+require 'rspec'
+require 'easy_pie_chart'
+
+# WorldFlags::Rails::Engine.add_view_ext
+
+SPEC_DIR = File.dirname(__FILE__)
+
+module ControllerTestHelpers
+
+  def self.included(base)
+    base.class_eval do
+      
+      include ActionView::Helpers,
+              ActionView::Helpers::CaptureHelper,
+              ActionView::Helpers::JavaScriptHelper,
+              ActionView::Helpers::AssetTagHelper
+  
+      # allow tabs.create to run by stubbing an output_buffer
+      attr_accessor :output_buffer
+      @output_buffer = ""
+  
+      # stub content_for for testing
+      def content_for(name, content = nil, &block)
+        # this doesn't exist, and causes errors
+        @_content_for = {} unless defined? @_content_for
+        # we've got to initialize this, so we can concat to it
+        @_content_for[name] = '' if @_content_for[name].nil?
+        # now the rest is the same as in rails
+        content = capture(&block) if block_given?
+        @_content_for[name] << content if content
+        @_content_for[name] unless content
+      end    
+    end
+  end
+
+end