bistip 0.0.4

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/*
+*.gem
+.bundle

data/Gemfile

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

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Agung Prasetyo
+
+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.rdoc

@@ -0,0 +1,47 @@
+= bistip
+
+Get tip for your trip! A full-stack Bistip.com API wrapper in Ruby.
+
+== Instalation
+
+  gem install bistip
+
+== Features:
+
+* Easy to fetch data from bistip API with searching trips and searching wanted post function, that specified by some parameter, like <b>:from</b> and <b>:to</b>, optional parameter like <b>:page</b> and <b>:per_page</b> to control pagination
+* (Optional) You can control result number with pagination using <b>:page</b> and <b>:per_page</b> properties. By default :page value is 1 and :per_page value is 10
+
+
+== Examples
+
+Now bistip ruby gem supports all objects listed here: http://www.bistip.com/api
+
+=== GET
+==== Searching for trips or wanted_post
+
+  # trips from jakarta to osaka
+  Bistip::trips({ :from => 'jakarta', :to => 'Osaka'})
+  
+  # trips from yogyakarta
+  Bistip::trips({ :from => 'yogyakarta' })
+
+  # wanted post from jakarta with pagination (optional, default
+  Bistip::seeks({ :from => 'jakarta', :page => 1, :per_page => 20})
+
+
+Every method will generate array of hash where the array element would have structure like :
+
+    trip: {
+      origin_location: "city, country",
+      notes: "lorem ipsum dolor sit amet",
+      period: null,
+      username: "foo",
+      arrival_date_medium_format: "2011-10-10",
+      departure_date_medium_format: "2011-10-09",
+      id: 742,
+      day: null,
+      routine: false,
+      destination_location: "Jakarta, Indonesia"
+    }
+
+And will generate an empty array if no trips/seeks found in bistip specified by parameter

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/bistip.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "bistip/version"
+
+Gem::Specification.new do |s|
+  s.name        = "bistip"
+  s.version     = Bistip::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Agung Prasetyo"]
+  s.email       = ["brain64bit@gmail.com"]
+  s.extra_rdoc_files = ["MIT-LICENSE","README.rdoc"]
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.homepage    = "http://kav1nsky.wordpress.com"
+  s.summary     = %q{A Ruby wrapper based on Bistip.com API}
+  s.description = %q{Ruby wrapper that consume Bistip.com REST API, for searching trips and searching wanted post specified by some parameter}
+  s.date = Time.now.utc.strftime("%A, %d% %B %Y")
+  s.rubyforge_project = "bistip"
+  
+  s.add_dependency "httparty", "= 0.7.8"
+
+  s.post_install_message = "Get tip for your trip"
+  
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+end

data/lib/bistip.rb

@@ -0,0 +1,50 @@
+require 'httparty'
+
+module Bistip
+  include HTTParty
+  # Your code goes here...
+  
+  base_uri 'http://www.bistip.com'
+
+  API_VERSION = '/api/v1'
+  SEARCH_TRIP = '/trips.json'
+  SEARCH_SEEK = '/seeks.json'
+  DEFAULT_PER_PAGE = 10
+  DEFAULT_PAGE = 1
+  
+  def self.trips(params={})
+  	check_params(params)
+  	from = params[:from] if params[:from]
+  	to = params[:to] if params[:to]
+  	per_page = params[:per_page].nil? ? DEFAULT_PER_PAGE : params[:per_page]
+  	page = params[:page].nil? ? DEFAULT_PAGE : params[:page]
+  	
+  	result = get("#{API_VERSION+SEARCH_TRIP}?from=#{from}&to=#{to}&page=#{page}&per_page=#{per_page}")
+	result = result.first.include?("exception") ? Array.new : result
+	return result
+  end
+  
+  def self.seeks(params={})
+  	check_params(params)
+  	from = params[:from] if params[:from]
+  	to = params[:to] if params[:to]
+  	per_page = params[:per_page].nil? ? DEFAULT_PER_PAGE : params[:per_page]
+  	page = params[:page].nil? ? DEFAULT_PAGE : params[:page]
+  	
+  	result = get("#{API_VERSION+SEARCH_SEEK}?from=#{from}&to=#{to}&page=#{page}&per_page=#{per_page}")
+	result = result.first.include?("exception") ? Array.new : result
+	return result
+  end
+  
+  private
+  
+  	def self.check_params(params)
+  		raise ArgumentError, 'parameters must be a hash' unless params.is_a?(Hash)
+  		raise ArgumentError, 'parameters can not be empty' unless !params.empty?
+  		raise ArgumentError, 'parameters should contain :from and/or :to properties' unless params.keys.include?(:from) or params.keys.include?(:to)
+  		
+  		raise ArgumentError, ':page must be an integer' unless params[:page].is_a?(Integer) if params[:page]
+  		raise ArgumentError, ':per_page must be an integer' unless params[:per_page].is_a?(Integer) if params[:per_page]
+  	end
+  
+end

data/lib/bistip/version.rb

@@ -0,0 +1,3 @@
+module Bistip
+  VERSION = "0.0.4"
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification 
+name: bistip
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 4
+  version: 0.0.4
+platform: ruby
+authors: 
+- Agung Prasetyo
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-19 00:00:00 +07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 0
+        - 7
+        - 8
+        version: 0.7.8
+  type: :runtime
+  version_requirements: *id001
+description: Ruby wrapper that consume Bistip.com REST API, for searching trips and searching wanted post specified by some parameter
+email: 
+- brain64bit@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- MIT-LICENSE
+- README.rdoc
+files: 
+- .gitignore
+- Gemfile
+- Rakefile
+- bistip.gemspec
+- lib/bistip.rb
+- lib/bistip/version.rb
+- MIT-LICENSE
+- README.rdoc
+has_rdoc: true
+homepage: http://kav1nsky.wordpress.com
+licenses: []
+
+post_install_message: Get tip for your trip
+rdoc_options: 
+- --charset=UTF-8
+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: bistip
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A Ruby wrapper based on Bistip.com API
+test_files: []
+