gruff 0.29.0-java → 0.31.0-java

data/lib/gruff/scatter.rb

@@ -31,6 +31,8 @@ class Gruff::Scatter < Gruff::Base
 
   # Allow enabling vertical lines. When you have a lot of data, they can work great.
   # @deprecated Please use {#show_vertical_markers=} instead.
+  # @rbs value: bool
+  # @rbs return: void
   def enable_vertical_line_markers=(value)
     warn '#enable_vertical_line_markers= is deprecated. Please use `show_vertical_markers` attribute instead'
     @show_vertical_markers = value
@@ -38,12 +40,16 @@ class Gruff::Scatter < Gruff::Base
 
   # Allow using vertical labels in the X axis.
   # @deprecated Please use {Gruff::Base#label_rotation=} instead.
+  # @rbs _value: untyped
+  # @rbs return: void
   def use_vertical_x_labels=(_value)
     warn '#use_vertical_x_labels= is deprecated. It is no longer effective. Please use `#label_rotation=` instead'
   end
 
   # Allow using vertical labels in the X axis (and setting the label margin).
   # @deprecated
+  # @rbs _value: untyped
+  # @rbs return: void
   def x_label_margin=(_value)
     warn '#x_label_margin= is deprecated. It is no longer effective.'
   end
@@ -51,6 +57,8 @@ class Gruff::Scatter < Gruff::Base
   # Allow disabling the significant rounding when labeling the X axis.
   # This is useful when working with a small range of high values (for example, a date range of months, while seconds as units).
   # @deprecated
+  # @rbs _value: untyped
+  # @rbs return: void
   def disable_significant_rounding_x_axis=(_value)
     warn '#disable_significant_rounding_x_axis= is deprecated. It is no longer effective.'
   end
@@ -93,6 +101,7 @@ class Gruff::Scatter < Gruff::Base
   # @rbs x_data_points: Array[nil | Float | Integer] | nil
   # @rbs y_data_points: Array[nil | Float | Integer] | nil
   # @rbs color: String
+  # @rbs return: void
   def data(name, x_data_points = [], y_data_points = [], color = nil)
     # make sure it's an array
     x_data_points = Array(x_data_points)
@@ -111,10 +120,12 @@ class Gruff::Scatter < Gruff::Base
 
 private
 
+  # @rbs return: void
   def initialize_store
     @store = Gruff::Store.new(Gruff::Store::XYData)
   end
 
+  # @rbs return: void
   def initialize_attributes
     super
 
@@ -125,11 +136,13 @@ private
     @stroke_width = nil
   end
 
+  # @rbs return: void
   def setup_drawing
     @center_labels_over_point = false
     super
   end
 
+  # @rbs return: void
   def setup_data
     # TODO: Need to get x-axis labels working. Current behavior will be to not allow.
     @labels = {}
@@ -147,6 +160,7 @@ private
     super
   end
 
+  # @rbs return: void
   def draw_graph
     stroke_width  = @stroke_width  || clip_value_if_greater_than(@columns / (store.norm_data.first.x_points.size * 4.0), 5.0)
     circle_radius = @circle_radius || clip_value_if_greater_than(@columns / (store.norm_data.first.x_points.size * 2.5), 5.0)
@@ -163,18 +177,21 @@ private
     end
   end
 
+  # @rbs return: void
   def calculate_spread
     super
     @x_spread = @maximum_x_value.to_f - @minimum_x_value.to_f
     @x_spread = @x_spread > 0 ? @x_spread : 1.0
   end
 
+  # @rbs return: void
   def normalize
     return unless data_given?
 
     store.normalize(minimum_x: @minimum_x_value, spread_x: @x_spread, minimum_y: minimum_value, spread_y: @spread)
   end
 
+  # @rbs return: void
   def draw_line_markers
     # do all of the stuff for the horizontal lines on the y-axis
     super

data/lib/gruff/side_bar.rb

@@ -55,12 +55,15 @@ class Gruff::SideBar < Gruff::Base
 
   # With Side Bars use the data label for the marker value to the left of the bar.
   # @deprecated
+  # @rbs _value: untyped
+  # @rbs return: void
   def use_data_label=(_value)
     warn '#use_data_label is deprecated. It is no longer effective.'
   end
 
 private
 
+  # @rbs return: void
   def initialize_attributes
     super
     @bar_spacing = 0.9
@@ -85,6 +88,7 @@ private
     @hide_line_markers && @x_axis_label.nil? && @legend_at_bottom == false
   end
 
+  # @rbs return: void
   def setup_graph_measurements
     super
     return if @hide_line_markers
@@ -105,6 +109,7 @@ private
     end
   end
 
+  # @rbs return: void
   def draw_graph
     # Setup spacing.
     #
@@ -148,6 +153,7 @@ private
   end
 
   # Instead of base class version, draws vertical background lines and label
+  # @rbs return: void
   def draw_line_markers
     return if @hide_line_markers
 
@@ -176,6 +182,9 @@ private
   ##
   # Draw on the Y axis instead of the X
 
+  # @rbs y_offset: Float | Integer
+  # @rbs index: Integer
+  # @rbs return: void
   def draw_label(y_offset, index)
     draw_unique_label(index) do
       draw_label_at(@graph_left - @label_margin, 1.0, 0.0, y_offset, @labels[index], gravity: Magick::EastGravity)

data/lib/gruff/side_stacked_bar.rb

@@ -52,6 +52,7 @@ class Gruff::SideStackedBar < Gruff::SideBar
 
 private
 
+  # @rbs return: void
   def initialize_attributes
     super
     @bar_spacing = 0.9
@@ -62,11 +63,13 @@ private
     @minimum_value = 0.0
   end
 
+  # @rbs return: void
   def setup_data
     calculate_maximum_by_stack
     super
   end
 
+  # @rbs return: void
   def draw_graph
     # Setup spacing.
     #

data/lib/gruff/spider.rb

@@ -30,12 +30,14 @@ class Gruff::Spider < Gruff::Base
   end
 
   # @rbs value: bool
+  # @rbs return: void
   def hide_text=(value)
     @hide_title = @hide_text = value
   end
 
 private
 
+  # @rbs return: void
   def initialize_attributes
     super
     @hide_legend = true
@@ -48,11 +50,13 @@ private
     @hide_line_markers.freeze
   end
 
+  # @rbs return: void
   def setup_drawing
     @center_labels_over_point = false
     super
   end
 
+  # @rbs return: void
   def setup_graph_measurements
     super
 
@@ -65,12 +69,14 @@ private
     @graph_height = @graph_bottom - @graph_top
   end
 
+  # @rbs return: void
   def setup_data
     raise(Gruff::IncorrectNumberOfDatasetsException, 'Requires 3 or more data sets') if store.length < 3
 
     super
   end
 
+  # @rbs return: void
   def draw_graph
     # Setup basic positioning
     radius = @graph_height / 2.0
@@ -88,11 +94,18 @@ private
     draw_polygon(center_x, center_y, additive_angle)
   end
 
-  # @rbs value: nil | Float | Integer
+  # @rbs value: Float | Integer
+  # @rbs return: Float
   def normalize_points(value)
-    value.to_f * @unit_length
+    (value.to_f * @unit_length).to_f
   end
 
+  # @rbs center_x: Float | Integer
+  # @rbs center_y: Float | Integer
+  # @rbs angle: Float | Integer
+  # @rbs radius: Float | Integer
+  # @rbs amount: Float | Integer
+  # @rbs return: void
   def draw_label(center_x, center_y, angle, radius, amount)
     degree = rad2deg(angle)
     metrics = text_metrics(@marker_font, amount)
@@ -118,6 +131,12 @@ private
     draw_label_at(metrics.width, metrics.height, x, y, amount, gravity: Magick::CenterGravity)
   end
 
+  # @rbs center_x: Float | Integer
+  # @rbs center_y: Float | Integer
+  # @rbs radius: Float | Integer
+  # @rbs additive_angle: Float | Integer
+  # @rbs line_color: String | nil
+  # @rbs return: void
   def draw_axes(center_x, center_y, radius, additive_angle, line_color = nil)
     return if @hide_axes
 
@@ -136,6 +155,11 @@ private
     end
   end
 
+  # @rbs center_x: Float | Integer
+  # @rbs center_y: Float | Integer
+  # @rbs additive_angle: Float | Integer
+  # @rbs color: String | nil
+  # @rbs return: void
   def draw_polygon(center_x, center_y, additive_angle, color = nil)
     points = []
     current_angle = deg2rad(@rotation)

data/lib/gruff/stacked_area.rb

@@ -18,22 +18,27 @@ class Gruff::StackedArea < Gruff::Base
   include Gruff::Base::StackedMixin
 
   # @deprecated
+  # @rbs _value: untyped
+  # @rbs return: void
   def last_series_goes_on_bottom=(_value)
     warn '#last_series_goes_on_bottom is deprecated. It is no longer effective.'
   end
 
 private
 
+  # @rbs return: void
   def initialize_attributes
     super
     @minimum_value = 0.0
   end
 
+  # @rbs return: void
   def setup_data
     calculate_maximum_by_stack
     super
   end
 
+  # @rbs return: void
   def draw_graph
     x_increment = (@graph_width / (column_count - 1)).to_f
 

data/lib/gruff/stacked_bar.rb

@@ -36,6 +36,7 @@ class Gruff::StackedBar < Gruff::Base
 
 private
 
+  # @rbs return: void
   def initialize_attributes
     super
     @bar_spacing = 0.9
@@ -46,6 +47,7 @@ private
     @minimum_value = 0.0
   end
 
+  # @rbs return: void
   def setup_drawing
     # Labels will be centered over the left of the bar if
     # there are more labels than columns. This is basically the same
@@ -55,11 +57,13 @@ private
     super
   end
 
+  # @rbs return: void
   def setup_data
     calculate_maximum_by_stack
     super
   end
 
+  # @rbs return: void
   def setup_graph_measurements
     super
     return if @hide_line_markers
@@ -75,6 +79,7 @@ private
   end
 
   # Draws a bar graph, but multiple sets are stacked on top of each other.
+  # @rbs return: void
   def draw_graph
     # Setup spacing.
     #

data/lib/gruff/store/basic_data.rb

@@ -13,6 +13,7 @@ module Gruff
       # @rbs label: String | Symbol
       # @rbs points: Array[nil | Float | Integer] | nil
       # @rbs color: String
+      # @rbs return: void
       def initialize(label, points, color)
         @label = label.to_s
         @points = Array(points)
@@ -21,14 +22,17 @@ module Gruff
 
       alias x_points points
 
+      # @rbs return: void
       def y_points
         raise NotImplementedError, 'x_points is not implemented for BasicData'
       end
 
+      # @rbs return: void
       def coordinates
         raise NotImplementedError, 'This method is not implemented for BasicData'
       end
 
+      # @rbs return: void
       def coordinate_and_pointsizes
         raise NotImplementedError, 'This method is not implemented for BasicData'
       end

data/lib/gruff/store/store.rb

@@ -7,12 +7,15 @@ module Gruff
   class Store
     attr_reader :data #: Array[Gruff::Store::BasicData | Gruff::Store::XYData | Gruff::Store::XYPointsizeData]
 
+    # @rbs data_class: untyped
     # @rbs return: void
     def initialize(data_class)
       @data_class = data_class
       @data = []
     end
 
+    # @rbs *args: untyped
+    # @rbs return: void
     def add(*args)
       @data << @data_class.new(*args)
     end
@@ -22,6 +25,8 @@ module Gruff
       @norm_data || []
     end
 
+    # @rbs **keywords: untyped
+    # @rbs return: untyped
     def normalize(**keywords)
       @norm_data = @data.map { |data_row| data_row.normalize(**keywords) } # steep:ignore
     end
@@ -63,10 +68,12 @@ module Gruff
       @max_x ||= @data.filter_map(&:max_x).max
     end
 
+    # @rbs return: void
     def sort_data!
       @data = @data.sort_by { |a| -a.points.sum(&:to_f) }
     end
 
+    # @rbs return: void
     def sort_norm_data!
       @norm_data = @norm_data.sort_by { |a| -a.points.sum(&:to_f) }
     end
@@ -77,6 +84,7 @@ module Gruff
     end
 
     # @rbs colors: Array[String]
+    # @rbs return: void
     def change_colors(colors)
       index = 0
       @data.each do |data_row|

data/lib/gruff/store/xy_data.rb

@@ -15,6 +15,7 @@ module Gruff
       # @rbs x_points: Array[nil | Float | Integer] | nil
       # @rbs y_points: Array[nil | Float | Integer] | nil
       # @rbs color: String
+      # @rbs return: void
       def initialize(label, x_points, y_points, color)
         y_points = Array(y_points)
         x_points = x_points ? Array(x_points) : Array.new(y_points.length)
@@ -33,6 +34,7 @@ module Gruff
         x_points.zip(y_points)
       end
 
+      # @rbs return: void
       def coordinate_and_pointsizes
         raise NotImplementedError, 'This method is not implemented for XYData'
       end

data/lib/gruff/store/xy_pointsizes_data.rb

@@ -17,6 +17,7 @@ module Gruff
       # @rbs y_points: Array[nil | Float | Integer] | nil
       # @rbs point_sizes: Array[nil | Float | Integer]
       # @rbs color: String
+      # @rbs return: void
       def initialize(label, x_points, y_points, point_sizes, color)
         y_points = Array(y_points)
         x_points = x_points ? Array(x_points) : Array.new(y_points.length)
@@ -32,6 +33,7 @@ module Gruff
 
       alias points y_points
 
+      # @rbs return: void
       def coordinates
         raise NotImplementedError, 'This method is not implemented for XYPointsizeData'
       end

data/lib/gruff/version.rb

@@ -3,5 +3,5 @@
 # rbs_inline: enabled
 
 module Gruff
-  VERSION = '0.29.0'
+  VERSION = '0.31.0'
 end

data/lib/gruff.rb

@@ -17,6 +17,8 @@ require_relative 'gruff/version'
 #
 module Gruff
   # @private
+  # @rbs path: String
+  # @rbs return: String
   def self.libpath(path)
     File.join(__dir__, 'gruff', path) # steep:ignore
   end

data/sig/generated/gruff/accumulator_bar.rbs

@@ -15,5 +15,6 @@
 class Gruff::AccumulatorBar < Gruff::StackedBar
   private
 
-  def setup_data: () -> untyped
+  # @rbs return: void
+  def setup_data: () -> void
 end

data/sig/generated/gruff/area.rbs

@@ -21,7 +21,9 @@ class Gruff::Area < Gruff::Base
 
   private
 
-  def initialize_attributes: () -> untyped
+  # @rbs return: void
+  def initialize_attributes: () -> void
 
-  def draw_graph: () -> untyped
+  # @rbs return: void
+  def draw_graph: () -> void
 end

data/sig/generated/gruff/bar.rbs

@@ -45,13 +45,16 @@ class Gruff::Bar < Gruff::Base
   # Default value is +0.9+.
   #
   # @rbs space_percent: Float | Integer
-  def spacing_factor=: (Float | Integer space_percent) -> untyped
+  # @rbs return: void
+  def spacing_factor=: (Float | Integer space_percent) -> void
 
   private
 
-  def initialize_attributes: () -> untyped
+  # @rbs return: void
+  def initialize_attributes: () -> void
 
-  def setup_drawing: () -> untyped
+  # @rbs return: void
+  def setup_drawing: () -> void
 
   # @rbs return: bool
   def hide_labels?: () -> bool
@@ -62,9 +65,11 @@ class Gruff::Bar < Gruff::Base
   # @rbs return: bool
   def hide_bottom_label_area?: () -> bool
 
-  def setup_graph_measurements: () -> untyped
+  # @rbs return: void
+  def setup_graph_measurements: () -> void
 
-  def draw_graph: () -> untyped
+  # @rbs return: void
+  def draw_graph: () -> void
 
   # @rbs return: Float | Integer
   def calculate_spacing: () -> (Float | Integer)