ripe_db_client 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a2d9a0e460815225826d0477b9f3619b01a58cad
+  data.tar.gz: 59e8b4e5152248880a9c0e9505fbdd415f0b93e5
+SHA512:
+  metadata.gz: 0abb331a66f8f8994a575ae5994c88292fb7e5e1368a8eb4f4df2b592db9f0babd3890f32529a42025745f2cce569f3711465b087c2f1d410618ef3d5f227b4b
+  data.tar.gz: 2bad54d84436f52abd81a6973d2b5e054e0823715cf4a42304f62ea58f1a37b92a0d488dfb1f4e75beb383234785aa400deca6adb04d86273e62d8a1267d967b

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
+.idea

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/.ruby-gemset

@@ -0,0 +1 @@
+GEM_RDB

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.0.0-p0

data/.rvmrc

@@ -0,0 +1 @@
+rvm use `cat .ruby-version`@`cat .ruby-gemset`

data/.travis.yml

@@ -0,0 +1,18 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0
+  - ree
+  - jruby-19mode
+  - jruby-18mode
+  - rbx-18mode
+  - rbx-19mode
+matrix:
+  allow_failures:
+    - rvm: rbx-18mode
+    - rvm: jruby-18mode
+    - rvm: jruby-19mode
+
+
+script: "bundle exec rake"

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Mike Simkins
+
+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,53 @@
+[![Gem Version][GV img]][Gem Version]
+[![Build Status][BS img]][Build Status]
+[![Dependency Status][DS img]][Dependency Status]
+[![Coverage Status][CS img]][Coverage Status]
+
+[Gem Version]: https://rubygems.org/gems/ripe_db_client
+[Build Status]: https://travis-ci.org/msimkins/RipeDbClient
+[travis pull requests]: https://travis-ci.org/msimkins/RipeDbClient/pull_requests
+[Dependency Status]: https://gemnasium.com/msimkins/RipeDbClient
+[Coverage Status]: https://coveralls.io/r/msimkins/RipeDbClient
+
+[GV img]: https://badge.fury.io/rb/RipeDbClient.png
+[BS img]: https://travis-ci.org/msimkins/RipeDbClient.png
+[DS img]: https://gemnasium.com/msimkins/RipeDbClient.png
+[CS img]: https://coveralls.io/repos/msimkins/RipeDbClient/badge.png?branch=master
+
+# RipeDbClient
+
+This GEM is an interface to the RIPE Database API, using their RESTFUL access service
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'ripe_db_client'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ripe_db_client
+
+## Usage
+
+### Create a Client Object
+
+    client = RipeDbClient::Query.new
+
+### Lookup a database object by type, and reference
+
+    some_hash = client.lookup('mntner','RIPE-DBM-MNT')
+
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,19 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require 'yard'
+
+RSpec::Core::RakeTask.new do |t|
+
+end
+
+YARD::Rake::YardocTask.new do |t|
+	t.files   = ['lib/**/*.rb']
+	t.options = [
+			'--protected',
+			'--title', 'RipeDbClient'
+	]
+end
+
+task :docs => :yard
+task :default => :spec
+task :test => :spec

data/lib/ripe_db_client.rb

@@ -0,0 +1,5 @@
+require 'ripe_db_client/version'
+require 'ripe_db_client/exceptions'
+require 'httparty'
+require 'ripe_db_client/query_client'
+require 'ripe_db_client/query_and_parse'

data/lib/ripe_db_client/exceptions.rb

@@ -0,0 +1,83 @@
+module RipeDbClient
+
+  #
+  # Error Class - Inherits from Standard Error
+  #
+  # @author Mike Simkins
+  #
+  class Error < StandardError
+  end
+
+
+  # This error is raised when a user has not specified a value for a mandatory parameter
+  #
+  #   raise RipeDbClient::BadParameter.new("search parameter missing", "dblookup")
+  #
+  # The passed message, action, and subject are optional and can later be retrieved when
+  # rescuing from the exception.
+  #
+  #   exception.message # => "search parameter missing"
+  #   exception.action # => "dblookup"
+  #
+  # If the message is not specified (or is nil) it will default to "You have an Invalid or Missing Parameter"
+  # This default can be overridden by setting default_message.
+  #
+  #   exception.default_message = "Default error message"
+  #   exception.message # => "Default error message"
+  #
+  #
+  # @author Mike Simkins
+  #
+  class BadParameter < Error
+    attr_reader :action, :subject
+    attr_writer :default_message
+
+    def initialize (message = nil, action = nil, subject = nil)
+      @message = message
+      @action = action
+      @subject = subject
+      @default_message = "You have an Invalid or Missing Parameter"
+    end
+
+
+    # @return [String] Returns the error message
+    def to_s
+      @message || @default_message
+    end
+  end
+
+  # This error is raised when a user tries to access an unsupported function
+  #
+  #   raise RipeDbClient::Unsupported.new("my secret feature", "top secret")
+  #
+  # The passed message, action, and subject are optional and can later be retrieved when
+  # rescuing from the exception.
+  #
+  #   exception.message # => "my secret feature"
+  #   exception.action # => "top_secret"
+  #
+  # If the message is not specified (or is nil) it will default to "The feature you require is not currently supported"
+  # This default can be overridden by setting default_message.
+  #
+  #   exception.default_message = "Default error message"
+  #   exception.message # => "Default error message"
+  #
+  # @author Mike Simkins
+  #
+  class Unsupported < Error
+    attr_reader :action, :subject
+    attr_writer :default_message
+
+    def initialize (message = nil, action = nil, subject = nil)
+      @message = message
+      @action = action
+      @subject = subject
+      @default_message = "The feature you require is not currently supported"
+    end
+
+    # @return [String] Returns the error message
+    def to_s
+      @message || @default_message
+    end
+  end
+end

data/lib/ripe_db_client/query_and_parse.rb

@@ -0,0 +1,34 @@
+module RipeDbClient
+  class Query
+
+    #
+    # Look up the exact value of the key/value pair
+    # @param lookup_key [String]
+    #   This is the name of the person you are doing the lookup for
+    # @param return_raw [Boolean]
+    #   Set this to true to return the RAW(Unparsed) Hash
+    #
+    # @example  lookup_person("MPS31-RIPE")
+    #
+    # @return [Hash] The Hash of values for the returned object
+    #
+
+    def lookup_person(lookup_key,return_raw = false)
+      local_result = self.lookup('person', "#{lookup_key}")
+      if return_raw
+        return local_result
+      else
+        return person_parser(local_result)
+      end
+
+    end
+
+
+
+    private
+
+    def person_parser(returned_hash)
+
+    end
+  end
+end

data/lib/ripe_db_client/query_client.rb

@@ -0,0 +1,117 @@
+#
+# RipeDbClient - An Interface to the RIPE Database RESTful services
+#
+# @author Mike Simkins
+#
+module RipeDbClient
+
+	#
+	# Query: The class encapsulating all query methods on the RIPE REST Database service
+	#
+	# @author Mike Simkins
+	#
+	class Query
+
+		# @param  api_key[String] API Key generated from the RIPE DB Portal
+		# @param  api_environment [String] Either 'production' or 'test'
+		# @param  base_query_path [String] URI Path (do not include http:// or https:// )
+		#
+		# @return [Object] Returns the Client Instance
+		#
+		def initialize(api_key = nil, api_environment = nil ,base_query_path = 'apps.db.ripe.net/whois')
+			@auth_key = api_key
+			@app_environment = api_environment || 'test'
+			@base_query_path = base_query_path
+			self.set_secure_queries(false)
+			self.set_data_source('ripe')
+		end
+
+
+		# The set_data_source function allows you to manually set a database source to query for the object.
+		#
+		# @param  sourceid [String] The Registry source to query - Currently supports  RIPE, AFriNic, and APnic
+		#
+		# @return [String] The new Source Registry
+		#   If the passed parameters are invalid, then the method throws a RipeDbClient::Unsupported
+		#   exception
+		def set_data_source(sourceid)
+			if %w(ripe afrinic apnic).include? sourceid.downcase
+				@source_registry = sourceid
+			else
+				raise RipeDbClient::Unsupported.new('The only Supported registries are RIPE, AFRINIC, and APNIC', 'set_data_source')
+			end
+		end
+
+		# The source_registry? function allows you to manually set a database source to query for the object.
+		#
+		# @return [String] The new Source Registry
+		#   If the passed parameters are invalid, then the method throws a RipeDbClient::Unsupported
+		#   exception
+		def source_registry?
+			@source_registry
+		end
+
+
+		#
+		# As standard, queries are performed over the HTTP protocol. If you pass a true value to this function,
+		# it will use queries over HTTPS
+		# @param  secure_mode [Boolean] Enable queries over HTTPS
+		# @return [String] - The current access URI
+		def set_secure_queries(secure_mode)
+			if secure_mode
+				@base_query_uri = 'https://' + @base_query_path
+			else
+				@base_query_uri = 'http://' + @base_query_path
+			end
+			@base_query_uri
+		end
+
+		#
+		# Check tp see if we are performing queries over https
+		# @return [Boolean] - If we are currently using https
+		def secure_queries?
+			@base_query_uri.include? 'https://'
+		end
+
+
+		#
+		# Returns a hash of all the data sources supported by the REST Client Interface
+		#
+		# @return [Hash] The Raw Hash of supported data sources
+		#
+		def get_supported_data_sources
+			service_url = "#{@base_query_uri}/sources.json"
+			response = HTTParty.get(service_url)
+			response
+		end
+
+
+		#
+		# Look up the exact value of the key/value pair
+		# @param  lookup_key [String]
+		#   This is the object type you are looking for. This should be currently one of the RIPE
+		#   database supported types ('person', 'mntner','abuse-c'....)
+		# @param  lookup_value [String] The actual key you are looking for ('RIPE-DBM-MNT')
+		# @param  lookup_source [String] The optional registry to use if it is not the default, or current registry
+		#
+		# @example  lookup("mntner","RIPE-DBM-MNT")
+		# @example  lookup("person","RIPE-DBM-MNT")
+		#
+		# @return [Hash] The Hash of values for the returned object
+		#
+		def lookup(lookup_key, lookup_value, lookup_source = nil)
+			if lookup_key.nil? || lookup_key.empty?
+				raise RipeDbClient::BadParameter.new('lookup_key cannot be empty, or nil', 'lookup')
+			end
+			if lookup_value.nil? || lookup_value.empty?
+				raise RipeDbClient::BadParameter.new('lookup_value cannot be empty, or nil', 'lookup')
+			end
+			if  lookup_source.nil? || lookup_source.empty?
+				lookup_source = @source_registry
+			end
+			service_url = "#{@base_query_uri}/lookup/#{lookup_source.downcase}/#{lookup_key.downcase}/#{lookup_value}.json"
+			response = HTTParty.get(service_url)
+			response
+		end
+	end
+end

data/lib/ripe_db_client/version.rb

@@ -0,0 +1,4 @@
+module RipeDbClient
+  # Gem version number
+  VERSION = "0.0.2"
+end

data/ripe_db_client.gemspec

@@ -0,0 +1,36 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ripe_db_client/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'ripe_db_client'
+  spec.version       = RipeDbClient::VERSION
+  spec.authors       = ['Mike Simkins']
+  spec.email         = ['software@g7obs.com']
+  spec.description   = %q{Programatical Interface to the RIPE Database API (REST Client) - THIS IS NOT YET READY FOR PRIME TIME}
+  spec.summary       = %q{This provides a number of methods to query the RIPE Database, or to Update the Database }
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  # RubyForge info
+  spec.homepage = 'http://ripedbclient.rubyforge.org'
+  spec.rubyforge_project = 'ripedbclient'
+
+  spec.add_development_dependency 'bundler', '~> 1.3.0'
+  spec.add_development_dependency 'rake', '~> 10.0.0'
+  spec.add_development_dependency 'rspec', '~> 2.12.0'
+  spec.add_development_dependency 'yard', '~> 0.8.0'
+  spec.add_development_dependency 'redcarpet', '~> 2.2.0'
+  spec.add_development_dependency 'vcr', '~> 2.4.0'
+  spec.add_development_dependency 'webmock', '~> 1.10.0'
+  spec.add_development_dependency 'simplecov', '~> 0.7.0'
+  spec.add_development_dependency 'coveralls', '~> 0.6.0'
+
+  spec.add_dependency 'httparty', '~> 0.11.0'
+  spec.add_dependency 'hashie', '~> 2.0.0'
+end

data/spec/fixtures/vcr_cassettes/data_sources_object.yml

@@ -0,0 +1,28 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: http://apps.db.ripe.net/whois/sources.json
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers: {}
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Mon, 15 Apr 2013 14:34:35 GMT
+      Content-Type:
+      - application/json
+      Connection:
+      - close
+      Transfer-Encoding:
+      - chunked
+    body:
+      encoding: UTF-8
+      string: "{\n\t\t\"whois-resources\":{\n\t\t\"service\":\"getSupportedDataSources\",\n\t\t\"link\":{\n\t\t\"xlink:type\":\"locator\",\n\t\t\"xlink:href\":\"http://apps.db.ripe.net/whois/sources\"}\n\t\t,\n\t\t\"sources\":{\n\t\t\"source\":[\n\t\t{\n\t\t\"name\":\"RIPE\",\n\t\t\"id\":\"ripe\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"APNIC\",\n\t\t\"id\":\"apnic\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"AfriNIC\",\n\t\t\"id\":\"afrinic\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"TEST\",\n\t\t\"id\":\"test\"}\n\t\t]\n\t\t}\n\t\t,\n\t\t\"grs-sources\":{\n\t\t\"source\":[\n\t\t{\n\t\t\"name\":\"RIPE-GRS\",\n\t\t\"id\":\"ripe-grs\",\n\t\t\"grs-id\":\"ripe-grs\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"AFRINIC-GRS\",\n\t\t\"id\":\"afrinic-grs\",\n\t\t\"grs-id\":\"afrinic-grs\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"APNIC-GRS\",\n\t\t\"id\":\"apnic-grs\",\n\t\t\"grs-id\":\"apnic-grs\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"ARIN-GRS\",\n\t\t\"id\":\"arin-grs\",\n\t\t\"grs-id\":\"arin-grs\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"LACNIC-GRS\",\n\t\t\"id\":\"lacnic-grs\",\n\t\t\"grs-id\":\"lacnic-grs\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"JPIRR-GRS\",\n\t\t\"id\":\"jpirr-grs\",\n\t\t\"grs-id\":\"jpirr-grs\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"RADB-GRS\",\n\t\t\"id\":\"radb-grs\",\n\t\t\"grs-id\":\"radb-grs\"}\n\t\t]\n\t\t}\n\t\t}\n\t\t}\n\t\t"
+    http_version: 
+  recorded_at: Mon, 15 Apr 2013 14:34:35 GMT
+recorded_with: VCR 2.4.0

data/spec/fixtures/vcr_cassettes/person_object.yml

@@ -0,0 +1,38 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: http://apps.db.ripe.net/whois/lookup/ripe/person/MPS31-RIPE.json
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers: {}
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Mon, 15 Apr 2013 12:57:07 GMT
+      Content-Type:
+      - application/json
+      Connection:
+      - close
+      Transfer-Encoding:
+      - chunked
+    body:
+      encoding: UTF-8
+      string: "{\n\t\t\"whois-resources\":{\n\t\t\"service\":\"lookup\",\n\t\t\"xsi:noNamespaceSchemaLocation\":\"http://apps.db.ripe.net/whois/xsd/whois-resources.xsd\",\n\t\t\"link\":{\n\t\t\"xlink:type\":\"locator\",\n\t\t\"xlink:href\":\"http://apps.db.ripe.net/whois/lookup/ripe/person/MPS31-RIPE.json\"}\n\t\t,\n\t\t\"objects\":{\n\t\t\"object\":{\n\t\t\"type\":\"person\",\n\t\t\"link\":{\n\t\t\"xlink:type\":\"locator\",\n\t\t\"xlink:href\":\"http://apps.db.ripe.net/whois/lookup/ripe/person/MPS31-RIPE\"}\n\t\t,\n\t\t\"source\":{\n\t\t\"id\":\"ripe\"}\n\t\t,\n\t\t\"primary-key\":{\n\t\t\"attribute\":{\n\t\t\"name\":\"nic-hdl\",\n\t\t\"value\":\"MPS31-RIPE\"}\n\t\t}\n\t\t,\n\t\t\"attributes\":{\n\t\t\"attribute\":[\n\t\t{\n\t\t\"name\":\"person\",\n\t\t\"value\":\"Mike
+        Simkins\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"address\",\n\t\t\"value\":\"SunGard
+        Availability Services\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"address\",\n\t\t\"value\":\"Lighterman
+        House\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"address\",\n\t\t\"value\":\"3 Clove
+        Crescent\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"address\",\n\t\t\"value\":\"London
+        E14 2BB\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"phone\",\n\t\t\"value\":\"+44 (0)
+        20 8080 8060\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"e-mail\",\n\t\t\"value\":\"mike.simkins@sungard.com\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"notify\",\n\t\t\"value\":\"mike.simkins@sungard.com\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"nic-hdl\",\n\t\t\"value\":\"MPS31-RIPE\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"mnt-by\",\n\t\t\"value\":\"CWS-RIPE-MNT\",\n\t\t\"referenced-type\":\"mntner\",\n\t\t\"link\":{\n\t\t\"xlink:type\":\"locator\",\n\t\t\"xlink:href\":\"http://apps.db.ripe.net/whois/lookup/ripe/mntner/CWS-RIPE-MNT\"}\n\t\t}\n\t\t,\n\t\t{\n\t\t\"name\":\"changed\",\n\t\t\"value\":\"mike.simkins@sungard.com
+        20040817\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"changed\",\n\t\t\"value\":\"mike.simkins@sungard.com
+        20060717\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"changed\",\n\t\t\"value\":\"mike.simkins@sungard.com
+        20061227\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"changed\",\n\t\t\"value\":\"mike.simkins@sungard.com
+        20130111\"}\n\t\t,\n\t\t{\n\t\t\"name\":\"source\",\n\t\t\"value\":\"RIPE\"}\n\t\t]\n\t\t}\n\t\t}\n\t\t}\n\t\t}\n\t\t}\n\t\t"
+    http_version: 
+  recorded_at: Mon, 15 Apr 2013 12:57:07 GMT
+recorded_with: VCR 2.4.0

data/spec/query_and_parse_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+
+describe RipeDbClient do
+
+  before(:each) do
+    @client = RipeDbClient::Query.new('test', 'test')
+  end
+
+  describe 'RipeDbClient::Query Object'  do
+    describe 'Query and Parse Functions' do
+      describe 'Person Object' do
+
+         it 'SHOULD be able to look up a RAW PERSON record' do
+           VCR.use_cassette('person_object') do
+            response = @client.lookup_person('MPS31-RIPE', true)
+            response.should_not be_nil
+           end
+         end
+
+        it 'SHOULD be able to provide a COOKED PERSON record' do
+          VCR.use_cassette('person_object') do
+            response = @client.lookup_person('MPS31-RIPE', false)
+            response.should be_nil
+          end
+        end
+
+      end
+
+    end
+
+  end
+
+end

data/spec/ripe_db_client_spec.rb

@@ -0,0 +1,78 @@
+require 'spec_helper'
+
+
+describe RipeDbClient do
+
+  before(:each) do
+    @client = RipeDbClient::Query.new('test', 'test')
+  end
+
+  describe "RipeDbClient::Query Object"  do
+
+	  it "SHOULD create a new client" do
+			c = RipeDbClient::Query.new
+		  c.should_not be_nil
+	  end
+
+	  it "SHOULD default to the RIPE registry on creation" do
+		  c = RipeDbClient::Query.new
+		  c.source_registry?.should == "ripe"
+	  end
+
+	  it "SHOULD change the registry if you call the set_data_source function with a valid registry" do
+		  c = RipeDbClient::Query.new
+		  c.source_registry?.should == "ripe"
+		  c.set_data_source("apnic")
+		  c.source_registry?.should == "apnic"
+	  end
+
+	  it "SHOULD NOT change the registry if you call the set_data_source function with an invalid registry" do
+		  c = RipeDbClient::Query.new
+		  c.source_registry?.should == "ripe"
+		  expect { c.set_data_source("arin") }.to raise_error(RipeDbClient::Unsupported, 'The only Supported registries are RIPE, AFRINIC, and APNIC')
+		  c.source_registry?.should == "ripe"
+	  end
+
+	  it "SHOULD use http as its default mechanism" do
+		  c = RipeDbClient::Query.new
+		  c.secure_queries?.should be_false
+    end
+
+    it "SHOULD use https for queries if you set it up via set_secure_queries" do
+      c = RipeDbClient::Query.new
+      c.secure_queries?.should be_false
+      c.set_secure_queries(true)
+      c.secure_queries?.should be_true
+
+    end
+
+    it "SHOULD retrieve a list of the available query sources" do
+      c = RipeDbClient::Query.new
+      VCR.use_cassette('data_sources_object') do
+        response = c.get_supported_data_sources
+        response.should_not be_nil
+      end
+    end
+
+    it "SHOULD raise an exception if the lookup_key is nil" do
+      c = RipeDbClient::Query.new
+      expect { c.lookup(nil,"something") }.to raise_error(RipeDbClient::BadParameter, 'lookup_key cannot be empty, or nil')
+    end
+
+    it "SHOULD raise an exception if the lookup_key is empty" do
+      c = RipeDbClient::Query.new
+      expect { c.lookup("","something") }.to raise_error(RipeDbClient::BadParameter, 'lookup_key cannot be empty, or nil')
+    end
+
+    it "SHOULD raise an exception if the lookup_value is nil" do
+      c = RipeDbClient::Query.new
+      expect { c.lookup("something", nil) }.to raise_error(RipeDbClient::BadParameter, 'lookup_value cannot be empty, or nil')
+    end
+
+    it "SHOULD raise an exception if the lookup_value is empty" do
+      c = RipeDbClient::Query.new
+      expect { c.lookup("something", "") }.to raise_error(RipeDbClient::BadParameter, 'lookup_value cannot be empty, or nil')
+    end
+	end
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,25 @@
+require 'simplecov'
+require 'coveralls'
+
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+    SimpleCov::Formatter::HTMLFormatter,
+    Coveralls::SimpleCov::Formatter
+]
+SimpleCov.start
+
+
+require 'ripe_db_client'
+require 'vcr'
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+  config.order = 'random'
+end
+
+
+VCR.configure do |c|
+  c.cassette_library_dir = 'spec/fixtures/vcr_cassettes'
+  c.hook_into :webmock
+end

metadata

@@ -0,0 +1,227 @@
+--- !ruby/object:Gem::Specification
+name: ripe_db_client
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Mike Simkins
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 10.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 10.0.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.4.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.4.0
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.10.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.10.0
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.11.0
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+description: Programatical Interface to the RIPE Database API (REST Client) - THIS
+  IS NOT YET READY FOR PRIME TIME
+email:
+- software@g7obs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .ruby-gemset
+- .ruby-version
+- .rvmrc
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/ripe_db_client.rb
+- lib/ripe_db_client/exceptions.rb
+- lib/ripe_db_client/query_and_parse.rb
+- lib/ripe_db_client/query_client.rb
+- lib/ripe_db_client/version.rb
+- ripe_db_client.gemspec
+- spec/fixtures/vcr_cassettes/data_sources_object.yml
+- spec/fixtures/vcr_cassettes/person_object.yml
+- spec/query_and_parse_spec.rb
+- spec/ripe_db_client_spec.rb
+- spec/spec_helper.rb
+homepage: http://ripedbclient.rubyforge.org
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: ripedbclient
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: This provides a number of methods to query the RIPE Database, or to Update
+  the Database
+test_files:
+- spec/fixtures/vcr_cassettes/data_sources_object.yml
+- spec/fixtures/vcr_cassettes/person_object.yml
+- spec/query_and_parse_spec.rb
+- spec/ripe_db_client_spec.rb
+- spec/spec_helper.rb
+has_rdoc: