roomorama_api 0.1.0

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.DS_Store

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - "1.9.2"
+  - "1.9.3"
+  - jruby-19mode # JRuby in 1.9 mode
+  - rbx-19mode
+# uncomment this line if your project needs to run something other than `rake`:
+script: bundle exec rake test

data/CHANGELOG

@@ -0,0 +1,23 @@
+## v0.1.0
+
+* Initial release
+* Supports the following API calls
+	* destinations_all
+	* properties_find
+	* properties_get_data
+	* properties_find_similar
+	* properties_availabilities
+	* properties_price_check
+	* properties_reviews
+	* favorites_list
+	* favorites_create
+	* favorites_delete
+	* perks_list
+	* perks_get_data
+	* users_me
+	* users_update_profile
+	* users_get_data
+	* users_register
+	* users_reviews
+	* hosts_properties_list
+	* hosts_properties_show

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in roomorama_api.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2013 TM Lee
+
+MIT License
+
+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

@@ -0,0 +1,77 @@
+[![Build Status](https://travis-ci.org/tmlee/roomorama_api.png)](https://travis-ci.org/tmlee/roomorama_api)
+
+# RoomoramaApi
+
+RoomoramaApi is a Ruby gem that wraps the Roomorama API V1.0 documented at https://roomorama.com/api.
+
+For a step by step guide on getting started with Roomorama API, refer to https://roomorama.com/api/step_by_step.
+
+This gem does not handle OAuth authentication or token generation. You may want to use https://github.com/intridea/omniauth and the Roomorama OAuth strategy at https://github.com/roomorama/omniauth-roomorama
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'roomorama_api', :git => 'git@github.com:tmlee/roomorama_api.git'
+
+And then execute:
+
+    $ bundle
+
+
+## Usage
+
+Currently this gem does not handle any oauth authentication yet. Host and Guest API calls are not support yet in this version.
+
+### Initialize a client
+	
+	client = RoomoramaApi::Client.new
+
+### Initialize a client with OAuth token
+
+	client = RoomoramaApi::Client.new '<OAUTH TOKEN>'
+
+### Get all destinations
+
+	client.destinations_all
+
+### Search for properties/rooms
+
+	client.properties_find destination: 'singapore'
+	client.properties_find destination: 'singapore', order: 'title_asc'
+
+### Get data for a give property/room
+
+	client.properties_get_data 500, strip_html: 'false'
+
+
+### Make OAuth calls - get information about myself
+
+	client.user_me
+
+### Supported API Calls
+
+	destinations_all
+	properties_find
+	properties_get_data
+	properties_find_similar
+	properties_availabilities
+	properties_price_check
+	properties_reviews
+	favorites_list
+	favorites_create
+	favorites_delete
+	perks_list
+	perks_get_data
+	users_me
+	users_update_profile
+	users_get_data
+	users_register
+	users_reviews
+	hosts_properties_list
+	hosts_properties_show
+
+### Can't find the API Call you want?
+
+	Submit an issue or a pull request.
+	

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+require 'rake/testtask'
+
+
+Rake::TestTask.new do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.test_files = FileList['test/*_test.rb']
+  t.verbose = true
+end
+task :default => :test

data/lib/roomorama_api/version.rb

@@ -0,0 +1,3 @@
+module RoomoramaApi
+  VERSION = "0.1.0"
+end

data/lib/roomorama_api.rb

@@ -0,0 +1,182 @@
+require "roomorama_api/version"
+require "faraday"
+require "json"
+
+module RoomoramaApi
+
+	class Client
+
+		def initialize(oauth_token=nil)
+			@oauth_token == ''
+			@oauth_token = oauth_token if oauth_token
+		end
+
+
+		BASE_URL = 'https://api.roomorama.com/'
+		API_VERSION = 'v1.0'
+
+		### Destinations
+
+		def destinations_all(options={})
+			api_call "destinations", options
+		end
+
+		#### Properties
+
+		def properties_find(options={})
+			api_call "rooms", options
+		end
+
+		def properties_get_data(room_id, options={})
+			api_call "rooms/" + room_id.to_s, options
+		end
+
+		def properties_find_similar(room_id, options={})
+			api_call "rooms/" + room_id.to_s + "/similar", options
+		end
+
+		def properties_availabilities(room_id, options={})
+			api_call "rooms/" + room_id.to_s + "/availabilities", options
+		end
+
+		def properties_price_check(room_id, options={})
+			api_call "inquiries/new.json", options.merge(room_id: room_id)
+		end
+
+		def properties_reviews(room_id, options={})
+			api_call "rooms/" + room_id.to_s + "/reviews", options
+		end
+
+
+		#### Favorites
+
+		def favorites_list(options = {})
+			api_call "favorites", options
+		end
+
+		def favorites_create(options = {})
+			api_call "favorites", options, :post
+		end
+
+		def favorites_delete(id, options = {})
+			api_call "favorites/" + id.to_s, options, :delete
+		end
+
+		#### Perks
+
+		def perks_list(options={})
+			api_call "perks", options
+		end
+
+		def perks_get_data(perk_id, options={})
+			api_call "perks/" + perk_id.to_s, options
+		end
+
+		#### Users
+
+		def users_me(options={})
+			api_call "me", options
+		end
+
+		def users_update_profile(options={})
+			api_call "me", options, :put
+		end
+
+		def users_get_data(user_id, options={})
+			api_call "users/" + user_id.to_s, options
+		end
+
+		def users_register(options={})
+			api_call "users", options, :post
+		end
+
+		def users_reviews(user_id, options={})
+			api_call "users/" + user_id.to_s + "/reviews", options
+		end
+
+		#### Hosts/Properties
+
+		def hosts_properties_list(options={})
+			api_call "host/rooms", options
+		end
+
+		def hosts_properties_show(room_id, options={})
+			api_call "host/rooms/" + room_id.to_s, options
+		end
+
+
+		private
+
+		def api_url
+			BASE_URL + API_VERSION + '/'
+		end
+
+		def api_call(method_name, options, verb=:get)
+			response = connection(method_name, options, verb)
+			parse_response response
+		end
+
+		def parse_response(response)
+			raise_errors response
+			if response.body == " "
+				{}
+			else
+				JSON.parse response.body
+			end
+		end
+
+		def connection(method_name, options, verb)
+
+			conn = Faraday.new(:url => api_url) do |faraday|
+				faraday.request  :url_encoded
+  				#faraday.response :logger
+  				faraday.adapter  Faraday.default_adapter
+  				faraday.headers['Authorization'] = "Bearer " + @oauth_token
+			end
+
+			if verb == :put
+				response = conn.put(method_name, options)
+			elsif verb == :post
+				response = conn.post(method_name, options)
+			elsif verb == :delete
+				response = conn.delete(method_name)
+			else
+				response = conn.get(method_name + "?" + to_query_params(options))
+			end
+		end
+
+
+		def to_query_params(options)
+			options.collect { |key, value| "#{key}=#{value}" }.join('&')
+		end
+
+		def raise_errors(response)
+      		message = "(#{response.status})"
+      		
+      		case response.status.to_i
+      		  when 400
+      		    raise BadRequest, message
+      		  when 401
+      		    raise Unauthorized, message
+      		  when 403
+      		    raise General, message
+      		  when 404
+      		    raise NotFound, message
+      		  when 500
+      		    raise InternalError, "An internal error is thrown."
+      		  when 502..503
+      		    raise Unavailable, message
+      		end
+    	end
+
+	end
+
+
+	class BadRequest < StandardError; end
+  	class Unauthorized      < StandardError; end
+  	class General           < StandardError; end
+  	class Unavailable       < StandardError; end
+  	class InternalError     < StandardError; end
+  	class NotFound          < StandardError; end
+
+end

data/roomorama_api.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/roomorama_api/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["TM Lee"]
+  gem.email         = ["tm89lee@gmail.com"]
+  gem.description   = %q{Ruby wrapper to call Roomorama API V1.0 at https://roomorama.com/api. For a step by step guide on getting started with Roomorama API, refer to https://roomorama.com/api/step_by_step.}
+  gem.summary       = %q{Ruby wrapper to call Roomorama API V1.0}
+  gem.homepage      = "https://github.com/tmlee/roomorama_api"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "roomorama_api"
+  gem.require_paths = ["lib"]
+  gem.version       = RoomoramaApi::VERSION
+
+  gem.add_dependency('faraday', '~> 0.8')
+  gem.add_dependency('json', '~> 1.7.7')
+  gem.add_development_dependency('fakeweb', "~> 1.3.0")
+  gem.add_development_dependency('rake')
+
+end