numerics 0.2.1

data/lib/numerics/connection.rb

@@ -0,0 +1,181 @@
+require 'net/https'
+require 'cgi'
+if RUBY_VERSION =~ /^1\.8/
+  require 'rubygems'
+end
+require 'yajl'
+
+module Numerics
+  class Connection
+
+    HOST = 'api.numerics.io'
+    PORT = '443'
+    BASE_PATH = '/ts'
+
+    attr_reader :access_key, :secret_key
+
+    def initialize(access_key, secret_key, host=nil, port=nil)
+      @access_key, @secret_key = access_key.to_s, secret_key.to_s
+      @host = (host || HOST).to_s
+      @port = (port || PORT).to_s
+    end
+
+    def to_s
+      "#<Numerics::Connection @access_key=#{@access_key}>"
+    end
+
+    ## Start Commands ##
+
+    def list
+      self.coll_get
+    end
+
+    def create(name, precision=nil)
+      self.coll_post([name, precision.to_s])
+    end
+
+    def about(timeseries)
+      self.get(timeseries, 'about')
+    end
+
+    def describe(timeseries, md)
+      self.put(timeseries, 'describe', md)
+    end
+
+    def erase(timeseries)
+      self.destroy(timeseries)
+    end
+
+    ##@@ todo - support time words
+    def insert(timeseries, number='1', time=Time.now, properties={})
+      self.post(timeseries, 'insert', [time.to_s, number.to_s, properties])
+    end
+
+    ##@@ todo - support time words
+    def remove(timeseries, number='1', time=Time.now, properties={})
+      self.post(timeseries, 'remove', [time.to_s, number.to_s, properties])
+    end
+
+    def entries(timeseries, query=nil)
+      self.get(timeseries, 'entries', query)
+    end
+
+    def series(timeseries, query=nil)
+      self.get(timeseries, 'series', query)
+    end
+
+    def stats(timeseries)
+      self.get(timeseries, 'stats')
+    end
+
+    def distribution(timeseries, width=nil, start=nil)
+      query =  if width || start
+                 {:w => width, :s => start}
+               else
+                 nil
+               end
+      self.get(timeseries, 'distribution', query)
+    end
+
+    def properties(timeseries)
+      self.get(timeseries, 'properties')
+    end
+
+    def version(timeseries)
+      self.get(timeseries, 'version')
+    end
+
+    def draw(timeseries, query=nil)
+      self.get(timeseries, 'draw', query)
+    end
+
+    def histogram(timeseries, width=nil, start=nil)
+      query =  if width || start
+                 {:w => width, :s => start}
+               else
+                 nil
+               end
+      self.get(timeseries, 'histogram', query)
+    end
+
+    def headline(timeseries, query=nil)
+      self.get(timeseries, 'headline', query)
+    end
+
+    def trend(timeseries, query=nil)
+      self.get(timeseries, 'trend', query)
+    end
+
+    ## End Commands
+
+    protected
+
+    def client
+      if !@client
+        @client = Net::HTTP.new(@host, @port)
+        @client.use_ssl = true
+        @client.verify_mode = OpenSSL::SSL::VERIFY_NONE ##@@remove me after alpha!         
+      end
+      @client
+    end
+
+    def get(timeseries, command, query=nil)
+      path = [BASE_PATH, [*timeseries], command].flatten.join('/')
+      if query
+        path << '?'
+        parts = []
+        query.keys.each do |k|
+          parts << [CGI::escape(k.to_s), CGI::escape(query[k].to_s)].join('=')
+        end
+        path << parts.join('&')
+      end
+      self.do_request Net::HTTP::Get.new(path)
+    end
+
+    def post(timeseries, command, args)
+      path = [BASE_PATH, [*timeseries], command].flatten.join('/')
+      req = Net::HTTP::Post.new(path)
+      req.body = Yajl::Encoder.encode(args)
+      self.do_request req
+    end
+
+    def put(timeseries, command, args)
+      path = [BASE_PATH, [*timeseries], command].flatten.join('/')
+      req = Net::HTTP::Put.new(path)
+      req.body = Yajl::Encoder.encode(args)
+      self.do_request req
+    end
+
+    def destroy(timeseries)
+      path = [BASE_PATH, [*timeseries]].flatten.join('/')
+      self.do_request Net::HTTP::Delete.new(path)
+    end
+
+    def coll_get
+      self.do_request Net::HTTP::Get.new(BASE_PATH)
+    end
+
+    def coll_post(args)
+      req = Net::HTTP::Post.new(BASE_PATH)
+      req.body = Yajl::Encoder.encode(args)
+      self.do_request req
+    end
+
+    def do_request(req)
+      req['X-Access-Key'] = @access_key
+      req['X-Secret-Key'] = @secret_key
+      req['Content-Type'] = 'application/json'
+      response = self.client.start do |h|
+        h.request(req)
+      end
+      data = Yajl::Parser.parse(response.body)
+      if data[0]
+        {:error => data[0]}
+      else
+        {:success => true, :data => data[1]}
+      end
+    end
+
+  end
+end
+

data/lib/numerics.rb

@@ -0,0 +1,76 @@
+if RUBY_VERSION =~ /^1\.8/
+  require 'rubygems'
+end
+require 'yajl'
+require 'yaml'
+
+require 'numerics/connection'
+
+module Numerics
+
+  VERSION = '0.2.1'
+  
+  def self.connect(arg, env=nil)
+    config = if arg.is_a?(Hash)
+               arg
+             else
+               if arg.match(/\.json$/)
+                 File.open(arg){ |f| Yajl::Parser.parse(f) }
+               elsif arg.match(/\.ya?ml$/)
+                 YAML::load_file(arg)
+               else
+                 nil
+               end
+             end
+
+    if !config
+      raise "Only json and yaml config files supported"
+    end
+    
+    if env
+      config = config[env.to_s] || config[env.to_sym]
+      if !config
+        raise "No #{env} found in #{arg}"
+      end
+    end
+
+    access_key = config[:access_key] || config['access_key']
+    secret_key = config[:secret_key] || config['secret_key']
+    host = config[:host] || config['host'] # nil means use the default
+    port = config[:port] || config['port'] # nil means use the default
+
+    if !access_key && !secret_key
+      raise ArgumentError, 'Numerics.connect(config_file, env=nil) or Numerics.connect(:access_key => access_key, :secret_key => :secret_key)'
+    end
+
+    Numerics::Connection.new(access_key, secret_key, host, port)
+  end
+
+  def self.config(arg, env=nil)
+    @global_connection = self.connect(arg, env)
+  end
+
+  def self.global_connection
+    @global_connection
+  end
+
+  def self.global_connection=(gc)
+    @global_connection = gc
+  end
+
+  def self.respond_to?(method)
+    !@global_connection.nil? && @global_connection.respond_to?(method)
+  end
+
+  ##@@ check syntax
+  def self.method_missing(method, *args, &block)
+    if self.respond_to?(method)
+      @global_connection.send(method, *args, &block)
+    else
+      super
+    end
+
+  end
+
+end
+

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: numerics
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.2.1
+platform: ruby
+authors: 
+- Ben Lund
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-11-19 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: yajl-ruby
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: yaml
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: Official Ruby client for the Numerics.io API. Numerics.io is a custom metrics and analytics service currently in private alpha.
+email: code@numerics.io
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/numerics.rb
+- lib/numerics/connection.rb
+homepage: http://github.com/frequalize/numerics-ruby
+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.11
+signing_key: 
+specification_version: 3
+summary: Official Ruby client for the Numerics.io API
+test_files: []
+