prawn_charts 0.0.1

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/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 MrPowers
+
+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,51 @@
+[![Code Climate](https://codeclimate.com/github/MrPowers/prawn_charts.png)](https://codeclimate.com/github/MrPowers/prawn_charts)
+
+# Prawn Charts
+
+Prawn Charts is a Prawn graphing library to create linear or log line
+charts in Prawn with no dependencies other than Prawn.
+
+## Examples
+
+Clone the respository and run the following script to generate a PDF
+file with a log graph on your Desktop:
+```bash
+$ ruby lib/examples/log_example.rb
+```
+
+This script will generate a PDF file of a log graph that is only 6KB.
+
+![alt tag](https://raw.github.com/MrPowers/prawn_charts/master/images/prawn_charts_log_example.png)
+
+
+Prawn Charts can also be used to generate linear graphs.  This graph
+does not leverage built in features (i.e. graph title, y label, x label)
+and demonstrates that Prawn Charts is easily customizable.
+
+![alt tag](https://raw.github.com/MrPowers/prawn_charts/master/images/simple_linear_example.png)
+
+## Code Organization
+
+The DataCollectors (located in lib/data_collectors) are responsible for
+manipulating input data in a format suitable for the PrawnChartRenderer.  The
+PrawnChartRenderer module should be mixed in to Prawn::Document, so the
+renderer methods can be called directly on the Prawn::Document object.  
+
+This example code shows how to use the PdfDataCollector to get formatted
+data that can be passed to the draw_chart() and draw_dots() methods:
+
+```ruby
+Prawn::Document.extensions << PrawnChartRenderer
+
+pdf = Prawn::Document.new
+pdf.bounding_box([50, pdf.cursor], :width => graph_width_pdf, :height => graph_height_pdf) do
+  pdf.stroke_bounds
+
+  pdf_data = PdfDataCollector.new(scale, input_data, graph_width_pdf, graph_height_pdf, y_labels).collect
+  pdf.draw_chart(pdf_data)
+  pdf.draw_dots(pdf_data, dot_radius)
+end
+```
+
+There are separate methods to draw_chart(), draw_dots(), draw_labels(),
+draw_horizontal_lines(), and draw titles, so the charts can be customized.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/data_collectors/container/container_data_collector.rb

@@ -0,0 +1,57 @@
+class ContainerDataCollector
+  attr_reader :inputs
+  def initialize(inputs)
+    @inputs = inputs
+  end
+
+  def height
+    bottom_gap +
+    inputs[:graph_height] +
+    top_gap
+  end
+
+  def width
+    left_gap + right_gap + inputs[:graph_width]
+  end
+
+  def graph_top_left
+    [left_gap, (height - top_gap)]
+  end
+
+  def graph_title_top_left
+    [left_gap, (bottom_gap + inputs[:graph_height] + inputs[:graph_title_height])]
+  end
+
+  def y_title_top_left
+    [inputs[:container_left_padding], (bottom_gap + inputs[:graph_height])]
+  end
+
+  def x_title_top_left
+    [left_gap, (inputs[:container_bottom_padding] + inputs[:x_title_height])]
+  end
+
+  private
+
+  # gap is area between container edge and graph
+  def left_gap
+    inputs[:container_left_padding] +
+    inputs[:y_label_width] +
+    inputs[:y_label_offset] +
+    inputs[:y_title_width]
+  end
+
+  def right_gap
+    inputs[:container_right_padding]
+  end
+
+  def top_gap
+    inputs[:container_top_padding] +
+    inputs[:graph_title_height]
+  end
+
+  def bottom_gap
+    inputs[:container_bottom_padding] +
+    inputs[:x_label_height] +
+    inputs[:x_title_height]
+  end
+end

data/lib/data_collectors/container/graph_title_data_collector.rb

@@ -0,0 +1,13 @@
+class GraphTitleDataCollector
+  attr_reader :graph_title, :position, :graph_title_height, :graph_title_width
+  def initialize(graph_title, position, graph_title_height, graph_title_width)
+    @graph_title = graph_title
+    @position = position
+    @graph_title_height = graph_title_height
+    @graph_title_width = graph_title_width
+  end
+
+  def collect
+    { title: graph_title, at: position, height: graph_title_height, width: graph_title_width }
+  end
+end

data/lib/data_collectors/graph/horizontal_lines_data_collector.rb

@@ -0,0 +1,20 @@
+class HorizontalLinesDataCollector
+  attr_reader :graph_height_pdf, :graph_width_pdf, :y_labels
+  def initialize(graph_height_pdf, graph_width_pdf, y_labels)
+    @graph_height_pdf = graph_height_pdf
+    @graph_width_pdf = graph_width_pdf
+    @y_labels = y_labels
+  end
+
+  def collect
+    y_labels.map.with_index do |_, index|
+      [0, graph_width_pdf, index * y_label_increment]
+    end
+  end
+
+  private
+
+  def y_label_increment
+    graph_height_pdf.to_f / (y_labels.count - 1)
+  end
+end

data/lib/data_collectors/graph/linear_y_pdf_data_collector.rb

@@ -0,0 +1,21 @@
+class LinearYPdfDataCollector
+  attr_reader :input_data, :graph_height_pdf, :y_labels
+  def initialize(input_data, graph_height_pdf, y_labels)
+    @input_data = input_data
+    @graph_height_pdf = graph_height_pdf
+    @y_labels = y_labels
+  end
+
+  def collect
+    input_data.inject([]) do |memo, (_, y_units)|
+      result = y_units.nil? ? nil : y_units * pdf_points_per_unit
+      memo << result
+    end
+  end
+
+  private
+
+  def pdf_points_per_unit
+    graph_height_pdf.to_f / y_labels.max
+  end
+end

data/lib/data_collectors/graph/log_y_pdf_data_collector.rb

@@ -0,0 +1,19 @@
+class LogYPdfDataCollector
+  attr_reader :input_data, :graph_height_pdf, :y_labels
+  def initialize(input_data, graph_height_pdf, y_labels)
+    @input_data = input_data
+    @graph_height_pdf = graph_height_pdf
+    @y_labels = y_labels
+  end
+
+  def pdf_points_per_unit
+    graph_height_pdf.to_f / (y_labels.count - 1)
+  end
+
+  def collect
+    input_data.inject([]) do |memo, (_, y_units)|
+      result = y_units.nil? ? nil : (Math.log10(y_units) * pdf_points_per_unit)
+      memo << result
+    end
+  end
+end

data/lib/data_collectors/graph/pdf_data_collector.rb

@@ -0,0 +1,24 @@
+class PdfDataCollector
+  attr_reader :scale, :input_data, :graph_width_pdf, :graph_height_pdf, :y_labels
+  def initialize(scale, input_data, graph_width_pdf, graph_height_pdf, y_labels)
+    @scale = scale
+    @input_data = input_data
+    @graph_width_pdf = graph_width_pdf
+    @graph_height_pdf = graph_height_pdf
+    @y_labels = y_labels
+  end
+
+  def collect
+    x_pdf_data.zip(y_pdf_data).select { |x, y| [x, y] unless y.nil? }
+  end
+
+  private
+
+  def x_pdf_data
+    XPdfDataCollector.new(input_data, graph_width_pdf).collect
+  end
+
+  def y_pdf_data
+    YPdfDataCollector.new(scale, input_data, graph_height_pdf, y_labels).collect
+  end
+end

data/lib/data_collectors/graph/x_labels_data_collector.rb

@@ -0,0 +1,27 @@
+class XLabelsDataCollector
+  attr_reader :input_data, :graph_width_pdf, :label_height, :label_width
+  def initialize(input_data, graph_width_pdf, label_height, label_width)
+    @input_data = input_data
+    @graph_width_pdf = graph_width_pdf
+    @label_height = label_height
+    @label_width = label_width
+  end
+
+  def horizontal_offset
+    label_width / 2
+  end
+
+  def collect
+    input_data.map.with_index do |(label, _), index|
+      x_pdf = x_pdf_data[index] - horizontal_offset
+      y_pdf = -(label_height)
+      [label, [x_pdf, y_pdf] ]
+    end
+  end
+
+  private
+
+  def x_pdf_data
+    XPdfDataCollector.new(input_data, graph_width_pdf).collect
+  end
+end

data/lib/data_collectors/graph/x_pdf_data_collector.rb

@@ -0,0 +1,14 @@
+class XPdfDataCollector
+  def initialize(input_data, graph_width_pdf)
+    @input_data = input_data
+    @graph_width_pdf = graph_width_pdf
+  end
+
+  def pdf_points_per_unit
+    @graph_width_pdf.to_f / (@input_data.length - 1)
+  end
+
+  def collect
+    0.step(@graph_width_pdf, pdf_points_per_unit).to_a
+  end
+end

data/lib/data_collectors/graph/y_labels_data_collector.rb

@@ -0,0 +1,33 @@
+class YLabelsDataCollector
+  attr_reader :y_labels, :graph_height_pdf, :label_width, :label_height, :y_label_offset
+  def initialize(y_labels, graph_height_pdf, label_width, label_height, y_label_offset)
+    @y_labels = y_labels
+    @graph_height_pdf = graph_height_pdf
+    @label_width = label_width
+    @label_height = label_height
+    @y_label_offset = y_label_offset
+  end
+
+  def collect
+    y_labels.map.with_index do |y_label, index|
+      y_label = number_to_string_with_commas(y_label)
+      x_pdf = -label_width - y_label_offset
+      y_pdf = index * y_label_increment + vertical_offset
+      [y_label, [x_pdf, y_pdf]]
+    end
+  end
+
+  private
+
+  def vertical_offset
+    label_height / 2
+  end
+
+  def y_label_increment
+    graph_height_pdf.to_f / (y_labels.count - 1)
+  end
+
+  def number_to_string_with_commas(number)
+    number.to_s.reverse.gsub(/(\d{3})(?=\d)/, '\\1,').reverse
+  end
+end

data/lib/data_collectors/graph/y_pdf_data_collector.rb

@@ -0,0 +1,19 @@
+class YPdfDataCollector
+  attr_reader :scale, :input_data, :graph_height_pdf, :y_labels
+  def initialize(scale, input_data, graph_height_pdf, y_labels)
+    @scale = scale
+    @input_data = input_data
+    @graph_height_pdf = graph_height_pdf
+    @y_labels = y_labels
+  end
+
+  def collect
+    if scale == :linear
+      LinearYPdfDataCollector.new(input_data, graph_height_pdf, y_labels).collect
+    elsif scale == :log
+      LogYPdfDataCollector.new(input_data, graph_height_pdf, y_labels).collect
+    else
+      raise("Scale must be :linear or :log")
+    end
+  end
+end

data/lib/examples/log_example.rb

@@ -0,0 +1,131 @@
+require_relative "./../prawn_charts"
+
+##################################
+#Graph Data Collectors
+##################################
+input_data = [["Apr-11", 5_000_000],
+              ["May-11", nil],
+              ["Jun-11", nil],
+              ["Jul-11", nil],
+              ["Aug-11", 1_000_000],
+              ["Sep-11", nil],
+              ["Oct-11", nil],
+              ["Dec-11", 10_000],
+              ["Jan-12", nil],
+              ["Feb-12", nil],
+              ["Mar-12", 150_000],
+              ["Apr-12", nil],
+              ["May-12", nil],
+              ["Jun-12", 7_500_000]]
+scale = :log
+graph_height_pdf = 200
+graph_width_pdf = graph_height_pdf * 1.7
+dot_radius = 4
+
+x_label_width = 50
+x_label_height = 35
+x_label_text_box_options = { overflow: :shrink_to_fit, align: :center, rotate: 45 }
+
+y_labels = [0, 10, 100, 1_000, 10_000, 100_000, 1_000_000, 10_000_000]
+y_label_height = 30
+y_label_width = 65
+y_label_offset = 10
+y_label_text_box_options = { align: :right, valign: :center }
+
+graph_title_text = "Cool Prawn Graph"
+graph_title_height = 40
+
+y_title_width = 30
+y_title_text = "HCV Viral Load"
+
+x_title_height = 40
+x_title_text = "Month"
+
+pdf_data = PdfDataCollector.new(scale, input_data, graph_width_pdf, graph_height_pdf, y_labels).collect
+x_label_data = XLabelsDataCollector.new(input_data, graph_width_pdf, x_label_height, x_label_width).collect
+y_label_data = YLabelsDataCollector.new(y_labels, graph_height_pdf, y_label_width, y_label_height, y_label_offset).collect
+horizontal_lines_data = HorizontalLinesDataCollector.new(graph_height_pdf, graph_width_pdf, y_labels).collect
+
+##################################
+#Container Data Collectors
+##################################
+
+container_inputs = {
+  container_left_padding: 0,
+  y_label_offset: y_label_offset,
+  y_label_width: y_label_width,
+  y_title_width: y_title_width,
+  container_right_padding: 20,
+  container_top_padding: 20,
+  graph_title_height: graph_title_height,
+  container_bottom_padding: 0,
+  x_label_height: x_label_height,
+  x_title_height: x_title_height,
+  graph_height: graph_height_pdf,
+  graph_width: graph_width_pdf
+}
+
+container_data_collector = ContainerDataCollector.new(container_inputs)
+
+graph_title_position = container_data_collector.graph_title_top_left
+graph_title_options = { align: :center, valign: :center}
+graph_title_data = GraphTitleDataCollector.new(graph_title_text, graph_title_position, graph_title_height, graph_width_pdf).collect
+
+y_title_position = container_data_collector.y_title_top_left
+# specifying width is a temp hack solution because of a Prawn bug: https://github.com/prawnpdf/prawn/pull/505
+y_title_options = { align: :center, valign: :center, rotate: 90, rotate_around: :center, width: 65 }
+y_title_data = GraphTitleDataCollector.new(y_title_text, y_title_position, graph_height_pdf, y_title_width).collect
+
+x_title_position = container_data_collector.x_title_top_left
+x_title_options = { align: :center, valign: :center }
+x_title_data = GraphTitleDataCollector.new(x_title_text, x_title_position, x_title_height, graph_width_pdf).collect
+
+graph_top_left = container_data_collector.graph_top_left
+
+##################################
+#Colors
+##################################
+
+orange = "D95D2E"
+green = "62C545"
+light_blue = "EDF1F7"
+white = "FFFFFF"
+black = "000000"
+
+##################################
+#Create PDF
+##################################
+
+Prawn::Document.extensions << PrawnChartRenderer
+
+pdf = Prawn::Document.new
+pdf.bounding_box([0, pdf.cursor], :width => container_data_collector.width, :height => container_data_collector.height) do
+  pdf.stroke_bounds
+  pdf.fill_color = light_blue
+  pdf.fill_rectangle([0, pdf.cursor], container_data_collector.width, container_data_collector.height)
+  pdf.fill_color = black
+
+  pdf.draw_title(graph_title_data, graph_title_options)
+  pdf.draw_title(y_title_data, y_title_options)
+  pdf.draw_title(x_title_data, x_title_options)
+
+  pdf.bounding_box(container_data_collector.graph_top_left, :width => graph_width_pdf, :height => graph_height_pdf) do
+    pdf.stroke_bounds
+    pdf.fill_color = white
+    pdf.fill_rectangle([0, pdf.cursor], graph_width_pdf, graph_height_pdf)
+
+    pdf.stroke_color = green
+    pdf.draw_chart(pdf_data)
+    pdf.fill_color = orange
+    pdf.draw_dots(pdf_data, dot_radius)
+
+    pdf.fill_color = black
+    pdf.draw_labels(x_label_data, x_label_width, x_label_height, x_label_text_box_options)
+
+    pdf.draw_labels(y_label_data, y_label_width, y_label_height, y_label_text_box_options)
+
+    pdf.stroke_color = black
+    pdf.draw_horizontal_lines(horizontal_lines_data)
+  end
+end
+pdf.render_file(Dir.home + "/desktop/log_prawn_graph.pdf")

data/lib/examples/simple_linear_example.rb

@@ -0,0 +1,57 @@
+require_relative "./../prawn_charts"
+
+##################################
+#Graph Data Collectors
+##################################
+input_data = [["Apr-11", 10],
+              ["May-11", 30],
+              ["Jun-11", 50],
+              ["Jul-11", 3],
+              ["Aug-11", 40],
+              ["Sep-11", nil],
+              ["Oct-11", nil],
+              ["Dec-11", 100],
+              ["Jan-12", nil],
+              ["Feb-12", nil],
+              ["Mar-12", 5],
+              ["Apr-12", nil],
+              ["May-12", nil],
+              ["Jun-12", 75]]
+scale = :linear
+graph_height_pdf = 200
+graph_width_pdf = graph_height_pdf * 1.7
+dot_radius = 4
+
+x_label_width = 50
+x_label_height = 35
+x_label_text_box_options = { overflow: :shrink_to_fit, align: :center, rotate: 45 }
+
+y_labels = [0, 25, 50, 75, 100, 125]
+y_label_height = 30
+y_label_width = 65
+y_label_offset = 10
+y_label_text_box_options = { align: :right, valign: :center }
+
+pdf_data = PdfDataCollector.new(scale, input_data, graph_width_pdf, graph_height_pdf, y_labels).collect
+x_label_data = XLabelsDataCollector.new(input_data, graph_width_pdf, x_label_height, x_label_width).collect
+y_label_data = YLabelsDataCollector.new(y_labels, graph_height_pdf, y_label_width, y_label_height, y_label_offset).collect
+horizontal_lines_data = HorizontalLinesDataCollector.new(graph_height_pdf, graph_width_pdf, y_labels).collect
+
+##################################
+#Create PDF
+##################################
+
+Prawn::Document.extensions << PrawnChartRenderer
+
+pdf = Prawn::Document.new
+
+pdf.bounding_box([50, pdf.cursor], :width => graph_width_pdf, :height => graph_height_pdf) do
+  pdf.stroke_bounds
+  pdf.draw_chart(pdf_data)
+  pdf.draw_dots(pdf_data, dot_radius)
+  pdf.draw_labels(x_label_data, x_label_width, x_label_height, x_label_text_box_options)
+  pdf.draw_labels(y_label_data, y_label_width, y_label_height, y_label_text_box_options)
+  pdf.draw_horizontal_lines(horizontal_lines_data)
+end
+
+pdf.render_file(Dir.home + "/desktop/simple_linear_prawn_graph.pdf")

data/lib/examples/simple_log_example.rb

@@ -0,0 +1,57 @@
+require_relative "./../prawn_charts"
+
+##################################
+#Graph Data Collectors
+##################################
+input_data = [["Apr-11", 5_000_000],
+              ["May-11", nil],
+              ["Jun-11", nil],
+              ["Jul-11", nil],
+              ["Aug-11", 1_000_000],
+              ["Sep-11", nil],
+              ["Oct-11", nil],
+              ["Dec-11", 10_000],
+              ["Jan-12", nil],
+              ["Feb-12", nil],
+              ["Mar-12", 150_000],
+              ["Apr-12", nil],
+              ["May-12", nil],
+              ["Jun-12", 7_500_000]]
+scale = :log
+graph_height_pdf = 200
+graph_width_pdf = graph_height_pdf * 1.7
+dot_radius = 4
+
+x_label_width = 50
+x_label_height = 35
+x_label_text_box_options = { overflow: :shrink_to_fit, align: :center, rotate: 45 }
+
+y_labels = [0, 10, 100, 1_000, 10_000, 100_000, 1_000_000, 10_000_000]
+y_label_height = 30
+y_label_width = 65
+y_label_offset = 10
+y_label_text_box_options = { align: :right, valign: :center }
+
+pdf_data = PdfDataCollector.new(scale, input_data, graph_width_pdf, graph_height_pdf, y_labels).collect
+x_label_data = XLabelsDataCollector.new(input_data, graph_width_pdf, x_label_height, x_label_width).collect
+y_label_data = YLabelsDataCollector.new(y_labels, graph_height_pdf, y_label_width, y_label_height, y_label_offset).collect
+horizontal_lines_data = HorizontalLinesDataCollector.new(graph_height_pdf, graph_width_pdf, y_labels).collect
+
+##################################
+#Create PDF
+##################################
+
+Prawn::Document.extensions << PrawnChartRenderer
+
+pdf = Prawn::Document.new
+
+pdf.bounding_box([50, pdf.cursor], :width => graph_width_pdf, :height => graph_height_pdf) do
+  pdf.stroke_bounds
+  pdf.draw_chart(pdf_data)
+  pdf.draw_dots(pdf_data, dot_radius)
+  pdf.draw_labels(x_label_data, x_label_width, x_label_height, x_label_text_box_options)
+  pdf.draw_labels(y_label_data, y_label_width, y_label_height, y_label_text_box_options)
+  pdf.draw_horizontal_lines(horizontal_lines_data)
+end
+
+pdf.render_file(Dir.home + "/desktop/simple_log_prawn_graph.pdf")

data/lib/prawn_charts/version.rb

@@ -0,0 +1,3 @@
+module PrawnCharts
+  VERSION = "0.0.1"
+end

data/lib/prawn_charts.rb

@@ -0,0 +1,8 @@
+require 'prawn'
+require_relative "./prawn_charts/version"
+
+Dir["./lib/data_collectors/**/*.rb"].each {|file| require file }
+Dir["./lib/renderers/**/*.rb"].each {|file| require file }
+
+module PrawnCharts
+end

data/lib/renderers/prawn_chart_renderer.rb

@@ -0,0 +1,29 @@
+module PrawnChartRenderer
+  def draw_chart(pdf_data)
+    pdf_data.each_index do |i|
+      stroke_line(pdf_data[i], pdf_data[i + 1]) unless pdf_data[i + 1].nil?
+    end
+  end
+
+  def draw_dots(pdf_data, dot_radius)
+    pdf_data.each do |point|
+      fill_circle(point, dot_radius)
+    end
+  end
+
+  def draw_horizontal_lines(horizontal_lines_data)
+    horizontal_lines_data.each do |start_x, end_x, y|
+      stroke_horizontal_line start_x, end_x, at: y
+    end
+  end
+
+  def draw_labels(label_data, width, height, options = {})
+    label_data.each do |label, pdf_point|
+      text_box(label, { at: pdf_point, width: width, height: height }.merge(options))
+    end
+  end
+
+  def draw_title(inputs, options = {})
+    text_box(inputs[:title], { at: inputs[:at], width: inputs[:width], height: inputs[:height] }.merge(options))
+  end
+end

data/prawn_charts.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'prawn_charts/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "prawn_charts"
+  gem.version       = PrawnCharts::VERSION
+  gem.authors       = ["MrPowers"]
+  gem.email         = ["matthewkevinpowers@gmail.com"]
+  gem.description   = %q{Library to create line graphs in Prawn}
+  gem.summary       = %q{Library to create line graphs in Prawn}
+  gem.homepage      = ""
+
+  gem.add_dependency "prawn"
+  gem.add_development_dependency "rspec"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+end

data/spec/data_collectors/container/container_data_collector_spec.rb

@@ -0,0 +1,57 @@
+require "spec_helper"
+
+describe ContainerDataCollector do
+  before do
+    container_inputs = {
+      container_left_padding: 7,
+      y_label_offset: 50,
+      y_label_width: 25,
+      y_title_width: 30,
+      container_right_padding: 20,
+      container_top_padding: 9,
+      graph_title_height: 25,
+      container_bottom_padding: 40,
+      x_label_height: 22,
+      x_title_height: 43,
+      graph_height: 400,
+      graph_width: 500
+    }
+    @container_data_collector = ContainerDataCollector.new(container_inputs)
+  end
+
+  context "#height" do
+    it "returns the pdf_height of the graph container" do
+      expect(@container_data_collector.height).to eq(539)
+    end
+  end
+
+  context "#width" do
+    it "returns the pdf_width of the graph container" do
+      expect(@container_data_collector.width).to eq(632)
+    end
+  end
+
+  context "#graph_top_left_corner" do
+    it "returns the point for the top-left corner of the graph" do
+      expect(@container_data_collector.graph_top_left).to eq([112, 505])
+    end
+  end
+
+  context "#graph_title_top_left" do
+    it "returns x, y coordinate for placement of graph title" do
+      expect(@container_data_collector.graph_title_top_left).to eq([112, 530])
+    end
+  end
+
+  context "#y_title_top_left" do
+    it "returns x, y coordinate for placement of y title" do
+      expect(@container_data_collector.y_title_top_left).to eq([7, 505])
+    end
+  end
+
+  context "#x_title_top_left" do
+    it "returns x, y coordinate for placement of x title" do
+      expect(@container_data_collector.x_title_top_left).to eq([112, 83])
+    end
+  end
+end

data/spec/data_collectors/graph/horizontal_lines_data_collector_spec.rb

@@ -0,0 +1,17 @@
+require "spec_helper"
+
+describe HorizontalLinesDataCollector do
+  before do
+    graph_height_pdf = 60
+    graph_width_pdf = 80
+    y_labels = [0, 10, 100, 1_000, 10_000, 100_000, 1_000_000]
+    @horizontal_lines_data_collector = HorizontalLinesDataCollector.new(graph_height_pdf, graph_width_pdf, y_labels)
+  end
+
+  context "#collect" do
+    it "returns an array with the start, end, and y position of the horizontal lines" do
+      expected = [[0, 80, 0.0], [0, 80, 10.0], [0, 80, 20.0], [0, 80, 30.0], [0, 80, 40.0], [0, 80, 50.0], [0, 80, 60.0]]
+      expect(@horizontal_lines_data_collector.collect).to eq(expected)
+    end
+  end
+end

data/spec/data_collectors/graph/linear_y_pdf_data_collector_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+
+describe LinearYPdfDataCollector do
+  before do
+    input_data = [["Jan 11", 5], ["Feb 11", 2], ["Mar 11", 12]]
+    graph_height_pdf = 160
+    y_labels = [0, 4, 8, 12, 16]
+    @linear_y_pdf_data_collector = LinearYPdfDataCollector.new(input_data, graph_height_pdf, y_labels)
+  end
+
+  context "#collect" do
+    it "returns an array of y values in pdf points" do
+      expected = [50, 20, 120]
+      expect(@linear_y_pdf_data_collector.collect).to eq(expected)
+    end
+  end
+end

data/spec/data_collectors/graph/log_y_pdf_data_collector_spec.rb

@@ -0,0 +1,24 @@
+require "spec_helper"
+
+describe LogYPdfDataCollector do
+  before do
+    @graph_height_pdf = 60
+    @y_labels = [0, 10, 100, 1_000, 10_000, 100_000, 1_000_000]
+  end
+
+  context "#collect" do
+    it "returns an array of [x_pdf, y_pdf] for all data points" do
+      input_data = [["Jan 11", 5], ["Feb 11", 900], ["Mar 11", 800_000]]
+      log_y_pdf_data_collector = LogYPdfDataCollector.new(input_data, @graph_height_pdf, @y_labels)
+      expected = [10 * Math.log10(5), 10 * Math.log10(900), 10 * Math.log10(800_000)]
+      expect(log_y_pdf_data_collector.collect).to eq(expected)
+    end
+
+    it "it returns nil when a value is nil" do
+      input_data = [["Jan 11", 5], ["Feb 11", nil], ["Mar 11", 800_000]]
+      log_y_pdf_data_collector = LogYPdfDataCollector.new(input_data, @graph_height_pdf, @y_labels)
+      expected = [10 * Math.log10(5), nil, 10 * Math.log10(800_000)]
+      expect(log_y_pdf_data_collector.collect).to eq(expected)
+    end
+  end
+end

data/spec/data_collectors/graph/pdf_data_collector_spec.rb

@@ -0,0 +1,47 @@
+require "spec_helper"
+
+describe PdfDataCollector do
+  context "linear" do
+    before do
+      scale = :linear
+      input_data = [["Jan 11", 5], ["Feb 11", 2], ["Mar 11", 12]]
+      graph_width_pdf = 100
+      graph_height_pdf = 120
+      y_labels = [0, 3, 6, 9, 12]
+      @linear_pdf_data_collector = PdfDataCollector.new(scale, input_data, graph_width_pdf, graph_height_pdf, y_labels)
+    end
+
+    it "returns an array of pdf points where line should be plotted" do
+      expected = [[0, 50], [50, 20], [100, 120]]
+      expect(@linear_pdf_data_collector.collect).to eq(expected)
+    end
+  end
+
+  context "log" do
+    before do
+      scale = :log
+      input_data = [["Jan 11", 5], ["Feb 11", 900], ["Mar 11", 800_000]]
+      graph_width_pdf = 200
+      graph_height_pdf = 120
+      y_labels = [0, 10, 100, 1_000, 10_000, 100_000, 1_000_000]
+      @log_pdf_data_collector = PdfDataCollector.new(scale, input_data, graph_width_pdf, graph_height_pdf, y_labels)
+    end
+
+    it "returns an array of pdf points where line should be plotted" do
+      expected = [[0.0, Math.log10(5) * 20], [100.0, Math.log10(900) * 20], [200.0, Math.log10(800_000) * 20]]
+      expect(@log_pdf_data_collector.collect).to eq(expected)
+    end
+  end
+
+  context "invalid scale input" do
+    it "raises an error unless scale is :linear or :log" do
+      scale = :phattie
+      input_data = [["Jan 11", 5], ["Feb 11", 900], ["Mar 11", 800_000]]
+      graph_width_pdf = 200
+      graph_height_pdf = 120
+      y_labels = [0, 10, 100, 1_000, 10_000, 100_000, 1_000_000]
+      log_pdf_data_collector = PdfDataCollector.new(scale, input_data, graph_width_pdf, graph_height_pdf, y_labels)
+      expect{log_pdf_data_collector.collect}.to raise_error(RuntimeError)
+    end
+  end
+end

data/spec/data_collectors/graph/x_labels_data_collector_spec.rb

@@ -0,0 +1,18 @@
+require "spec_helper"
+
+describe XLabelsDataCollector do
+  before do
+    input_data = [["Jan 11", 5], ["Feb 11", 2], ["Mar 11", 12]]
+    graph_width_pdf = 160
+    vertical_offset = 20
+    label_width = 50
+    @x_labels_data_collector = XLabelsDataCollector.new(input_data, graph_width_pdf, vertical_offset, label_width)
+  end
+
+  context "#collect" do
+    it "returns array of labels and [x, y] coordinate where the label should be plotted" do
+      expected = [["Jan 11", [-25.0, -20]], ["Feb 11", [55.0, -20]], ["Mar 11", [135.0, -20]]]
+      expect(@x_labels_data_collector.collect).to eq(expected)
+    end
+  end
+end

data/spec/data_collectors/graph/x_pdf_data_collector_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe XPdfDataCollector do
+  before do
+    input_data = [["Jan 11", 5], ["Feb 11", 2], ["Mar 11", 12]]
+    graph_width_pdf = 160
+    @x_pdf_data_collector = XPdfDataCollector.new(input_data, graph_width_pdf)
+  end
+
+  context "#pdf_points_per_unit" do
+    it "returns number of pdf points per unit on x axis" do
+      expect(@x_pdf_data_collector.pdf_points_per_unit).to eq(80.0)
+    end
+  end
+
+  context "#collect" do
+    it "returns an array of x pdf points" do
+      expect(@x_pdf_data_collector.collect).to eq([0, 80, 160])
+    end
+  end
+end

data/spec/data_collectors/graph/y_labels_data_collector_spec.rb

@@ -0,0 +1,19 @@
+require "spec_helper"
+
+describe YLabelsDataCollector do
+  before do
+    y_labels = [0, 10, 100, 1_000, 10_000, 100_000, 1_000_000, 10_000_000]
+    graph_height_pdf = 560
+    label_width = 15
+    label_height = 20
+    y_label_offset = 30
+    @y_data_collector = YLabelsDataCollector.new(y_labels, graph_height_pdf, label_width, label_height, y_label_offset)
+  end
+
+  context "#collect" do
+    it "returns an array of y_labels and points where they should be plotted" do
+      expected = [["0", [-45, 10.0]], ["10", [-45, 90.0]], ["100", [-45, 170.0]], ["1,000", [-45, 250.0]], ["10,000", [-45, 330.0]], ["100,000", [-45, 410.0]], ["1,000,000", [-45, 490.0]], ["10,000,000", [-45, 570.0]]]
+      expect(@y_data_collector.collect).to eq(expected)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require_relative '../lib/prawn_charts.rb'

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification
+name: prawn_charts
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- MrPowers
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: prawn
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Library to create line graphs in Prawn
+email:
+- matthewkevinpowers@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- images/prawn_charts_log_example.png
+- images/simple_linear_example.png
+- lib/data_collectors/container/container_data_collector.rb
+- lib/data_collectors/container/graph_title_data_collector.rb
+- lib/data_collectors/graph/horizontal_lines_data_collector.rb
+- lib/data_collectors/graph/linear_y_pdf_data_collector.rb
+- lib/data_collectors/graph/log_y_pdf_data_collector.rb
+- lib/data_collectors/graph/pdf_data_collector.rb
+- lib/data_collectors/graph/x_labels_data_collector.rb
+- lib/data_collectors/graph/x_pdf_data_collector.rb
+- lib/data_collectors/graph/y_labels_data_collector.rb
+- lib/data_collectors/graph/y_pdf_data_collector.rb
+- lib/examples/log_example.rb
+- lib/examples/simple_linear_example.rb
+- lib/examples/simple_log_example.rb
+- lib/prawn_charts.rb
+- lib/prawn_charts/version.rb
+- lib/renderers/prawn_chart_renderer.rb
+- prawn_charts.gemspec
+- spec/data_collectors/container/container_data_collector_spec.rb
+- spec/data_collectors/graph/horizontal_lines_data_collector_spec.rb
+- spec/data_collectors/graph/linear_y_pdf_data_collector_spec.rb
+- spec/data_collectors/graph/log_y_pdf_data_collector_spec.rb
+- spec/data_collectors/graph/pdf_data_collector_spec.rb
+- spec/data_collectors/graph/x_labels_data_collector_spec.rb
+- spec/data_collectors/graph/x_pdf_data_collector_spec.rb
+- spec/data_collectors/graph/y_labels_data_collector_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Library to create line graphs in Prawn
+test_files:
+- spec/data_collectors/container/container_data_collector_spec.rb
+- spec/data_collectors/graph/horizontal_lines_data_collector_spec.rb
+- spec/data_collectors/graph/linear_y_pdf_data_collector_spec.rb
+- spec/data_collectors/graph/log_y_pdf_data_collector_spec.rb
+- spec/data_collectors/graph/pdf_data_collector_spec.rb
+- spec/data_collectors/graph/x_labels_data_collector_spec.rb
+- spec/data_collectors/graph/x_pdf_data_collector_spec.rb
+- spec/data_collectors/graph/y_labels_data_collector_spec.rb
+- spec/spec_helper.rb