rubervu 0.1

data/README

@@ -0,0 +1,55 @@
+= Rubervu: Gem for accessing the UberVU.com API.
+
+See http://rubervu.rubyforge.org/ for more information.
+
+Version 0.1.
+
+== Basic Usage
+
+
+=== Installation
+    gem install rubervu
+
+=== Usage
+
+   ubervu = Rubervu::Ubervu.new('API_KEY')
+
+   # Get information about a specific URL
+   result = ubervu.resources.show(url)
+
+   # Add a new resource
+   result = ubervu.resources.create(url)
+
+   # Add a batch of new resources
+   result = ubervu.resources.create_batch([ url1, url2, url3 ])
+
+== License
+
+Copyright (c) 2009, Radu Spineanu
+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.
+
+Neither the name of the original author nor the names of contributors
+may 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 THE COPYRIGHT OWNER OR CONTRIBUTORS 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/lib/rubervu/ubervu.rb

@@ -0,0 +1,95 @@
+# Copyright (c) 2009 Radu Spineanu
+# You can redistribute it and/or modify it under the same terms as Ruby.
+#
+
+module Rubervu
+
+  # Main Ubervu Class
+  # You use it by doing the following:
+  #          ubervu = Rubervu::Ubervu.new('API_KEY')
+  #
+  # Next you can call the Ubervu subclasses like:
+  #          result = ubervu.resources.show(url)
+  #
+  class Ubervu
+    # Initializes the Ubervu Class.
+    def initialize(api_key, api_url = 'http://api.ubervu.com')
+      @api_key    = api_key
+      @api_url    = api_url
+    end
+
+    # Maps UbervuResource. See UbervuResource for more information about methods.
+    def resources
+      UbervuResource.new(@api_key, @api_url)
+    end
+
+    # Processes the request. Creates the API call and returns a JSON parsed result.
+    def request(resource, function, params, method = 'get', post_data = nil, api_key = @api_key, api_url = @api_url)
+      rq = "#{api_url}/#{API_VER}/#{resource}/#{function}?apikey=#{CGI.escape api_key}&format=#{CGI.escape FORMAT}"
+
+      if params and params.size > 0 
+        params.each_pair do |key, value|
+          rq += "&#{key}=#{CGI.escape value}"
+        end
+      end
+   
+      new_post_data = []
+      if post_data and post_data.size > 0
+        post_data.each_pair do |key, value|
+          new_post_data.push("#{key}=#{CGI.escape value}")
+        end
+      end
+      post_data = new_post_data.join('&')
+
+      result = case method
+                 when 'get'
+                   get(rq)
+                 when 'post'
+                   post(rq, post_data)
+                 when 'put'
+                   put(rq, post_data)
+                 when 'delete'
+                   delete(rq)
+               end
+
+      case result
+        when Net::HTTPSuccess
+          JSON.parse(result.body)
+        else
+          result.error!
+      end
+    end
+
+    private
+
+    def delete(uri)
+      call(Net::HTTP::Delete.new(uri), uri)
+    end
+
+    def get(uri)
+      call(Net::HTTP::Get.new(uri), uri)
+    end
+
+    def put(uri, post_data)
+      req = Net::HTTP::Put.new(uri)
+      req.body = post_data
+      call(req, uri)
+    end
+
+    def post(uri, post_data)
+      req = Net::HTTP::Post.new(uri)
+      req.body = post_data
+      call(req, uri)
+    end
+
+    def call(req, uri)
+      uri = URI.parse(uri)
+      res = Net::HTTP.start(uri.host, uri.port) do |http|
+        http.request(req)
+      end
+
+      res
+    end
+
+  end
+end

data/lib/rubervu/ubervu_resource.rb

@@ -0,0 +1,57 @@
+# Copyright (c) 2009 Radu Spineanu
+# You can redistribute it and/or modify it under the same terms as Ruby.
+#
+
+module Rubervu
+
+  # This class creates API calls for different Resource functions.
+  # How to Use:
+  #          ubervu = Rubervu::Ubervu.new('API_KEY')
+  #          result = ubervu.resources.show(url)
+  #
+  class UbervuResource < Ubervu
+
+    # Initializes the UbervuResource Class.
+    def initialize(api_key, api_url = 'http://api.ubervu.com')
+      @api_key    = api_key
+      @api_url    = api_url
+      @resource   = 'resources'
+    end
+
+    # Get information about a specific URL
+    # http://developer.ubervu.com/docs/api_methods/Get_information_about_a_specific_URL
+    # url:String
+    def show url
+      function = ''
+ 
+      params = {}
+      params[:url] = url
+
+      request(@resource, function, params)
+    end
+
+    # Add a new resource
+    # http://developer.ubervu.com/docs/api_methods/Add_a_new_resource
+    # url:String
+    def create url
+      function = ''
+      
+      post_data = {}
+      post_data[:url] = url
+
+      request(@resource, function, nil, 'post', post_data)
+    end
+
+    # Add a batch of new resources
+    # http://developer.ubervu.com/docs/api_methods/Add_a_batch_of_new_resources
+    # urls:Array of urls
+    def create_batch urls
+      function = 'batch/'
+
+      post_data = {}
+      post_data[:urls] = urls.join(',')
+
+      request(@resource, function, nil, 'post', post_data)
+    end
+  end
+end

data/lib/rubervu.rb

@@ -0,0 +1,19 @@
+# Copyright (c) 2009 Radu Spineanu
+# You can redistribute it and/or modify it under the same terms as Ruby.
+#
+
+require 'rubygems'
+require 'digest/md5'
+require "cgi"
+require 'net/http'
+require 'json'
+require 'json/ext'
+
+# Rubervu module contains a Rubervu connection class and different Rubervu Classes
+module Rubervu
+  FORMAT      = "json"
+  API_VER     = "1.0"
+end
+
+require 'rubervu/ubervu'
+require 'rubervu/ubervu_resource'

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+name: rubervu
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+platform: ruby
+authors: 
+- Radu Spineanu
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-05-08 00:00:00 +03:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: 
+email: radu @nospam@ rdconcept.ro
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- lib/rubervu.rb
+- lib/rubervu/ubervu.rb
+- lib/rubervu/ubervu_resource.rb
+- README
+has_rdoc: true
+homepage: 
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: Gem for accessing the UberVU.com API.
+test_files: []
+