tracks-chartjs-ror 3.6.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a5bba648f3157a4fcce42c146ee94402fa3136de2f4afbaa57e9437dcc294d19
+  data.tar.gz: 81885547026f01d766c3bc384c11df26b891d531a2bbe8b63b0e398a016c3843
+SHA512:
+  metadata.gz: 6a31e195ff35d6f56008683d4be8486be4be65442c887e9e55507573aa1d270230fc8fc61f0183806ca6908cfb9b77491858ea7a5b3e5b25b947c6e771882c31
+  data.tar.gz: 4a8ceb4b5fb93fea805b15a8e5ffa8da417a857b82ca9ad0ebd7d90866048b196ed24c35650121632c1003bd18f2d3746f41bf7a696f050282265c6a6153de75

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/CHANGELOG.md

@@ -0,0 +1,137 @@
+# CHANGELOG
+
+
+## 3.6.4 - 2019-02-27
+
+- Add argument for plugins.
+
+
+## 3.6.3 - 2019-02-14
+
+- Use Chart.js v2.7.3.
+- Add CSP nonce to inline JavaScript.
+- Do not modify options.
+
+
+## 3.6.2 - 2018-03-14
+
+- Use Chart.js v2.7.2.
+
+
+## 3.6.1 - 2018-03-14
+
+- Use Chart.js v2.7.1.
+
+
+## 3.6.0 - 2018-03-14
+
+- Use Chart.js v2.7.0.
+
+
+## 3.5.0 - 2018-03-14
+
+- Use Chart.js v2.6.0.
+
+
+## 3.4.0 - 2018-03-14
+
+- Use Chart.js v2.5.0.
+
+
+## 3.3.1 - 2017-01-27
+
+- Improve conversion of data and options hashes to JavaScript.
+
+
+## 3.3.0 - 2017-01-26
+
+- Use Chart.js v2.4.0.
+
+
+## 3.2.0 - 2017-01-25
+
+- Use Chart.js v2.3.0.
+
+
+## 3.1.0 - 2017-01-25
+
+- Use Chart.js v2.2.0.
+- Add CHANGELOG.
+
+
+## 3.0.2 - 2016-06-13
+
+- Add pie chart helper.
+
+
+## 3.0.1 - 2016-06-10
+
+- Add horizontal bar chart helper.
+
+
+## 3.0.0 - 2016-06-08
+
+- Use Chart.js v2.1.4 (backwards incompatible).
+
+
+## 2.2.0 - 2015-08-26
+
+- Use Chart.js v1.0.2.
+
+
+## 2.1.3 - 2015-08-26
+
+- AJAX and Turbolinks compatibility.
+
+
+## 2.1.2 - 2015-08-18
+
+- Pass `onAnimationComplete` and `onAnimationProgress` functions correctly.
+
+
+## 2.1.1 - 2015-03-13
+
+- Provide original helpers with easy way to opt out.
+- Namespace the view helpers.
+- Fix name of polar_area_chart in README.
+- Ensure any old charts are cleaned up.
+- Clarify optional features.
+- State Chart.js version in README.
+
+
+## 2.1.0 - 2015-01-14
+
+- Use Chart.js v1.0.1.
+- Support Turbolinks.
+- Do not generate a legend by default.
+
+
+## 2.0.0 - 2014-11-07
+
+- Use Chart.js 1cfa42bc (a little after v1.0.1-beta.4).
+- Wrap generated JavaScript snippet in a closure.
+- Use Chart.js' legends.
+- Update README.
+- Add link to scale calculation issue.
+
+
+## 1.1.1 - 2014-03-20
+
+- Rails 4 compatibility.
+
+
+## 1.1.0 - 2014-03-14
+
+- Use Rails' asset pipeline.
+
+
+## 1.0.1 - 2013-06-21
+
+- Opt-in alternative scale calculations.
+- Code for filling gaps in series.
+
+
+## 1.0.0 - 2013-06-16
+
+- First release.
+

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in chartjs-ror.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Andy Stewart
+
+MIT License
+
+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,207 @@
+# chartjs-ror
+
+Simplifies using [Chart.js][] in Rails views.
+
+
+## Current Chart.js version
+
+This gem includes [Chart.js v2.7.3](https://github.com/chartjs/Chart.js/tree/v2.7.3).
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'chartjs-ror'
+
+And then execute:
+
+    $ bundle
+
+There are two builds of Chart.js: with or without Moment.js.
+
+Choose the appropriate one in your javascript manifest:
+
+- Without Moment.js:
+  ```javascript
+  //= require Chart.min
+  ```
+
+- With Moment.js:
+  ```javascript
+  //= require Chart.bundle.min
+  ```
+
+Please note Chart.js [no longer supports IE8 and below](https://github.com/chartjs/Chart.js/issues/2396#issuecomment-215233106).
+
+
+## Usage
+
+Each chart type has a corresponding helper for your views.  The helper methods take the same arguments as their Javascript counterparts.  The `options` are optional.
+
+
+```erb
+<%= line_chart           data, options %>
+<%= bar_chart            data, options %>
+<%= horizontal_bar_chart data, options %>
+<%= radar_chart          data, options %>
+<%= polar_area_chart     data, options %>
+<%= pie_chart            data, options %>
+<%= doughnut_chart       data, options %>
+<%= bubble_chart         data, options %>
+<%= scatter_chart        data, options %>
+```
+
+If you don't want these helpers – perhaps they clash with other methods in your views – add this initializer to your app:
+
+```ruby
+# config/initializers/chartjs.rb
+Chartjs.no_conflict!
+```
+
+Then you can use these helpers instead:
+
+```erb
+<%= chartjs_line_chart           data, options %>
+<%= chartjs_bar_chart            data, options %>
+<%= chartjs_horizontal_bar_chart data, options %>
+<%= chartjs_radar_chart          data, options %>
+<%= chartjs_polar_area_chart     data, options %>
+<%= chartjs_pie_chart            data, options %>
+<%= chartjs_doughnut_chart       data, options %>
+<%= chartjs_bubble_chart         data, options %>
+<%= chartjs_scatter_chart        data, options %>
+```
+
+For example, to render a [line chart][linechart] in Javascript:
+
+```javascript
+var data = {
+    labels: ["January", "February", "March", "April", "May", "June", "July"],
+    datasets: [
+        {
+            label: "My First dataset",
+            backgroundColor: "rgba(220,220,220,0.2)",
+            borderColor: "rgba(220,220,220,1)",
+            data: [65, 59, 80, 81, 56, 55, 40]
+        },
+        {
+            label: "My Second dataset",
+            backgroundColor: "rgba(151,187,205,0.2)",
+            borderColor: "rgba(151,187,205,1)",
+            data: [28, 48, 40, 19, 86, 27, 90]
+        }
+    ]
+};
+var options = { ... };
+new Chart(ctx, {
+    type: 'Line',
+    data: data,
+    options: options
+});
+```
+
+The Ruby equivalent is:
+
+```ruby
+data = {
+  labels: ["January", "February", "March", "April", "May", "June", "July"],
+  datasets: [
+    {
+        label: "My First dataset",
+        backgroundColor: "rgba(220,220,220,0.2)",
+        borderColor: "rgba(220,220,220,1)",
+        data: [65, 59, 80, 81, 56, 55, 40]
+    },
+    {
+        label: "My Second dataset",
+        backgroundColor: "rgba(151,187,205,0.2)",
+        borderColor: "rgba(151,187,205,1)",
+        data: [28, 48, 40, 19, 86, 27, 90]
+    }
+  ]
+}
+options = { ... }
+<%= line_chart data, options %>
+```
+
+You can also use underscored symbols for keys, instead of the camelcase versions.
+They will be converted to their lower camelcase counterparts on output.
+
+```ruby
+data = {
+  labels: ["January", "February", "March", "April", "May", "June", "July"],
+  datasets: [
+    {
+        label: "My First dataset",
+        background_color: "rgba(220,220,220,0.2)",
+        border_color: "rgba(220,220,220,1)",
+        data: [65, 59, 80, 81, 56, 55, 40]
+    },
+    {
+        label: "My Second dataset",
+        background_color: "rgba(151,187,205,0.2)",
+        border_color: "rgba(151,187,205,1)",
+        data: [28, 48, 40, 19, 86, 27, 90]
+    }
+  ]
+}
+options = { ... }
+<%= line_chart data, options %>
+```
+
+### Options
+
+You can put anything in the `options` hash that Chart.js recognises.  To pass a JavaScript function as an option value, wrap it in quotation marks to make it a string.
+
+You can also use these non-Chart.js settings:
+
+* `:class`          - class of the DOM canvas element - default is `chart`.
+* `:id`             - id of the DOM canvas element - default is `chart-n` where `n` is the 0-based index of the chart on the page.
+* `:width`          - width of the canvas in px - default is `400`.
+* `:height`         - height of the canvas in px - default is `400`.
+
+
+## Sample output
+
+```html
+<canvas id="chart-0" class="chart" width=400 height=400></canvas>
+<script type="text/javascript">
+  //<![CDATA[
+  (function() {
+    var initChart = function() {
+      var ctx = document.getElementById("chart-0");
+      var chart = new Chart(ctx, {
+        type: "Line",
+        data = { ... };
+        options = { ... };
+      });
+    };
+
+    if (typeof Chart !== "undefined" && Chart !== null) {
+      initChart();
+    }
+    else {
+      if (window.addEventListener) {
+        window.addEventListener("load", initChart, false);
+      }
+      else if (window.attachEvent) {
+        window.attachEvent("onload", initChart);
+      }
+    }
+  })();
+  //]]>
+</script>
+```
+
+The Javascript is actually written out on a single line but you get the idea.
+
+
+## Intellectual Property
+
+Copyright Andrew Stewart, AirBlade Software.  Released under the MIT licence.
+
+
+  [Chart.js]: http://www.chartjs.org/
+  [linechart]: http://www.chartjs.org/docs/#line-chart
+

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.test_files = FileList['test/*_test.rb']
+  t.verbose  = true
+end

data/lib/chartjs/chart_helpers.rb

@@ -0,0 +1,108 @@
+require 'json'
+require 'bigdecimal'
+
+module Chartjs
+  module ChartHelpers
+
+    CHART_TYPES = %w[ bar bubble doughnut horizontal_bar line pie polar_area radar scatter ]
+
+    module Explicit
+      CHART_TYPES.each do |type|
+        define_method "chartjs_#{type}_chart" do |data, options = {}, plugins = {}|    # def chartjs_polar_area_chart(data, options = {}, plugins = {})
+          chart type, data, options, plugins                                           #   chart 'polar_area', data, options, plugins
+        end                                                                            # end
+      end
+      include Chartjs::ChartHelpers
+    end
+
+    module Implicit
+      CHART_TYPES.each do |type|
+        define_method "#{type}_chart" do |data, options = {}, plugins = {}|            # def polar_area_chart(data, options = {}, plugins = {})
+          chart type, data, options, plugins                                           #   chart 'polar_area', data, options, plugins
+        end                                                                            # end
+      end
+      include Chartjs::ChartHelpers
+    end
+
+    private
+
+    def chart(type, data, options, plugins)
+      opts = options.dup
+
+      @chart_id ||= -1
+      element_id = opts.delete(:id)     || "chart-#{@chart_id += 1}"
+      css_class  = opts.delete(:class)  || 'chart'
+      width      = opts.delete(:width)  || '400'
+      height     = opts.delete(:height) || '400'
+
+      canvas = content_tag :canvas, '', id: element_id, class: css_class, width: width, height: height
+      container = content_tag :div, canvas, id: element_id + "-container", class: css_class, width: width, height: height
+
+      script = javascript_tag(nonce: true) do
+        <<-END.squish.html_safe
+        (function() {
+          var initChart = function() {
+            var ctx = document.getElementById(#{element_id.to_json});
+            var chart = new Chart(ctx, {
+              type:    "#{camel_case type}",
+              data:    #{to_javascript_string data},
+              options: #{to_javascript_string opts},
+              plugins: #{to_javascript_string plugins},
+            });
+          };
+
+          if (typeof Chart !== "undefined" && Chart !== null) {
+            initChart();
+          }
+          else {
+            /* W3C standard */
+            if (window.addEventListener) {
+              window.addEventListener("load", initChart, false);
+            }
+            /* IE */
+            else if (window.attachEvent) {
+              window.attachEvent("onload", initChart);
+            }
+          }
+        })();
+        END
+      end
+
+      container + script
+    end
+
+    # polar_area -> polarArea
+    def camel_case(string)
+      string.gsub(/_([a-z])/) { $1.upcase }
+    end
+
+    def to_javascript_string(element)
+      case element
+      when Hash
+        hash_elements = []
+        element.each do |key, value|
+          hash_elements << camel_case(key.to_s).to_json + ':' + to_javascript_string(value)
+        end
+        '{' + hash_elements.join(',') + '}'
+      when Array
+        array_elements = []
+        element.each do |value|
+          array_elements << to_javascript_string(value)
+        end
+        '[' + array_elements.join(',') + ']'
+      when String
+        if element.match(/^\s*function.*}\s*$/m)
+          # Raw-copy function definitions to the output without surrounding quotes.
+          element
+        else
+          element.to_json
+        end
+      when BigDecimal
+        element.to_s
+      else
+        element.to_json
+      end
+    end
+
+  end
+end