RubyGems - apexcharts - Versions diffs - 0.1.5 → 0.1.10 - Mend

apexcharts 0.1.5 → 0.1.10

Files changed (98) hide show

checksums.yaml +4 -4
data/README.md +456 -38
data/lib/apex_charts/charts.rb +16 -0
data/lib/{apexcharts/charts/area.rb → apex_charts/charts/area_chart.rb} +1 -1
data/lib/{apexcharts/charts/bar.rb → apex_charts/charts/bar_chart.rb} +1 -1
data/lib/apex_charts/charts/base_chart.rb +37 -0
data/lib/apex_charts/charts/bubble_chart.rb +13 -0
data/lib/{apexcharts/charts/candlestick.rb → apex_charts/charts/candlestick_chart.rb} +1 -1
data/lib/apex_charts/charts/cartesian_chart.rb +82 -0
data/lib/{apexcharts/charts/column.rb → apex_charts/charts/column_chart.rb} +3 -1
data/lib/{apexcharts/charts/donut.rb → apex_charts/charts/donut_chart.rb} +1 -2
data/lib/{apexcharts → apex_charts}/charts/features/annotations.rb +22 -21
data/lib/{apexcharts → apex_charts}/charts/features/mixable.rb +2 -3
data/lib/{apexcharts/charts/heatmap.rb → apex_charts/charts/heatmap_chart.rb} +3 -5
data/lib/{apexcharts/charts/line.rb → apex_charts/charts/line_chart.rb} +1 -1
data/lib/apex_charts/charts/mixed_charts.rb +101 -0
data/lib/{apexcharts/charts/pie.rb → apex_charts/charts/pie_chart.rb} +1 -2
data/lib/apex_charts/charts/polar_chart.rb +9 -0
data/lib/{apexcharts/charts/radar.rb → apex_charts/charts/radar_chart.rb} +3 -5
data/lib/{apexcharts/charts/radial_bar.rb → apex_charts/charts/radial_bar_chart.rb} +1 -2
data/lib/apex_charts/charts/range_bar_chart.rb +9 -0
data/lib/{apexcharts/charts/scatter.rb → apex_charts/charts/scatter_chart.rb} +1 -1
data/lib/apex_charts/charts/syncing_charts.rb +84 -0
data/lib/apex_charts/colors.rb +27 -0
data/lib/apex_charts/config/default_options.rb +16 -0
data/lib/apex_charts/configuration.rb +25 -0
data/lib/apex_charts/helper.rb +190 -0
data/lib/apex_charts/options/annotations_options.rb +15 -0
data/lib/apex_charts/options/chart_options.rb +32 -0
data/lib/apex_charts/options/data_labels_options.rb +18 -0
data/lib/apex_charts/options/div_attributes.rb +11 -0
data/lib/apex_charts/options/fill_options.rb +14 -0
data/lib/apex_charts/options/grid_options.rb +17 -0
data/lib/apex_charts/options/legend_options.rb +32 -0
data/lib/apex_charts/options/markers_options.rb +24 -0
data/lib/apex_charts/options/no_data_options.rb +14 -0
data/lib/apex_charts/options/plot_options.rb +16 -0
data/lib/apex_charts/options/root_options.rb +47 -0
data/lib/apex_charts/options/states_options.rb +11 -0
data/lib/apex_charts/options/stroke_options.rb +14 -0
data/lib/apex_charts/options/theme_options.rb +11 -0
data/lib/apex_charts/options/title_subtitle_options.rb +15 -0
data/lib/apex_charts/options/tooltip_options.rb +25 -0
data/lib/apex_charts/options/x_axis_options.rb +26 -0
data/lib/apex_charts/options/y_axis_options.rb +28 -0
data/lib/{apexcharts → apex_charts}/options_builder.rb +95 -90
data/lib/apex_charts/prefix_with_apex.rb +7 -0
data/lib/apex_charts/prefixer.rb +21 -0
data/lib/apex_charts/renderer.rb +113 -0
data/lib/apex_charts/series.rb +7 -0
data/lib/apex_charts/series/bubble_series.rb +50 -0
data/lib/apex_charts/series/cartesian_series.rb +81 -0
data/lib/apex_charts/series/polar_series.rb +48 -0
data/lib/{apexcharts → apex_charts}/support/rails.rb +1 -1
data/lib/apex_charts/support/sinatra.rb +9 -0
data/lib/apex_charts/theme.rb +60 -0
data/lib/{apexcharts → apex_charts}/utils.rb +1 -0
data/lib/apex_charts/utils/copy.rb +11 -0
data/lib/apex_charts/utils/date_time.rb +70 -0
data/lib/{apexcharts → apex_charts}/utils/hash.rb +4 -3
data/lib/{apexcharts → apex_charts}/version.rb +2 -1
data/lib/apexcharts.rb +3 -2
data/vendor/assets/javascripts/apexcharts.js +11 -3
metadata +85 -65
data/lib/apexcharts/charts.rb +0 -19
data/lib/apexcharts/charts/base.rb +0 -34
data/lib/apexcharts/charts/bubble.rb +0 -19
data/lib/apexcharts/charts/cartesian.rb +0 -81
data/lib/apexcharts/charts/mixed.rb +0 -85
data/lib/apexcharts/charts/polar.rb +0 -14
data/lib/apexcharts/charts/syncing.rb +0 -70
data/lib/apexcharts/helper.rb +0 -109
data/lib/apexcharts/options/annotations.rb +0 -10
data/lib/apexcharts/options/axis.rb +0 -17
data/lib/apexcharts/options/chart.rb +0 -26
data/lib/apexcharts/options/data_labels.rb +0 -12
data/lib/apexcharts/options/div_attributes.rb +0 -10
data/lib/apexcharts/options/fill.rb +0 -12
data/lib/apexcharts/options/grid.rb +0 -15
data/lib/apexcharts/options/legend.rb +0 -24
data/lib/apexcharts/options/markers.rb +0 -18
data/lib/apexcharts/options/no_data.rb +0 -12
data/lib/apexcharts/options/plot_options.rb +0 -12
data/lib/apexcharts/options/root.rb +0 -42
data/lib/apexcharts/options/states.rb +0 -9
data/lib/apexcharts/options/stroke.rb +0 -12
data/lib/apexcharts/options/subtitle.rb +0 -7
data/lib/apexcharts/options/theme.rb +0 -8
data/lib/apexcharts/options/title.rb +0 -13
data/lib/apexcharts/options/tooltip.rb +0 -22
data/lib/apexcharts/options/x_axis.rb +0 -12
data/lib/apexcharts/options/y_axis.rb +0 -15
data/lib/apexcharts/renderer.rb +0 -21
data/lib/apexcharts/series.rb +0 -5
data/lib/apexcharts/series/bubble.rb +0 -37
data/lib/apexcharts/series/cartesian.rb +0 -65
data/lib/apexcharts/series/polar.rb +0 -32
data/lib/apexcharts/utils/date_time.rb +0 -59

data/lib/apex_charts/prefix_with_apex.rb ADDED

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+require_relative 'configuration'
+ApexCharts.helper_prefix = 'apex_'
+require_relative '../apexcharts'

data/lib/apex_charts/prefixer.rb ADDED

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+module ApexCharts
+  module Prefixer
+    def self.extended(helper)
+      @@helper = helper
+    end
+    def with_prefix(&block)
+      @@prefixed = Module.new(&block)
+      unless [nil, ''].include? ApexCharts.helper_prefix
+        (@@prefixed.instance_methods - @@helper.instance_methods).each do |method|
+          @@prefixed.send(:alias_method, "#{ApexCharts.helper_prefix}#{method}", method)
+          @@prefixed.send(:remove_method, method)
+        end
+      end
+      @@helper.send(:include, @@prefixed)
+    end
+  end
+end

data/lib/apex_charts/renderer.rb ADDED

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+require 'json'
+require_relative 'version'
+module ApexCharts
+  class Renderer
+    class << self
+      def render(options)
+        new(options).render
+      end
+    end
+    attr_reader :options
+    def initialize(options)
+      @options = options
+    end
+    def render
+      html = ''
+      html = window_apex if id_number == '1' && !ApexCharts.config.default_options.empty?
+      chart_rendering = <<~JS
+        var #{variable} = new ApexCharts(document.querySelector("##{element_id}"), #{substitute_function_object(options.to_json)});
+        #{variable}.render();
+      JS
+      html += <<~HTML
+        <div id="#{element_id}" class="#{css_class}" style="#{style}"></div>
+        #{script(defer(chart_rendering))}
+      HTML
+    end
+    def defer(js)
+      if defer?
+        <<~DEFERRED
+          (function() {
+            var createChart = function() {
+              #{indent(js)}
+            };
+            if (window.addEventListener) {
+              window.addEventListener("load", createChart, true);
+            } else if (window.attachEvent) {
+              window.attachEvent("onload", createChart);
+            } else {
+              createChart();
+            }
+          })();
+        DEFERRED
+      else
+        js
+      end
+    end
+    def substitute_function_object(json)
+      json.gsub(%r[{"function":{"args":"(?<args>.*?)","body":"(?<body>.*?)"}}]) do
+        body = "\"#{$~&.[](:body)}\"".undump
+        "function(#{$~&.[](:args)}){#{body}}"
+      end
+    end
+    def defer?
+      @defer ||= options.delete(:defer)
+    end
+    def attributes
+      @attributes ||= options.delete(:div) { {} }
+    end
+    def element_id
+      @element_id ||= attributes.delete(:id)
+    end
+    def id_number
+      @id_number ||= element_id&.[](/\d+/)
+    end
+    def variable
+      @variable ||= attributes.delete(:var) { "chart#{id_number}" }
+    end
+    def css_class
+      attributes.delete(:class)
+    end
+    def height
+      "#{options[:chart][:height].to_i}px"
+    end
+    def style
+      "height: #{height}; #{attributes.delete(:style)}"
+    end
+    def window_apex
+      script("window.Apex = #{ApexCharts.config.default_options.to_json}")
+    end
+    def script(js)
+      <<~SCRIPT
+        <script type="text/javascript" apexcharts-rb="#{RELEASE}">
+        #{js}
+        </script>
+      SCRIPT
+    end
+    def indent(content, times=2)
+      content.lines.map.with_index do |line, index|
+        (index == 0 ? '' : '  ' * times) + line
+      end.join
+    end
+  end
+end

data/lib/apex_charts/series.rb ADDED

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+module ApexCharts::Series
+  %w[cartesian bubble polar].each do |type|
+    autoload :"#{type.capitalize}Series", "apex_charts/series/#{type}_series.rb"
+  end
+end

data/lib/apex_charts/series/bubble_series.rb ADDED

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+require_relative '../utils/copy'
+module ApexCharts::Series
+  class BubbleSeries
+    include ApexCharts::Utils::Copy
+    attr_reader :sanitized
+    def initialize(data)
+      data = deep_copy(data)
+      sanitized =
+        case data
+        when Array
+          if array_of_threes?(data)
+            [{data: data}]
+          else
+            data
+          end
+        when Hash
+          if data_value = data[:data]
+            [data] if array_of_threes?(data_value)
+          end
+        end
+      @sanitized = {series: sanitized}
+    end
+    def sample
+      return if empty?
+      sanitized[:series][0][:data][0]
+    end
+  private
+    def empty?
+      sanitized[:series].empty? || sanitized[:series][0][:data].empty?
+    end
+    def array_of_threes?(data)
+      return false if data.empty?
+      data.all? {|d| d.length == 3 }
+    end
+  end
+end

data/lib/apex_charts/series/cartesian_series.rb ADDED

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+require_relative '../utils/copy'
+module ApexCharts::Series
+  class CartesianSeries
+    include ApexCharts::Utils::Copy
+    attr_reader :sanitized
+    def initialize(data)
+      @sanitized = {series: build_series(deep_copy(data))}
+    end
+    def sample
+      return if empty?
+      sanitized[:series][0][:data][0][:x]
+    end
+  private
+    def empty?
+      sanitized[:series].empty? || sanitized[:series][0][:data].empty?
+    end
+    def build_series(data)
+      return data if data.empty?
+      case data
+      when Array
+        build_series_from_array(data)
+      when Hash
+        build_series_from_hash(data)
+      end
+    end
+    def build_series_from_array(data)
+      case first_data = data[0]
+      when Array
+        [{data: array_of_array_to_array_of_xy(data)}]
+      when Hash
+        if first_data[:data]
+          data.each {|h| h[:data] = array_of_array_to_array_of_xy(h[:data]) }
+          data
+        end
+      end
+    end
+    def build_series_from_hash(data)
+      if data_value = data[:data]
+        if array_of_pairs?(data_value)
+          data[:data] = array_of_array_to_array_of_xy(data_value)
+          [data]
+        end
+      elsif data[:x] && data[:y]
+        [{data: [data]}]
+      else
+        [
+          {
+            data: data.map do |key, value|
+              {x: key, y: value}
+            end
+          }
+        ]
+      end
+    end
+    def array_of_pairs?(data)
+      !data.empty? && data.all? {|d| d.length == 2 }
+    end
+    def array_of_array_to_array_of_xy(data)
+      data.map {|d| {x: d.first, y: d.last} }
+    end
+  end
+end

data/lib/apex_charts/series/polar_series.rb ADDED

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+require_relative '../utils/copy'
+module ApexCharts::Series
+  class PolarSeries
+    include ApexCharts::Utils::Copy
+    attr_reader :sanitized
+    def initialize(data)
+      build_labels_and_series(deep_copy(data))
+      @sanitized = {
+        labels: @labels.empty? ? nil : @labels,
+        series: @series
+      }.compact
+    end
+    def sample
+      return if empty?
+      sanitized[:series][0]
+    end
+  private
+    def empty?
+      sanitized[:series].nil? || sanitized[:series][0].nil?
+    end
+    def build_labels_and_series(data)
+      @labels = []
+      case data
+      when Array
+        case data.first
+        when Numeric
+          @series = data
+        when Hash
+          @labels = data.map {|m| m[:name] }.compact
+          @series = data.map {|m| m[:data] }
+        end
+      when Hash
+        @series = data[:data] if data[:data].is_a? Array
+      end
+    end
+  end
+end

data/lib/{apexcharts → apex_charts}/support/rails.rb RENAMED

@@ -2,7 +2,7 @@
 module ApexCharts
   class Engine < ::Rails::Engine
-    initializer "helper" do |app|
+    initializer 'helper' do
       ActiveSupport.on_load(:action_view) do
         include Helper
       end

data/lib/apex_charts/support/sinatra.rb ADDED

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+module Sinatra
+  module ApexCharts
+    include ::ApexCharts::Helper
+  end
+  helpers ApexCharts
+end

data/lib/apex_charts/theme.rb ADDED

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+require_relative 'colors'
+module ApexCharts
+  class Theme
+    PALETTES = %w[palette1 palette2 palette3 palette4 palette5
+                  palette6 palette7 palette8 palette9 palette10].freeze
+    @custom_palettes = {}
+    module ClassMethods
+      def create(palette_name, colors)
+        palettes[palette_name] = Colors.new colors
+      end
+      def destroy(palette_name)
+        palettes.delete palette_name
+      end
+      def get_colors(palette_name)
+        custom_palettes[palette_name]&.values
+      end
+      def palette_names
+        custom_palettes.keys
+      end
+      def all_palettes
+        PALETTES + palette_names
+      end
+      def custom_palettes
+        palettes
+      end
+      def palettes
+        @custom_palettes
+      end
+    end
+    class Local
+      module LocalClassMethods
+        include ClassMethods
+        def custom_palettes
+          Theme.palettes.merge(super)
+        end
+        def palettes
+          Thread.current[:_ApexCharts_Palettes_] ||= {}
+        end
+      end
+      extend LocalClassMethods
+    end
+    extend ClassMethods
+  end
+end

data/lib/{apexcharts → apex_charts}/utils.rb RENAMED

@@ -2,3 +2,4 @@
 require_relative 'utils/date_time'
 require_relative 'utils/hash'
+require_relative 'utils/copy'

data/lib/apex_charts/utils/copy.rb ADDED

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+module ApexCharts
+  module Utils
+    module Copy
+      def deep_copy(data)
+        Marshal.load(Marshal.dump(data))
+      end
+    end
+  end
+end

data/lib/apex_charts/utils/date_time.rb ADDED

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+require 'date'
+module ApexCharts
+  module Utils
+    module DateTime
+    module_function
+      def convert(input)
+        case input
+        when Time
+          (input.to_f * 1000).round
+        when ::DateTime, Date
+          (input.to_time.to_f * 1000).round
+        else
+          if (dt = ::DateTime.iso8601(input)).iso8601 == input
+            (dt.to_time.to_f * 1000).round
+          elsif (d = Date.iso8601(input)).iso8601 == input
+            (d.to_time.to_f * 1000).round
+          end
+        end
+      rescue StandardError
+        input
+      end
+      def convert_range(input)
+        input_first, input_last = input.first, input.last
+        case input_first
+        when Time
+          to_milliseconds_range(input_first, input_last)
+        when ::DateTime, Date
+          to_milliseconds_range(input_first.to_time, input_last.to_time)
+        else
+          if (datetime = ::DateTime.iso8601(input_first)).iso8601 == input_first
+            to_milliseconds_range(datetime.to_time, ::DateTime.iso8601(input_last).to_time)
+          elsif (date = Date.iso8601(input.first)).iso8601 == input_first
+            to_milliseconds_range(date.to_time, ::Date.iso8601(input_last).to_time)
+          end
+        end
+      rescue StandardError
+        input
+      end
+      def to_milliseconds(input)
+        (input.to_f * 1000).round
+      end
+      def to_milliseconds_range(first, last)
+        to_milliseconds(first)..to_milliseconds(last)
+      end
+      def type(input)
+        case input
+        when Time, ::DateTime, Date
+          'datetime'
+        else
+          if [
+            ::DateTime.iso8601(input).iso8601,
+            Date.iso8601(input).iso8601
+          ].include? input
+            'datetime'
+          end
+        end
+      rescue StandardError
+        nil
+      end
+    end
+  end
+end