simperium 0.0.1

data/lib/simperium.rb

@@ -0,0 +1,425 @@
+# Simperium Ruby bindings
+# API spec at https://simperium.com/docs/reference
+require 'rubygems'
+require 'rest_client'
+require 'json'
+require 'uuid'
+require File.join(File.dirname(__FILE__), 'simperium/error_handling')
+
+#state file is not shared between processes on Heroku
+UUID.state_file = false
+
+class Auth
+    def initialize(appname, api_key, host=nil,scheme='https')
+        if host == nil
+            host = ENV['SIMPERIUM_AUTHHOST'] || 'auth.simperium.com'
+        end
+        
+        @appname = appname
+        @api_key = api_key
+        @host = host
+        @scheme = scheme
+    end
+
+    def _auth_header
+        return {"X-Simperium-API-Key" => "#{@api_key}"}
+    end
+
+    def _request(url, data=nil, headers=nil, method=nil)
+        url = "#{@scheme}://#{@host}/1/#{url}"
+        opts = {:url => url,
+                :method => :post,
+                :open_timeout => 30, 
+                :timeout => 80}
+        
+        if data
+            opts = opts.merge({:payload => data})
+        end
+        
+        if headers.nil?
+            headers = {}
+        end
+        opts = opts.merge({:headers => headers})
+        
+        if method
+            opts = opts.merge({:method => method})
+        end
+        
+        begin
+            response = RestClient::Request.execute(opts)
+        rescue SocketError => e
+            ErrorHandling.handle_restclient_error(e)
+        rescue NoMethodError => e
+            if e.message =~ /\WRequestFailed\W/
+                e = StandardError.new('Unexpected HTTP response code')
+                ErrorHandling.handle_restclient_error(e)
+            else
+                raise
+            end
+        rescue RestClient::ExceptionWithResponse => e
+            if rcode = e.http_code and rbody = e.http_body
+                ErrorHandling.handle_api_error(rcode, rbody)
+            else
+                ErrorHandling.handle_restclient_error(e)
+            end
+        rescue RestClient::Exception, Errno::ECONNREFUSED => e
+            ErrorHandling.handle_restclient_error(e)
+        end
+        
+        return response
+    end
+
+    def create(username, password)
+        data = {
+            'client_id' => @api_key,
+            'username' => username,
+            'password'=> password }
+        
+        response = self._request(@appname+'/create/', data)
+        return JSON.load(response.body)['access_token']
+    end
+            
+    def authorize(username, password)
+        data = {
+            'username' => username,
+            'password' => password }
+        response = self._request(@appname+'/authorize/', data, headers=_auth_header())
+        return JSON.load(response.body)['access_token']
+    end
+end
+
+class Bucket
+    def initialize(appname, auth_token, bucket, options={})
+        defaults = { :userid => nil, :host => nil, :scheme => 'https', :clientid => nil }
+        unless options.empty?
+            options = defaults.merge(options)
+        else
+            options = defaults
+        end
+
+        if options[:host] == nil
+            options[:host] = ENV['SIMPERIUM_APIHOST'] || 'api.simperium.com'
+        end
+
+        @userid = options[:userid]
+        @host = options[:host]
+        @scheme = options[:scheme]
+        @appname = appname
+        @bucket = bucket
+        @auth_token = auth_token
+
+        if options[:clientid] == nil
+            uuid = UUID.new
+            random_string = uuid.generate(:compact)
+            @clientid = "rb-#{random_string}"
+        else
+            @clientid = options[:clientid]
+        end
+    end
+
+    def _auth_header
+        headers = {"X-Simperium-Token" => "#{@auth_token}"}
+        unless @userid.nil?
+            headers["X-Simperium-User"] = @userid
+        end
+        return headers
+    end
+
+    def _gen_ccid
+        ccid = UUID.new
+        return ccid.generate(:compact)
+    end
+
+    def _request(url, data=nil, headers=nil, method=nil, timeout=nil)
+        url = "#{@scheme}://#{@host}/1/#{url}"
+        opts = {:url => url,
+                :method => :post,
+                :open_timeout => 30, 
+                :timeout => 80}
+        
+        if data
+            opts = opts.merge({:payload => data})
+        end
+        
+        if headers.nil?
+            headers = {}
+        end
+        opts = opts.merge({:headers => headers})
+        
+        if method
+            opts = opts.merge({:method => method})
+        end
+        
+        if timeout
+            opts = opts.merge({:timeout => timeout})
+        end
+        
+        puts opts
+        begin
+            response = RestClient::Request.execute(opts)
+        rescue SocketError => e
+            ErrorHandling.handle_restclient_error(e)
+        rescue NoMethodError => e
+            if e.message =~ /\WRequestFailed\W/
+                e = StandardError.new('Unexpected HTTP response code')
+                ErrorHandling.handle_restclient_error(e)
+            else
+                raise
+            end
+        rescue RestClient::ExceptionWithResponse => e
+            if rcode = e.http_code and rbody = e.http_body
+                ErrorHandling.handle_api_error(rcode, rbody)
+            else
+                ErrorHandling.handle_restclient_error(e)
+            end
+        rescue RestClient::Exception, Errno::ECONNREFUSED => e
+            ErrorHandling.handle_restclient_error(e)
+        end
+
+        return response
+    end
+      
+    def index(options={})
+        defaults = {:data=>nil, :mark=>nil, :limit=>nil, :since=>nil}
+        unless options.empty?
+            options = defaults.merge(options)
+        else
+            options = defaults
+        end
+
+        data = options[:data]
+        mark = options[:mark]
+        limit = options[:limit]
+        since = options[:since]
+
+        url = "#{@appname}/#{@bucket}/index?"
+        
+        if data
+            url += "&data=1"
+        end
+
+        if mark
+            url += "&mark=#{mark.to_str}"
+        end
+
+        if limit
+            url += "&limit=#{limit.to_s}"
+        end
+
+        if since
+            url += "&since=#{since.to_str}"
+        end
+        
+        response = self._request(url, data=nil, headers=_auth_header(), method='GET')
+        return JSON.load(response.body)
+    end
+
+    def get(item, options={})
+        defaults = {:default=>nil, :version=>nil}
+        unless options.empty?
+            options = defaults.merge(options)
+        else
+            options = defaults
+        end
+        default = options[:default]
+        version = options[:version]
+
+        url = "#{@appname}/#{@bucket}/i/#{item}"
+        unless version.nil?
+            url += "/v/#{version}"
+        end
+
+        response = self._request(url, data=nil, headers=_auth_header(), method='GET')
+        return JSON.load(response.body)
+    end
+    
+    def post(item, data, options={})
+        defaults = {:version=>nil, :ccid=>nil, :include_response=>false, :replace=>false}
+        unless options.empty?
+            options = defaults.merge(options)
+        else
+            options = defaults
+        end
+
+        version = options[:version]
+        ccid = options[:ccid]
+        include_response = options[:include_response]
+        replace = options[:replace]
+
+        if ccid.nil?
+            ccid = self._gen_ccid()
+        end
+        url = "#{@appname}/#{@bucket}/i/#{item}"
+        
+        if version
+            url += "/v/#{version}"
+        end
+        url += "?clientid=#{@clientid}&ccid=#{ccid}"
+        
+        if include_response
+            url += "&response=1"
+        end
+        
+        if replace
+            url += "&replace=1"
+        end
+        data = JSON.dump(data)
+        
+        response = self._request(url, data, headers=_auth_header())
+        if include_response
+            return item, JSON.load(response.body)
+        else
+            return item
+        end
+    end
+
+    def new(data, ccid=nil)
+        uuid = UUID.new
+        return self.post(uuid.generate(:compact), data, ccid=ccid)
+    end
+
+    def set(item, data, options={})
+        return self.post(item, data, options)
+    end
+
+    def delete(item, version=nil)
+        ccid = self._gen_ccid()
+        url = "#{@appname}/#{@bucket}/i/{item}"
+        
+        if version
+            url += "/v/#{version}"
+        end
+
+        url += "?clientid=#{@clientid}&ccid=#{ccid}"
+        response = self._request(url, data=nil, headers=_auth_header(), method='DELETE')
+        if response.body.strip.nil?
+            return ccid
+        end
+    end
+
+    def changes(options={})
+        defautls = {:cv=>nil, :timeout=>nil}
+        unless options.empty?
+            options = defaults.merge(options)
+        else
+            options = defaults
+        end
+
+        cv = option[:cv]
+        timeout = option[:timeout]
+
+        url = "#{@appname}/#{@bucket}/changes?clientid=#{@clientid}"
+        unless cv.nil?
+            url += "&cv=#{cv}"
+        end
+        headers = _auth_header()
+        
+        response = self._request(url, data=nil, headers=headers, method='GET', timeout=timeout)
+        return JSON.load(response.body)
+    end
+
+    def all(options={})
+        defaults = {:cv=>nil, :data=>nil, :username=>false, :most_recent=>false, :timeout=>nil}
+        unless options.empty?
+            options = defaults.merge(options)
+        else
+            options = defaults
+        end
+
+        cv = options[:cv]
+        data = options[:data]
+        username = options[:username]
+        most_recent = options[:most_recent]
+        timeout = options[:timeout]
+
+        url = "#{@appname}/#{@bucket}/all?clientid=#{@clientid}"
+        unless cv.nil?
+            url += "&cv=#{cv}"
+        end
+
+        if username
+            url += "&username=1"
+        end
+
+        if data
+            url += "&data=1"
+        end
+        
+        if most_recent
+            url += "&most_recent=1"
+        end
+        
+        headers = _auth_header()
+        
+        response = self._request(url, data=nil, headers=headers, method='GET', timeout=timeout)
+        return JSON.load(response.body)
+    end
+end
+
+class User
+    def initialize(appname, auth_token, options={})
+        defaults = {:host=>nil, :scheme=>'https', :clientid=>nil}
+        unless options.empty?
+            options = defaults.merge(options)
+        else
+            options = defaults
+        end
+
+        @bucket = Bucket.new(appname, auth_token, 'user',
+            options=options)
+
+        url = "#{appname}/user"
+        response = @bucket._request(url, data=nil, headers=@bucket._auth_header(), method='GET')
+        response = JSON.load(response.body)
+        @userid = response['userid']
+    end
+
+    def get
+        return @bucket.get(@userid)
+    end
+
+    def post(data)
+        @bucket.post(@userid, data)
+    end
+end
+
+class Api
+    def initialize(appname, auth_token, options={})
+        @appname = appname
+        @token = auth_token
+        @_options = options
+
+        @getitem = {}
+    end
+
+    def method_missing(method_sym, *arguments, &block)
+        #the first argument is a Symbol, so you need to_s it you want to pattern match
+        unless method_sym.to_s =~ /=$/
+            if method_sym.to_s == 'user'
+                @getitem[method_sym] ||= User.new(@appname, @token)
+            else
+                @getitem[method_sym] ||= Bucket.new(@appname, @token, method_sym)
+            end
+        end
+    end
+
+    def respond_to?(method_sym, include_private = false)
+        if method_sym.to_s =~ /^(.*)$/
+          true
+        else
+          super
+        end
+      end
+end
+
+class Admin < Api
+    def initialize(appname, admin_token, options={})
+        @appname = appname
+        @token = admin_token
+        @_options = options
+    end
+
+    def as_user(userid)
+        return Api.new(@appname, @token, userid=userid, @_options)
+    end
+end

data/lib/simperium/version.rb

@@ -0,0 +1,3 @@
+module Simperium
+  VERSION = '0.0.1'
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification 
+name: simperium
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Ray Ventura
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-06-19 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rest-client
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 1
+        - 4
+        version: "1.4"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: uuid
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: mongo
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id004
+description: Simperium moves data instantly and automatically everywhere it's needed.  See https://simperium.com for details.
+email: 
+- ray@simperium.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/simperium.rb
+- lib/simperium/version.rb
+homepage: https://simperium.com/docs/reference
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Ruby bindings for the Simperium API
+test_files: []
+