concur_connect 0.0.1

data/.document

@@ -0,0 +1,11 @@
+# .document is used by rdoc and yard to know how to generate documentation 
+# for example, it can be used to control how rdoc gets built when you do `gem install foo`
+
+README.rdoc
+lib/**/*.rb
+bin/*
+
+# Files below this - are treated as 'extra files', and aren't parsed for ruby code
+- 
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,40 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+# rcov generated
+coverage
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore: 
+#
+# * Create a file at ~/.gitignore
+# * Include files you want ignored
+# * Run: git config --global core.excludesfile ~/.gitignore
+#
+# After doing this, these files will be ignored in all your git projects,
+# saving you from having to 'pollute' every project you touch with them
+#
+# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
+#
+# For MacOS:
+#
+#.DS_Store
+#
+# For TextMate
+#*.tmproj
+#tmtags
+#
+# For emacs:
+#*~
+#\#*
+#.\#*
+#
+# For vim:
+#*.swp

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,11 @@
+source :rubygems
+
+gemspec
+
+gem 'guard'
+gem 'guard-bundler'
+gem 'guard-rspec'
+if RUBY_PLATFORM =~ /darwin/
+  gem 'rb-fsevent'
+  gem 'growl'
+end

data/Guardfile

@@ -0,0 +1,28 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'bundler' do
+  watch('Gemfile')
+  # Uncomment next line if Gemfile contain `gemspec' command
+  # watch(/^.+\.gemspec/)
+end
+
+guard 'rspec', :version => 2 do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+
+  # Rails example
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^app/(.+)\.rb$})                           { |m| "spec/#{m[1]}_spec.rb" }
+  watch(%r{^app/(.*)(\.erb|\.haml)$})                 { |m| "spec/#{m[1]}#{m[2]}_spec.rb" }
+  watch(%r{^lib/(.+)\.rb$})                           { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch(%r{^app/controllers/(.+)_(controller)\.rb$})  { |m| ["spec/routing/#{m[1]}_routing_spec.rb", "spec/#{m[2]}s/#{m[1]}_#{m[2]}_spec.rb", "spec/acceptance/#{m[1]}_spec.rb"] }
+  watch(%r{^spec/support/(.+)\.rb$})                  { "spec" }
+  watch('spec/spec_helper.rb')                        { "spec" }
+  watch('config/routes.rb')                           { "spec/routing" }
+  watch('app/controllers/application_controller.rb')  { "spec/controllers" }
+  # Capybara request specs
+  watch(%r{^app/views/(.+)/.*\.(erb|haml)$})          { |m| "spec/requests/#{m[1]}_spec.rb" }
+end
+

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Derek Kastner
+
+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,28 @@
+= concur_connect
+
+ConcurConnect makes using the Concur Connect API (http://developer.concur.com) a breeze to use.
+
+== Installation
+
+    gem install concur_connect
+
+== Quick start
+
+    require 'concur_connect'
+    concur = ConcurConnect.session 'token', 'secret', 'company ID'
+    reports = concur.expense_reports Date.new(2011, 9, 1)  # all approved reports since 9/1/2011
+    puts reports.first.expenses.inspect
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2011 Derek Kastner. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,42 @@
+require 'rubygems'
+
+begin
+  require 'bundler'
+rescue LoadError
+  $stderr.puts "You must install bundler - run `gem install bundler`"
+end
+
+begin
+  Bundler.setup
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'bueller'
+Bueller::Tasks.new
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:examples) do |examples|
+  examples.rspec_opts = '-Ispec'
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.rspec_opts = '-Ispec'
+  spec.rcov = true
+end
+
+task :default => :examples
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.main = 'README.rdoc'
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "concur_connect #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/concur_connect.gemspec

@@ -0,0 +1,41 @@
+$:.push File.expand_path("../lib", __FILE__)
+require 'concur_connect/version'
+
+Gem::Specification.new do |s|
+  s.name = 'concur_connect'
+  s.version = ConcurConnect::VERSION
+  s.platform = Gem::Platform::RUBY
+  s.date = '2011-10-13'
+  s.authors = ['Derek Kastner']
+  s.email = 'dkastner@gmail.com'
+  s.homepage = 'http://github.com/dkastner/concur_connect'
+  s.summary = %Q{Wrapper for ConcurConnect API}
+  s.description = %Q{Access your Concur data via OAuth}
+  s.extra_rdoc_files = [
+    'LICENSE',
+    'README.rdoc',
+  ]
+
+  s.required_rubygems_version = Gem::Requirement.new('>= 1.3.7')
+  s.rubygems_version = '1.3.7'
+  s.specification_version = 3
+
+  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']
+
+  s.add_dependency 'faraday', '~> 0.6.0'
+  s.add_dependency 'faraday_middleware'
+  s.add_dependency 'multi_xml'
+  s.add_dependency 'simple_oauth'
+
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'bundler'
+  s.add_development_dependency 'bueller'
+  s.add_development_dependency 'fakeweb'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'rcov'
+  s.add_development_dependency 'vcr'
+end
+

data/lib/concur_connect.rb

@@ -0,0 +1,23 @@
+require 'concur_connect/session'
+require 'concur_connect/version'
+
+# ConcurConnect makes using the Concur Connect API
+# a breeze to use.
+#
+# Quick start:
+#
+#     concur = ConcurConnect.session 'token', 'secret', 'company ID'
+#     reports = concur.expense_reports Date.new(2011, 9, 1)  # all approved reports since 9/1/2011
+#     puts reports.first.expenses.inspect
+module ConcurConnect
+  extend self
+
+  # Start a connection session to ConcurConnect
+  #
+  # token: OAuth token
+  # secret: OAuth secret
+  # company_id: your ConcurConnect company ID (usually your domain)
+  def session(token, secret, company_id)
+    Session.new token, secret, company_id
+  end
+end

data/lib/concur_connect/expense_finder.rb

@@ -0,0 +1,30 @@
+require 'concur_connect/expense'
+require 'concur_connect/finder'
+
+module ConcurConnect
+  class ExpenseFinder
+    include Finder
+    
+    def find(report_id)
+      url = "/api/expense/expensereport/v1.1/report/#{report_id}/entries"
+      response = session.get url
+      build_expenses response.body
+    end
+
+    def build_expenses(data)
+      list = []
+      if data['ExpenseEntriesList'] && data['ExpenseEntriesList']['ExpenseEntrySummary']
+        items = data['ExpenseEntriesList']['ExpenseEntrySummary']
+        items = [items] unless items.is_a?(Array)
+        items.each do |datum|
+          expense = Expense.new
+          expense.type = datum['ExpenseName']
+          expense.amount = datum['TransactionAmount']
+          expense.vendor = datum['VendorListName']
+          list << expense
+        end
+      end
+      list
+    end
+  end
+end

data/lib/concur_connect/expense_report.rb

@@ -0,0 +1,21 @@
+require 'concur_connect/expense_finder'
+
+module ConcurConnect
+  class ExpenseReport
+    attr_accessor :id, :name, :date, :details_url,
+      :expenses,
+      :session
+
+    def expense_finder
+      @expense_finder ||= ExpenseFinder.new session
+    end
+
+    def api_id
+      File.basename details_url
+    end
+
+    def expenses
+      @expenses ||= expense_finder.find api_id
+    end
+  end
+end

data/lib/concur_connect/expense_report_finder.rb

@@ -0,0 +1,44 @@
+require "concur_connect/expense_finder"
+require 'concur_connect/expense_report'
+require 'concur_connect/finder'
+
+module ConcurConnect
+  class ExpenseReportFinder
+    include Finder
+
+    STATUSES = %w{RECENT UNSUBMITTED PENDING APPROVED PROCESSED PAID
+      PAYMENTCONFIRMED FORTHISMONTH FORLASTMONTH FORTHISQUARTER
+      FORLASTQUARTER FORTHISYEAR FORLASTYEAR TOAPPROVE APPROVEDTHISMONTH
+      APPROVEDLASTMONTH APPROVEDTHISQUARTER APPROVEDLASTQUARTER
+      APPROVEDTHISYEAR APPROVEDLASTYEAR}
+    
+    # status: status string defined in STATUSES
+    # date: a Date/Time object for filtering
+    def find(user_id = nil, status = 'APPROVED', date = nil)
+      url = "/api/expense/expensereport/v1.1/reportslist/#{status}"
+      url += "/LastModified?date=#{date.strftime('%Y-%m-%d')}" if date
+      response = session.get url do |g|
+        g.headers['X-UserID'] = user_id if user_id
+      end
+      build_expense_reports response.body
+    end
+
+    def build_expense_reports(data)
+      list = []
+      if data['ReportsList'] && data['ReportsList']['ReportSummary']
+        items = data['ReportsList']['ReportSummary']
+        items = [items] unless items.is_a?(Array)
+        items.each do |datum|
+          expense_report = ExpenseReport.new
+          expense_report.id = datum['ReportId']
+          expense_report.name = datum['ReportName']
+          expense_report.date = datum['ReportDate']
+          expense_report.details_url = datum['Report_Details_Url']
+          expense_report.session = session
+          list << expense_report
+        end
+      end
+      list
+    end
+  end
+end

data/lib/concur_connect/finder.rb

@@ -0,0 +1,9 @@
+module ConcurConnect
+  module Finder
+    attr_accessor :session
+
+    def initialize(session)
+      self.session = session
+    end
+  end
+end

data/lib/concur_connect/itinerary.rb

@@ -0,0 +1,5 @@
+module ConcurConnect
+  class Itinerary
+    attr_accessor :concur_id, :name, :start_date, :end_date
+  end
+end

data/lib/concur_connect/itinerary_finder.rb

@@ -0,0 +1,35 @@
+require 'concur_connect/itinerary'
+
+module ConcurConnect
+  class ItineraryFinder
+    attr_accessor :session
+
+    def initialize(session)
+      self.session = session
+    end
+
+    def find(user_id, start_date = nil)
+      url = 'travel/trip/v1.0/'
+      url += "?startDate=#{start_date.strftime('%Y-%m-%d')}" if start_date
+      response = session.get url do |g|
+        g.headers['X-UserID'] = user_id
+      end
+      build_itineraries response.body
+    end
+
+    def build_itineraries(data)
+      list = []
+      if data['ItineraryInfoList'] && data['ItineraryInfoList']['ItineraryInfo']
+        data['ItineraryInfoList']['ItineraryInfo'].each do |datum|
+          itinerary = Itinerary.new
+          itinerary.concur_id = datum['id']
+          itinerary.name = datum['TripName']
+          itinerary.start_date = datum['StartDateLocal']
+          itinerary.end_date = datum['EndDateLocal']
+          list << itinerary
+        end
+      end
+      list
+    end
+  end
+end

data/lib/concur_connect/session.rb

@@ -0,0 +1,44 @@
+require "concur_connect/expense_report_finder"
+require "concur_connect/itinerary_finder"
+require 'concur_connect/user_finder'
+require 'delegate'
+require 'faraday/request/oauth'
+require 'faraday/response/parse_xml'
+
+module ConcurConnect
+  class Session < SimpleDelegator
+    attr_accessor :consumer_key, :consumer_secret, :company_id, :debug
+
+    def initialize(consumer_key, consumer_secret, company_id, debug = false)
+      self.consumer_key = consumer_key
+      self.consumer_secret = consumer_secret
+      self.company_id = company_id
+      self.debug = debug
+      @user_finder = UserFinder.new self
+      @expense_report_finder = ExpenseReportFinder.new self
+
+      faraday = Faraday.new(:url => 'https://www.concursolutions.com/api') do |builder|
+        builder.request :OAuth, {
+          :consumer_key => consumer_key,
+          :consumer_secret => consumer_secret
+        }
+        builder.request  :url_encoded
+        builder.request  :json
+        builder.response :logger if debug?
+        builder.adapter  :net_http
+
+        builder.use Faraday::Response::ParseXml
+      end
+      __setobj__ faraday  # wrap Faraday in a loving embrace
+    end
+    alias :debug? :debug
+
+    def user(id)
+      @user ||= @user_finder.find id
+    end
+
+    def expense_reports(date, status = 'APPROVED')
+      @expense_reports ||= @expense_report_finder.find nil, status, date
+    end
+  end
+end