yieldmanager 0.5.0 → 0.6.0

data/README.rdoc

@@ -103,9 +103,29 @@ Column data can be accessed either by index or column name:
 	report.data[0].by_name('advertiser_name') # => "Bob's Ads"
 	report.data[0].by_name(:advertiser_name) # => "Bob's Ads"
 
+If you call *by_name* with a non-existent column, it will throw an
+*ArgumentError* telling you so.
+
+Or you can extract the report to an array of named hashes, removing
+dependencies on the gem for consumers of the data (say, across an API):
+
+  hashes = report.to_hashes
+  hashes[0]['advertiser_name'] # => "Bob's Ads"
+
 *NOTE* Any totals columns your xml requests will be interpreted
 as ordinary data.
 
+=== Mocking reports
+
+When simulating report calls without actually hitting Yieldmanager, you can
+create your own reports.
+
+  rpt = Yieldmanager::Report.new
+  rpt.headers = ["first","second"]
+  rpt.add_row([1,2])
+  rpt.data.first.by_name("first").should == 1
+  rpt.data.first.by_name("second").should == 2
+
 === session vs. start_session/end_session
 
 The *session* method opens a session, gives you a token to use in your service

data/VERSION

@@ -1 +1 @@
-0.5.0
+0.6.0

data/lib/yieldmanager/report.rb

@@ -32,6 +32,18 @@ module Yieldmanager
       data << row
     end
 
+    def to_hashes
+      hashes = []
+      data.each do |row|
+        row_hash = {}
+        row.each_with_index do |ele,idx|
+          row_hash[headers[idx]] = ele
+        end
+        hashes << row_hash
+      end
+      hashes
+    end
+
 private
     
     def request_report_token token, report, xml

data/spec/yieldmanager/report_spec.rb

@@ -56,12 +56,21 @@ describe "A Yieldmanager report request" do
     report.data[0][0].should == "one"
   end
   
-  it "offers data as array of hashes" do
+  it "offers data by name" do
     report = Yieldmanager::Report.new
     report.send(:retrieve_data, @sample_report)
     report.data[0].by_name('first').should == "one"
     report.data[1].by_name(:second).should == "2"
   end
+  
+  it "offers data as array of hashes" do
+    report = Yieldmanager::Report.new
+    report.send(:retrieve_data, @sample_report)
+    hashes = report.to_hashes
+    hashes.size.should == 2
+    hashes[0]['first'].should == "one"
+    hashes[1]['second'].should == "2"
+  end
 
   it "by_name returns 'column not found' error when missing" do
     report = Yieldmanager::Report.new

data/yieldmanager.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{yieldmanager}
-  s.version = "0.5.0"
+  s.version = "0.6.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Bill Gathen"]
-  s.date = %q{2010-09-03}
+  s.date = %q{2010-10-05}
   s.description = %q{This gem offers full access to YieldManager's API tools (read/write) as well as ad-hoc reporting through the Reportware tool}
   s.email = %q{bill@billgathen.com}
   s.extra_rdoc_files = [

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: yieldmanager
 version: !ruby/object:Gem::Version 
-  hash: 11
+  hash: 7
   prerelease: false
   segments: 
   - 0
-  - 5
+  - 6
   - 0
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors: 
 - Bill Gathen
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-03 00:00:00 -04:00
+date: 2010-10-05 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency