c2po 0.0.2

data/.gitignore

@@ -0,0 +1 @@
+*.gem

data/LICENSE

@@ -0,0 +1,26 @@
+Copyright (c) 2012, Keming Labs, LLC (http://keminglabs.com)
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* The name Keming Labs may not be used to endorse or promote products
+  derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL KEVIN LYNAGH BE LIABLE FOR ANY DIRECT,
+INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
+OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.markdown

@@ -0,0 +1,56 @@
+C2PO Ruby language bindings
+===========================
+
+[C2PO](http://keminglabs.com/c2po/) is a grammar of graphics implementation inspired by Hadley Wickham's ggplot2 library.
+This Rubygem uses the free online C2PO compiler and is limited to 1 MB of data.
+Plot specifications are compiled directly to an SVG string, which is returned:
+
+```ruby
+require 'c2po'
+
+#Make some random data:
+data = 20.times.collect do
+  {:a => 10*rand, :b => 5*rand}
+end
+
+#Specify a simple scatterplot graphic:
+scatterplot_spec = {
+  :data => data,
+  :geom => :point,
+  :mapping => {:x => :a, :y => :b}}
+
+#Render an SVG string:
+C2PO.render scatterplot_spec
+  #=> 
+
+```
+
+
+Install
+-------
+
+For the plain client library, run
+
+    gem install c2po
+
+or add
+
+    c2po, "0.0.1"
+
+to your `Gemfile`.
+
+If you want to learn the grammar and work interactively with the examples in `/examples`, just clone this repo:
+
+    git clone https://github.com/keminglabs/c2po-ruby
+
+install the deps:
+
+    cd examples
+    bundle install
+
+then run:
+
+    bundle exec guard
+
+to launch a live-reloading web server on `localhost:3000` for displaying graphics.
+Walk through and execute the example code in `examples/1-usage.rb` to get started.

data/c2po.gemspec

@@ -0,0 +1,19 @@
+$:.unshift(File.join(File.dirname(__FILE__), 'lib'))
+
+require 'c2po/version'
+
+spec = Gem::Specification.new do |s|
+  s.name = 'c2po'
+  s.version = C2PO::VERSION
+  s.summary = 'Ruby bindings for C2PO'
+  s.description = 'C2PO is a grammar for statistical graphics. See http://keminglabs.com/c2po.'
+  s.authors = ['Kevin Lynagh']
+  s.email = ['kevin@keminglabs.com']
+  s.homepage = 'http://keminglabs.com/c2po'
+  s.require_paths = %w{lib}
+
+  s.add_dependency('edn', '~> 1.0.0')
+  
+  s.files = `git ls-files`.split("\n")
+  s.require_paths = ['lib']
+end

data/examples/.gitignore

@@ -0,0 +1 @@
+index.html

data/examples/1-usage.rb

@@ -0,0 +1,23 @@
+#This tutorial covers basic usage and plot creation.
+
+#First require the interactive helper functions and dependencies
+require File.dirname(__FILE__) + '/interactive_helper'
+
+#then make some random data:
+
+data = 20.times.collect do
+  {:a => 10*rand, :b => 5*rand}
+end
+
+#Specify a simple scatterplot graphic:
+
+scatterplot_spec = {
+  :data => data,
+  :geom => :point,
+  :mapping => {:x => :a, :y => :b}}
+
+#then render it via the remote c2po server:
+
+render! scatterplot_spec
+
+#This call will save the result in `./index.html` and if your browser is pointed at `http://localhost:3000` it will automatically refresh to show this plot.

data/examples/Gemfile

@@ -0,0 +1,13 @@
+source "http://rubygems.org"
+
+gem 'c2po'
+
+gem 'guard'
+gem 'rb-inotify', :require => false
+gem 'rb-fsevent', :require => false
+gem 'rb-fchange', :require => false
+
+gem 'guard-livereload'
+gem 'guard-webrick'
+
+

data/examples/Gemfile.lock

@@ -0,0 +1,49 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.3.2)
+    blankslate (2.1.2.4)
+    c2po (0.0.1)
+      edn (~> 1.0.0)
+    edn (1.0.0)
+      parslet (~> 1.4.0)
+    em-websocket (0.3.8)
+      addressable (>= 2.1.1)
+      eventmachine (>= 0.12.9)
+    eventmachine (1.0.0)
+    ffi (1.2.0)
+    guard (1.0.3)
+      ffi (>= 0.5.0)
+      thor (>= 0.14.6)
+    guard-livereload (0.4.2)
+      em-websocket (>= 0.2.0)
+      guard (>= 0.10.0)
+      multi_json (~> 1.0)
+    guard-webrick (0.1.2)
+      guard (~> 1.0.2)
+      launchy (~> 2.1.0)
+      spoon (~> 0.0.1)
+    launchy (2.1.2)
+      addressable (~> 2.3)
+    multi_json (1.4.0)
+    parslet (1.4.0)
+      blankslate (~> 2.0)
+    rb-fchange (0.0.6)
+      ffi
+    rb-fsevent (0.9.2)
+    rb-inotify (0.8.8)
+      ffi (>= 0.5.0)
+    spoon (0.0.1)
+    thor (0.16.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  c2po
+  guard
+  guard-livereload
+  guard-webrick
+  rb-fchange
+  rb-fsevent
+  rb-inotify

data/examples/Guardfile

@@ -0,0 +1,6 @@
+guard 'webrick' do
+end
+
+guard 'livereload' do
+  watch("index.html")
+end

data/examples/README.markdown

@@ -0,0 +1,11 @@
+Directory for interactive development of c2po plots.
+Install deps via:
+
+    bundle install
+
+then run
+
+    bundle exec guard
+
+execute some of the code in `scratch.rb` and view your plots at `http://localhost:3000/`.
+    

data/examples/interactive_helper.rb

@@ -0,0 +1,23 @@
+require 'c2po'
+include C2PO
+
+OUT_FILE = File.dirname(__FILE__) + "/index.html"
+
+def html(content)
+  <<-EOH
+    <html>
+      <head></head>
+      <body>
+        <div id="visualization" style="text-align: center">
+         #{content}
+        </div>
+      </body>
+    </html>
+  EOH
+end
+
+def render! (spec)
+  open(OUT_FILE, "w") do |f|
+    f.write html C2PO.render spec
+  end
+end

data/lib/c2po.rb

@@ -0,0 +1,42 @@
+$:.push(File.dirname(__FILE__))
+require 'edn'
+require 'c2po/records'
+require 'c2po/geom'
+require 'c2po/stat'
+require 'c2po/group'
+require 'c2po/scale'
+
+require 'net/http'
+require 'uri'
+
+module C2PO
+  class C2POException < Exception
+  end
+  
+  C2PO_URL = "http://c2po.keminglabs.com"
+
+  def self.motd(url=C2PO_URL)
+    res = Net::HTTP.get_response URI.parse url + "/motd"
+    res.body
+  end
+  
+  @@motd_printed = false
+  def self.print_once_motd!(url=C2PO_URL)
+    unless @@motd_printed
+      puts motd url
+      @@motd_printed = true
+    end
+  end
+  
+  def self.render(spec, url=C2PO_URL)
+    print_once_motd!
+    
+    res = Net::HTTP.post_form(URI.parse(url),
+                              "c2po" => spec.to_edn)
+    if res.code != "200"
+      raise C2POException.new, res.body
+    else
+      res.body
+    end
+  end
+end

data/lib/c2po/geom.rb

@@ -0,0 +1,8 @@
+module C2PO
+  module Geom
+    Point = Class.new C2PORecord
+    Line = Class.new C2PORecord
+    Bar = Class.new C2PORecord
+    Boxplot = Class.new C2PORecord
+  end
+end

data/lib/c2po/group.rb

@@ -0,0 +1,5 @@
+module C2PO
+  module Group
+    Bin = Class.new C2PORecord
+  end
+end

data/lib/c2po/records.rb

@@ -0,0 +1,11 @@
+module C2PO
+  class C2PORecord < Hash
+    def initialize(h={})
+      self.merge! h
+    end
+    def to_edn
+      _, prefix, name = self.class.name.split("::").map(&:downcase)
+      EDN.tagout "com.keminglabs/c2po$#{prefix}$#{name}", {}.merge(self)
+    end
+  end
+end

data/lib/c2po/scale.rb

@@ -0,0 +1,5 @@
+module C2PO
+  module Scale
+    Linear = Class.new C2PORecord
+  end
+end

data/lib/c2po/stat.rb

@@ -0,0 +1,7 @@
+module C2PO
+  module Stat
+    Sum = Class.new C2PORecord
+    Density = Class.new C2PORecord
+    Quantiles = Class.new C2PORecord
+  end
+end

data/lib/c2po/version.rb

@@ -0,0 +1,3 @@
+module C2PO
+  VERSION = '0.0.2'
+end

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification
+name: c2po
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Kevin Lynagh
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: edn
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+description: C2PO is a grammar for statistical graphics. See http://keminglabs.com/c2po.
+email:
+- kevin@keminglabs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- LICENSE
+- README.markdown
+- c2po.gemspec
+- examples/.gitignore
+- examples/1-usage.rb
+- examples/Gemfile
+- examples/Gemfile.lock
+- examples/Guardfile
+- examples/README.markdown
+- examples/interactive_helper.rb
+- lib/c2po.rb
+- lib/c2po/geom.rb
+- lib/c2po/group.rb
+- lib/c2po/records.rb
+- lib/c2po/scale.rb
+- lib/c2po/stat.rb
+- lib/c2po/version.rb
+homepage: http://keminglabs.com/c2po
+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.24
+signing_key: 
+specification_version: 3
+summary: Ruby bindings for C2PO
+test_files: []