First pass using method_missing and OpenStruct.

lib/companies_house/response.rb

@@ -1,8 +1,11 @@
+require "active_support/core_ext/string/inflections"
+require "ostruct"
+
 module CompaniesHouse
 
   class Response
 
-    attr_reader :attributes
+    attr_reader :attributes, :struct
 
     def initialize(response)
       check_for_errors(response)
@@ -26,6 +29,14 @@ def [](key)
       @attributes[key]
     end
 
+    def method_missing(sym, *args, &block)
+    	if @struct.respond_to?(sym)
+    		@struct.send(sym)
+    	else
+    		super sym, *args, &block
+    	end
+    end
+
     private
 
     def check_for_errors(response)
@@ -44,9 +55,17 @@ def parse_response(response)
       body = response.body.encode("UTF-8", "ISO-8859-1")
       data = JSON.parse(body)
       @attributes = data["primaryTopic"]
+      @struct = build_open_struct(@attributes)
     rescue JSON::ParserError=> e
       error_msg = "Companies house is having problems: #{response.body}"
       raise ServerError.new(error_msg)
     end
+
+    def build_open_struct(hash)
+    	hash.each_with_object(OpenStruct.new) do |(key, value), struct|
+  			value = build_open_struct(value) if value.is_a?(Hash)
+  			struct.send("#{key.underscore}=", value)
+    	end
+    end
   end
 end

open_companies_house.gemspec

@@ -7,6 +7,7 @@ Gem::Specification.new do |gem|
 
   gem.add_dependency "faraday", "~> 0.8.4"
   gem.add_dependency "json"
+  gem.add_dependency "activesupport"
 
   gem.name = 'open-companies-house'
   gem.summary = "A wrapper around Companies House Open API"
@@ -17,4 +18,4 @@ Gem::Specification.new do |gem|
   gem.require_paths = ['lib']
   gem.files = `git ls-files`.split("\n")
   gem.test_files = `git ls-files -- spec/*`.split("\n")
-end
+end

spec/companies_house/response_spec.rb

@@ -25,6 +25,14 @@
     it "makes SIC code available as a convenience method" do
       @response.sic_code.should == "62090"
     end
+
+    it "makes attributes accessible as methods on the object body" do
+    	@response.company_name.should == "GOCARDLESS LTD"
+    end
+
+    it "makes nested attributes accessible as chained methods on the object body" do
+    	@response.reg_address.address_line1.should == "22-25 FINSBURY SQUARE"
+    end
   end
 
   context "with a company that doesn't exist" do