loco_bill 0.0.2 → 0.0.4

data/README.rdoc

@@ -0,0 +1,28 @@
+LocoBill
+--------
+
+An interface for interacting with Bill.com's API.
+
+Requires Nokogiri.
+
+Create an initializer (or what have you) to set the following:
+==============================================================
+
+  LocoBill::Configuration.environment = :production # or :sandbox
+  LocoBill::Configuration.application_key = "aaa"
+  LocoBill::Configuration.org_id = "bbb"
+  LocoBill::Configuration.username = "xxx"
+  LocoBill::Configuration.password = "yyy"
+
+Use like so:
+============
+
+  vendor = LocoBill.create_vendor :vendor => {:name => 'Test'} # will auto-login for you and store the session ID, if you're not already logged in
+  vendor.result.inspect => #<LocoBill::RequestResult transactionId="Transaction1", status="OK", id="xxy">
+  
+  LocoBill.create_bill :bill => {
+    :billLineItems => [
+      {:billLineItem => {:amount => 11}},
+      {:billLineItem => {:amount => 32}}
+    ]
+  }

data/lib/loco_bill/configuration.rb

@@ -0,0 +1,42 @@
+module LocoBill
+  module Configuration
+    API_VERSION = "1.0" # :nodoc:
+
+    class << self
+      attr_accessor :session_id, :transaction_id
+      attr_writer :application_key, :username, :password, :org_id
+    end
+
+    def self.expectant_reader(*attributes) # :nodoc:
+      attributes.each do |attribute|
+        (class << self; self; end).send(:define_method, attribute) do
+          attribute_value = instance_variable_get("@#{attribute}")
+          raise "#{attribute} needs to be set" unless attribute_value
+          attribute_value
+        end
+      end
+    end
+    expectant_reader :environment, :application_key, :username, :password, :org_id
+  
+    def self.environment=(env)
+      unless [:sandbox, :production].include?(env)
+        raise ArgumentError, "#{env.inspect} is not a valid environment"
+      end
+      @environment = env
+    end
+    
+    def self.api_endpoint
+      "/crudApi"
+    end
+    
+    def self.server # :nodoc:
+      case environment
+      when :production
+        "api.bill.com"
+      when :sandbox
+        "api-test.cashview.com"
+      end
+    end
+    
+  end
+end

data/lib/loco_bill/login.rb

@@ -1,5 +1,5 @@
 module LocoBill
   def self.login
-    Request.new(:login, :username => BILL_API_USERNAME, :password => BILL_API_PASSWORD, :orgID => BILL_API_ORG_ID)
+    Request.new(:login, :username => LocoBill::Configuration.username, :password => LocoBill::Configuration.password, :orgID => LocoBill::Configuration.org_id)
   end
 end

data/lib/loco_bill/request.rb

@@ -1,31 +1,32 @@
 module LocoBill
   class Request
-    attr_accessor :result
-    @@api_domain = 'api.bill.com'
-    @@api_endpoint = "/crudApi"
-    @@session_id = nil
-    @@transaction_id = 0
+    attr_reader :result
     NON_OPERATION_WRAPPED_ACTIONS = [:login, :logout, :getorglist]
     INLINE_PARAMS_ACTIONS = {:get_list => :object}
     
     def initialize(action, params={})
       @action = action.to_sym
-      # auto-login & grab session id if we don't already have one.
-      if @@session_id.nil? && @action != :login
-        @@session_id = LocoBill.login.result.sessionId
-      end
+      auto_login
+      
       @params = params
       @result = process_response(api(build_request_xml))
     end
     
+    # auto-login & grab session id if we don't already have one.
+    def auto_login
+      if LocoBill::Configuration.session_id.nil? && @action != :login
+        LocoBill::Configuration.session_id = LocoBill.login.result.sessionId
+      end
+    end
+    
     def build_request_xml
       operation_wrapped = !NON_OPERATION_WRAPPED_ACTIONS.include?(@action)
       
       Nokogiri::XML::Builder.new(:encoding => 'UTF-8') do |xml|
-        xml.request(:version => '1.0', :applicationkey => BILL_API_APPLICATION_KEY) {
+        xml.request(:version => LocoBill::Configuration::API_VERSION, :applicationkey => LocoBill::Configuration.application_key) {
           if operation_wrapped
             # gotta wrap most of the api calls in an "operation" block with a transaction id & session id
-            xml.operation(:transactionId => transaction_id, :sessionId => @@session_id) { action_xml(xml) }
+            xml.operation(:transactionId => LocoBill::Configuration.transaction_id, :sessionId => LocoBill::Configuration.session_id) { action_xml(xml) }
           else
             action_xml(xml)
           end
@@ -46,27 +47,37 @@ module LocoBill
     # BillApi.create_vendor :vendor => {:name => 'Test'}
     def params_xml(xml, params)
       params.each do |k, v|
-        if v.is_a?(Hash)
-          xml.send(k) { params_xml(xml, v) }
-        else
-          xml.send(k) { xml.text(v) }
-        end
+        xml.send(k) {
+          if v.is_a?(Hash)
+            params_xml(xml, v)
+          elsif v.is_a?(Array)
+            v.each do |hash|
+              params_xml(xml, hash)
+            end
+          else
+            if v.is_a?(Time) || v.is_a?(Date)
+              v = v.to_time.strftime("%m/%d/%Y")
+            end
+            
+            xml.text(v)
+          end
+        }
       end
     end
     
     # generate a transaction id for operation requests
     def transaction_id
-      @@transaction_id += 1
-      "Transaction#{@@transaction_id}"
+      ::Configuration.transaction_id += 1
+      "Transaction#{::Configuration.transaction_id}"
     end
     
     def api(xml_body)
       # puts "XML BODY: #{xml_body}"
-      https = Net::HTTP.new(@@api_domain, 443)
+      https = Net::HTTP.new(LocoBill::Configuration.server, 443)
       https.use_ssl = true
       https.read_timeout=5 # 5 second timeout
       https.verify_mode = OpenSSL::SSL::VERIFY_NONE
-      req = Net::HTTP::Post.new(@@api_endpoint)
+      req = Net::HTTP::Post.new(LocoBill::Configuration.api_endpoint)
       req.body = "request=#{req.send(:urlencode, xml_body)}" # prefixing the request with "request=" showed up in the docs absolutely nowhere. thanks, bill.com.
       req.content_type = 'application/x-www-form-urlencoded'
       

data/lib/loco_bill.rb

@@ -1,5 +1,6 @@
 require 'nokogiri'
 require 'ostruct'
+require 'loco_bill/configuration'
 require 'loco_bill/request'
 require 'loco_bill/login'
 

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 0
-  - 2
-  version: 0.0.2
+  - 4
+  version: 0.0.4
 platform: ruby
 authors: 
 - chris mcc
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-06-14 00:00:00 -04:00
+date: 2010-06-15 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -41,10 +41,11 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
+- lib/loco_bill/configuration.rb
 - lib/loco_bill/login.rb
 - lib/loco_bill/request.rb
 - lib/loco_bill.rb
-- README
+- README.rdoc
 - init.rb
 has_rdoc: true
 homepage: http://github.com/DigitalAdvisor/loco_bill

data/README

@@ -1,15 +0,0 @@
-An interface for interacting with Bill.com's API. Expects the following constants to be set (in environment.rb or an initializer or what have you):
-
-BILL_API_APPLICATION_KEY
-BILL_API_USERNAME
-BILL_API_PASSWORD
-BILL_API_ORG_ID
-
-Requires Nokogiri.
-
-Use like so:
-
-  login = LocoBill.login
-  login.result.inspect => #<LocoBill::RequestResult status="OK", sessionId="xxx", orgID="yyy">
-  vendor = BillApi.create_vendor :vendor => {:name => 'Test'} # will auto-login for you, if you're not already logged in
-  vendor.result.inspect => #<LocoBill::RequestResult transactionId="Transaction1", status="OK", id="xxy">