squid 0.0.0 → 1.0.0.beta1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: dd30c909b777191445e84b30668138b1d901181b
-  data.tar.gz: 3812e0e240a624a4e22f7838461bf92b01358b14
+  metadata.gz: 6df26faf36554dfaaae941ba20b4d73e8dced3b3
+  data.tar.gz: 69a3176e49028324269eb76fd1ebbc1977884e69
 SHA512:
-  metadata.gz: d9c45cedbcd7c9e36f5746fa21a24b9cdb263e66ccc454d7639aa7f27bcce69dac294ef6f2c0e28c531fefb2c321664a6d1c27fb357aa71e224d207b0e5e8ddc
-  data.tar.gz: 6b94093525f67eb7aac794832ef45c725fe283440fe690b1bafcc60059bfc917f1630d1665c2e670b1077a264e048828647be64cc08a97a20b64cfd4edebf3ec
+  metadata.gz: 199f46e3f7d63dc58b473db627cc13ee0ee1517652a67199c51037345b4ba7d00e23b5796e14653e0862bd454221d523ba7e4e18e44deaf51ff8afe3fd565f80
+  data.tar.gz: 253d51d670c652531f11f2be4802abe04bd5c8337aaa70818bcd8a3f1638d81796992060becb376afaeec2d1a77e19744ba8da4dbf14296803562d11e04fa6df

data/.gitignore

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

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--fail-fast

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+cache: bundler
+notifications:
+  email: true
+matrix:
+  include:
+  - rvm: 2.1

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+For more information about changelogs, check
+[Keep a Changelog](http://keepachangelog.com) and
+[Vandamme](http://tech-angels.github.io/vandamme).
+
+## 1.0.0 - unreleased
+
+* [FEATURE] Add `chart` method to Prawn::Document to draw graphs.

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Fullscreen, Inc.
+
+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

@@ -1,3 +1,147 @@
-# Squid
+Squid
+=====
 
-TODO: Write a gem description
+Squid helps you write Ruby code to draw graphs in PDF files.
+
+The **source code** is available on [GitHub](https://github.com/Fullscreen/squid) and the **documentation** on [RubyDoc](http://www.rubydoc.info/github/Fullscreen/squid/master/Squid/Interface).
+
+[![Build Status](http://img.shields.io/travis/Fullscreen/squid/master.svg)](https://travis-ci.org/Fullscreen/squid)
+[![Coverage Status](http://img.shields.io/coveralls/Fullscreen/squid/master.svg)](https://coveralls.io/r/Fullscreen/squid)
+[![Dependency Status](http://img.shields.io/gemnasium/Fullscreen/squid.svg)](https://gemnasium.com/Fullscreen/squid)
+[![Code Climate](http://img.shields.io/codeclimate/github/Fullscreen/squid.svg)](https://codeclimate.com/github/Fullscreen/squid)
+[![Online docs](http://img.shields.io/badge/docs-✓-green.svg)](http://www.rubydoc.info/github/Fullscreen/squid/master/Squid/Interface)
+[![Gem Version](http://img.shields.io/gem/v/squid.svg)](http://rubygems.org/gems/squid)
+
+[Prawn](http://prawnpdf.org) is a great Ruby library to generate PDF files
+but lacks high-level components to draw graphs.
+
+Squid adds a single method `chart(data = {}, options = {})` to Prawn.
+
+Provide the `data` to plot as a hash, with each key/value representing a series.
+
+For instance, the following code generates the graph below:
+
+```ruby
+data = {views: {2013 => 182, 2014 => 46, 2015 => 134}}
+chart data
+```
+
+![01-basic](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_01.png "chart(data)")
+
+
+Graph options
+-------------
+
+By providing `options` to the `chart` method, you can customize the format of the graph.
+
+Multiple options can be combined. Here is a comprehensive list.
+
+##### `:type` sets the type of graph. Can be `:column` (default), `:point`, or `:line`.
+
+![02-type-point](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_02.png "chart(data, type: :point)")
+
+##### `:line_widths` changes the line width (default: `[3]`, only applies to line graphs).
+
+![03-type-line](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_03.png "chart(data, type: :line, line_widths: [10])")
+
+##### `:colors` changes the colors of the chart (default: `%w(2e578c 5d9648 e7a13d bc2d30 6f3d79 7d807f)`).
+
+![04-colors](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_04.png "chart(data, colors: ['5d9648'])")
+
+##### `:steps` changes the number of gridlines (default: `4`).
+
+![05-gridlines](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_05.png "chart(data, steps: 6)")
+
+##### `:ticks` shows/hides the ticks between the baseline and each category (default: `true`).
+
+![06-ticks](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_06.png "chart(data, ticks: false)")
+
+##### `:baseline` shows/hides the baseline (default: `true`).
+
+![07-baseline](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_07.png "chart(data, baseline: false)")
+
+##### `:every` specifies how often to show category labels on the baseline (default: `1`).
+
+![08-every](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_08.png "chart(data, every: 2)")
+
+##### `:legend` shows/hides the legend (default: `true`).
+
+![09-legend](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_09.png "chart(data, legend: false)")
+
+##### `:legend` can also set the distance of the legend from the right margin (default: `{offset: 0}`).
+
+![10-legend-offset](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_10.png "chart(data, legend: {offset: 50})")
+
+##### `:format` changes the format of the label values. Can be `:integer` (default), `:float`, `:percentage`, `:currency`, or `:seconds`.
+
+![11-format](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_11.png "chart(data, format: :percentage)")
+
+##### `:labels` shows/hides the value for each point in the graph (default: `false`).
+
+![12-labels](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_12.png "chart(data, labels: true)")
+
+##### `:border` shows/hides a border around the graph (default: `false`).
+
+![13-border](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_13.png "chart(data, border: true)")
+
+##### `:height` changes the height of the graph (default: `250`).
+
+![14-height](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_14.png "chart(data, height: 150)")
+
+Multiple series
+---------------
+
+By providing multiple key/values `data` to the `chart` method, you can plot multiple series on a graph.
+
+For instance, the following code generates the graph below:
+
+```ruby
+data = {safari:  {2013 => 43.2, 2014 => 46.1, 2015 => 50.7},
+       firefox:  {2013 => 56.8, 2014 => 53.9, 2015 => 49.3}}
+chart data, labels: true, format: :percentage
+```
+
+![15-multiple-columns](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_15.png "chart(data, labels: true, format: :percentage)")
+
+When plotting multiple series, the option `type: :stack` can be set to display stacked columns:
+
+![16-multiple-stacks](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_16.png "chart(data, type: :stack, format: :percentage)")
+
+Finally, the option `type: :two_axis` can be set to display two separate axes in your series belong to two different domains.
+
+For instance, the following code generates the graph below:
+
+```ruby
+data = {views: {2013 => 182, 2014 => 46, 2015 => 88},
+     earnings: {2013 => 104_323, 2014 => 27_234, 2015 => 14_123}}
+chart data, type: :two_axis
+```
+
+![17-two-axis](https://raw.githubusercontent.com/fullscreen/squid/master/examples/screenshots/readme_17.png "chart(data, type: :two_axis)")
+
+How to install
+==============
+
+Squid requires **Ruby 2.1 or higher**.
+If used in a Rails project, requires **Rails 4.0 or higher**.
+
+To include in your project, add `gem 'squid', github: 'fullscreen/squid'` to the `Gemfile` file of your Ruby project.
+
+How to generate the manual
+==========================
+
+`rake manual`
+
+How to contribute
+=================
+
+If you’ve made it this far in the README… thanks! :v:
+
+I’m about to release version 1 of this gem.
+Feel free to try it out and send issues or pull requests.
+
+All pull requests will have to make Travis and Code Climate happy in order to be accepted. :kissing_smiling_eyes:
+
+You can also run the tests locally with `bundle exec rspec`.
+
+Happy hacking!

data/Rakefile

@@ -1 +1,26 @@
-require "bundler/gem_tasks"
+require 'bundler/gem_tasks'
+
+desc 'Generate the manual'
+task :manual do
+  print 'Building manual... '
+  require_relative 'examples/manual'
+  puts 'DONE!'
+end
+
+desc 'Generate the readme'
+task :readme do
+  print 'Building readme... '
+  require_relative 'examples/readme'
+  print 'Extracting screenshots...'
+  `convert -density 175 -colorspace sRGB readme.pdf -resize 50% -quality 100 -crop 744x320+0+280 examples/screenshots/readme_%02d.png`
+  puts 'DONE!'
+end
+
+
+require "rspec/core/rake_task"
+require "rspec/core/version"
+
+desc "Run all examples"
+RSpec::Core::RakeTask.new :spec
+
+task default: [:spec]

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'squid'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require 'pry'
+# Pry.start
+
+require 'irb'
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/examples/manual.rb

@@ -0,0 +1,7 @@
+require 'squid'
+require 'prawn/manual_builder'
+Prawn::ManualBuilder.manual_dir = File.dirname(__FILE__)
+Prawn::Font::AFM.hide_m17n_warning = true
+Prawn::ManualBuilder::Example.generate 'manual.pdf', skip_page_creation: true do
+  load_package 'squid'
+end

data/examples/readme/01-basic.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 134}}
+  chart data
+end

data/examples/readme/02-type-point.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 134}}
+  chart data, type: :point
+end

data/examples/readme/03-type-line.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 134}}
+  chart data, type: :line, line_widths: [10]
+end

data/examples/readme/04-color.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 134}}
+  chart data, colors: ['5d9648']
+end

data/examples/readme/05-gridlines.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 134}}
+  chart data, steps: 6
+end

data/examples/readme/06-ticks.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 134}}
+  chart data, ticks: false
+end

data/examples/readme/07-baseline.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 134}}
+  chart data, baseline: false
+end

data/examples/readme/08-every.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 134}}
+  chart data, every: 2
+end

data/examples/readme/09-legend.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 134}}
+  chart data, legend: false
+end

data/examples/readme/10-legend-offset.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 134}}
+  chart data, legend: {offset: 50}
+end

data/examples/readme/11-format.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182/3.62, 2014 => 46/3.62, 2015 => 134/3.62}}
+  chart data, format: :percentage
+end

data/examples/readme/12-labels.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 134}}
+  chart data, labels: true
+end

data/examples/readme/13-border.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 134}}
+  chart data, border: true
+end

data/examples/readme/14-height.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 134}}
+  chart data, height: 150
+end

data/examples/readme/15-multiple-columns.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {safari:  {2013 => 43.2, 2014 => 46.1, 2015 => 50.7}, firefox:  {2013 => 56.8, 2014 => 53.9, 2015 => 49.3}}
+  chart data, labels: true, format: :percentage
+end

data/examples/readme/16-multiple-stacks.rb

@@ -0,0 +1,5 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {safari:  {2013 => 43.2, 2014 => 46.1, 2015 => 50.7}, firefox:  {2013 => 56.8, 2014 => 53.9, 2015 => 49.3}}
+  chart data, type: :stack, format: :percentage
+end

data/examples/readme/17-two-axis.rb

@@ -0,0 +1,7 @@
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 88}, earnings: {2013 => 104_323, 2014 => 27_234, 2015 => 14_123}}
+  chart data, type: :two_axis
+end
+
+

data/examples/readme/readme.rb

@@ -0,0 +1,28 @@
+Prawn::ManualBuilder::Example.generate 'readme.pdf' do
+  package 'readme' do |p|
+    p.name = 'Readme'
+
+    p.intro do
+    end
+
+    p.section 'Single series' do |s|
+      s.example '01-basic'
+      s.example '02-type-point'
+      s.example '03-type-line'
+      s.example '04-color'
+      s.example '05-gridlines'
+      s.example '06-ticks'
+      s.example '07-baseline'
+      s.example '08-every'
+      s.example '09-legend'
+      s.example '10-legend-offset'
+      s.example '11-format'
+      s.example '12-labels'
+      s.example '13-border'
+      s.example '14-height'
+      s.example '15-multiple-columns'
+      s.example '16-multiple-stacks'
+      s.example '17-two-axis'
+    end
+  end
+end

data/examples/readme.rb

@@ -0,0 +1,7 @@
+require 'squid'
+require 'prawn/manual_builder'
+Prawn::ManualBuilder.manual_dir = File.dirname(__FILE__)
+Prawn::Font::AFM.hide_m17n_warning = true
+Prawn::ManualBuilder::Example.generate 'readme.pdf', skip_page_creation: true do
+  load_package 'readme'
+end

data/examples/squid/baseline.rb

@@ -0,0 +1,9 @@
+# By default, <code>chart</code> plots a baseline at the bottom of the graph.
+#
+# You can use the <code>:baseline</code> option to disable this behavior.
+#
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 802000000000000000}}
+  chart data, baseline: false, format: :float
+end

data/examples/squid/basic.rb

@@ -0,0 +1,9 @@
+# Creating graphs with Squid is easy. Just use the <code>chart</code> method.
+#
+# Provide a hash containing the data of the series and plot it with <code>chart</code>.
+#
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 134}}
+  chart data
+end

data/examples/squid/border.rb

@@ -0,0 +1,9 @@
+# By default, <code>chart</code> is not plotted with an outer border.
+#
+# You can use the <code>:border</code> option to enable this behavior.
+#
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {Safari: 45.20001, Firefox: 33.3999, Chrome: 21.4}}
+  chart data, border: true
+end

data/examples/squid/columns.rb

@@ -0,0 +1,9 @@
+# By default, <code>chart</code> plots a graph for each series.
+#
+# Provide multiple key/value pairs to <code>:data</code> to plot multiple series.
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46, 2015 => 88},
+        uniques: {2013 => 104, 2014 => -27, 2015 => 14}}
+  chart data, labels: true
+end

data/examples/squid/every.rb

@@ -0,0 +1,11 @@
+# By default, <code>chart</code> plots every category on the baseline.
+#
+# You can use the <code>:every</code> option to change this behavior.
+#
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+ data = {views: {'Jan 1' => 12, 'Jan 2' => 13, 'Jan 3' => 21, 'Jan 4' => 42,
+ 'Jan 5' => 32, 'Jan 6' => 45, 'Jan 7' => 62, 'Jan 8' => 22, 'Jan 9' => 31,
+ 'Jan 10' => 11, 'Jan 11' => 40, 'Jan 12' => 6, 'Jan 13' => 9}}
+ chart data, every: 3
+end

data/examples/squid/format.rb

@@ -0,0 +1,9 @@
+# You can specify the format of the axis values with the <code>:format</code> option.
+#
+# Valid options are: <code>:percentage</code>, <code>:currency</code>, <code>:seconds</code>, <code>:float</code>.
+#
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {Safari: 45.20001, Firefox: 33.3999, Chrome: 21.4}}
+  chart data, format: :percentage
+end

data/examples/squid/gridlines.rb

@@ -0,0 +1,9 @@
+# By default, <code>chart</code> plots 5 equidistant horizontal gridlines.
+#
+# You can use the <code>:steps</code> option to change this number.
+#
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182000, 2014 => -46000, 2015 => 102000}}
+  chart data, steps: 8
+end

data/examples/squid/height.rb

@@ -0,0 +1,9 @@
+# By default, <code>chart</code> generates charts with a height of 250.
+#
+# You can use the <code>:height</code> option to manually set the height.
+#
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 18.2, 2014 => 4.6, 2015 => 10.2}}
+  chart data, height: 350
+end

data/examples/squid/labels.rb

@@ -0,0 +1,9 @@
+# By default, <code>chart</code> does not write value labels on the chart.
+#
+# You can use the <code>:labels</code> option to enable this behavior.
+#
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {a_very_long_label_to_test_padding_with_labels: {2013 => 182000, 2014 => -182000, 2015 => 182000}}
+  chart data, labels: true
+end

data/examples/squid/legend.rb

@@ -0,0 +1,9 @@
+# By default, <code>chart</code> adds a legend in the top-right corner.
+#
+# You can use the <code>:legend</code> option to disable this behavior.
+#
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46}, uniques: {2013 => 94, 2014 => 27}}
+  chart data, legend: false
+end

data/examples/squid/legend_offset.rb

@@ -0,0 +1,9 @@
+# By default, <code>chart</code> adds a legend in the top-right corner.
+#
+# You can use the <code>:legend</code> option to change the position of the legend.
+#
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {2013 => 182, 2014 => 46}, uniques: {2013 => 94, 2014 => 27}}
+  chart data, legend: {offset: 50}
+end

data/examples/squid/line.rb

@@ -0,0 +1,9 @@
+# By default, <code>chart</code> plots a column chart.
+#
+# You can use the <code>:type</code> option to plot a line chart instead.
+#
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename) do
+  data = {views: {Safari: 45.20001, Firefox: 63.3999, Chrome: 21.4}}
+  chart data, type: :line
+end