fellowshipone 0.0.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 822ce7ceb639df2c03e7ccf15689fd5aadd9b7df
-  data.tar.gz: d7028edcff998f520f9a49b8f5bc7fc91b22ca41
+  metadata.gz: 25789b93d29e2e2ff020d0d59416f2fbdb4170ce
+  data.tar.gz: 611838d2c6c8012bc1347f225bd72a7fd8f23205
 SHA512:
-  metadata.gz: 5b35f52dcc3084e68ab668b28601dd9d15b6a960d40da35327ccafdaf132f4cd1f76fd7f3758b039c16f3e14854fd9a0edcde509a4c5f6e814c80a4ca56dc5fe
-  data.tar.gz: f9b7c0972077b9b1274ac33b2534d9c62040d7efbf47188fca5ec756d94f2740271eae25a98bc3dd414b5ba992fd4ec70acba5005d883361e5bdf6ddf073d9d2
+  metadata.gz: 62946546cdaf3b85f1dc0b09f2865ae1db64db0597ad6a5b41a39f2e91364654f78035bbaeb383d8bcdfbee889ee8375d122ea4aaa2c3f2855393278238c3433
+  data.tar.gz: 7db31d942950435790a4c7a93e4ef809a59402cca592be9948e45a20f0a1ab2bea13a0524026478b0960b7a15ab1b97e3f37a148e79cb30ab1567042ef81d808

data/.gitignore

@@ -0,0 +1 @@
+fellowshipone-*.gem

data/Gemfile

@@ -0,0 +1,2 @@
+source 'http://rubygems.org'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,40 @@
+PATH
+  remote: .
+  specs:
+    fellowshipone (1.0.0)
+      faraday
+      faraday_middleware
+      json
+      simple_oauth
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.3.7)
+    crack (0.4.2)
+      safe_yaml (~> 1.0.0)
+    faraday (0.9.1)
+      multipart-post (>= 1.2, < 3)
+    faraday_middleware (0.9.1)
+      faraday (>= 0.7.4, < 0.10)
+    json (1.8.2)
+    minitest (5.5.1)
+    multipart-post (2.0.0)
+    rake (10.4.2)
+    safe_yaml (1.0.4)
+    simple_oauth (0.3.1)
+    vcr (2.9.3)
+    webmock (1.20.4)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler
+  fellowshipone!
+  minitest
+  rake
+  vcr
+  webmock

data/README.md

@@ -0,0 +1,32 @@
+# FellowshipOne API
+
+A Ruby wrapper for the FellowshipOne API (https://developer.fellowshipone.com/)
+
+
+## Install / Setup
+
+Installing the gem
+
+    gem install fellowshipone
+
+
+To add it to your Gemfile
+
+    gem 'fellowshipone', require: 'fellowshipone'
+
+## Additional resources
+
+* FellowshipOne API: https://developer.fellowshipone.com/docs/
+* FellowshipOne Forum: https://developer.fellowshipone.com/forum/
+
+
+## License
+
+This project is released under the MIT license (see LICENSE).
+
+This project is maintained by Taylor Brooks (https://github.com/taylorbrooks).
+
+
+## Want to Contribute?
+
+If you would like to get involved in this project, then please fork the project. Make changes, add features, write some tests, and then send a pull request. 

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.pattern = "test/**/*_test.rb"
+end
+
+task default: :test

data/fellowshipone.gemspec

@@ -0,0 +1,29 @@
+$:.push File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name              = 'fellowshipone'
+  s.version           = '1.0.0'
+  s.authors           = ['Taylor Brooks']
+  s.email             = ['tbrooks@gmail.com']
+  s.homepage          = 'https://github.com/taylorbrooks/fellowshipone'
+
+  s.summary = 'Ruby gem/plugin to interact with the FellowshipOne API (https://developer.fellowshipone.com/).'
+  s.description = 'Ruby gem/plugin to interact with the FellowshipOne API (https://developer.fellowshipone.com/). Checkout the project on github for more detail.'
+  s.license = 'MIT'
+
+  s.add_development_dependency "bundler"
+  s.add_development_dependency "rake"
+  s.add_development_dependency "minitest"
+  s.add_development_dependency "vcr"
+  s.add_development_dependency "webmock"
+
+  s.add_runtime_dependency "faraday"
+  s.add_runtime_dependency "faraday_middleware"
+  s.add_runtime_dependency "simple_oauth"
+  s.add_runtime_dependency "json"
+
+  s.files         = `git ls-files`.split("\n").delete_if { |f| !(f =~ /^examples/).nil? }
+  s.test_files    = `git ls-files -- {test,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/fellowshipone.rb

@@ -0,0 +1 @@
+require_relative 'fellowshipone/client.rb'

data/lib/fellowshipone/client.rb

@@ -0,0 +1,79 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'simple_oauth'
+require 'json'
+
+Dir[File.expand_path('../resources/*.rb', __FILE__)].each{|f| require f}
+
+module Fellowshipone
+  class Client
+    include Fellowshipone::Client::Communication
+    include Fellowshipone::Client::Contribution
+    include Fellowshipone::Client::Fund
+    include Fellowshipone::Client::Household
+    include Fellowshipone::Client::Person
+
+    attr_reader :church_code, :consumer_key, :consumer_secret, :token, :secret
+
+    def initialize(church_code, consumer_key, consumer_secret, token, secret)
+      @church_code     = church_code
+      @consumer_key    = consumer_key
+      @consumer_secret = consumer_secret
+      @token           = token
+      @secret          = secret
+    end
+
+    def get(path, options={})
+      connection.get do |req|
+        req.url(path, options)
+      end.body
+    end
+
+    def post(path, req_body)
+      connection.post do |req|
+        req.url(path)
+        req.body = req_body
+      end.body
+    end
+
+    def put(url, options = {})
+      connection.put do |req|
+        req.url path
+      end.body
+    end
+
+    def delete(url, options = {})
+      connection.delete do |req|
+        req.url path
+      end.body
+    end
+
+    def save
+      connection.put do |req|
+        req.url path
+      end.body
+    end
+
+    private
+
+    def connection
+      Faraday.new(url: "https://#{church_code}.fellowshiponeapi.com", headers: { accept: 'application/json' }) do |connection|
+        connection.request  :json
+        connection.request  :oauth, oauth_data
+        connection.response :logger
+        connection.use      FaradayMiddleware::Mashify
+        connection.response :json
+        connection.adapter  Faraday.default_adapter
+      end
+    end
+
+    def oauth_data
+      {
+        consumer_key:    consumer_key,
+        consumer_secret: consumer_secret,
+        token:           token,
+        token_secret:    secret
+      }
+    end
+  end
+end

data/lib/fellowshipone/resources/communication.rb

@@ -0,0 +1,15 @@
+module Fellowshipone
+  class Client
+    module Communication
+
+      def new_communication(person_id)
+        get("/v1/People/#{person_id}/Communications/new.json")
+      end
+
+      def create_communication(person_id, json_body)
+        post("/v1/People/#{person_id}/Communications.json", json_body)
+      end
+
+    end
+  end
+end

data/lib/fellowshipone/resources/contribution.rb

@@ -0,0 +1,23 @@
+module Fellowshipone
+  class Client
+    module Contribution
+
+      def contributions
+
+      end
+
+      def get_contribution(id)
+        get("/giving/v1/contributionreceipts/#{id}.json")
+      end
+
+      def new_contribution
+        get("/giving/v1/contributionreceipts/new.json")
+      end
+
+      def create_contribution(contribution_params)
+        post("/giving/v1/contributionreceipts.json", contribution_params)
+      end
+
+    end
+  end
+end

data/lib/fellowshipone/resources/fund.rb

@@ -0,0 +1,15 @@
+module Fellowshipone
+  class Client
+    module Fund
+
+      def funds
+        get('/giving/v1/funds')
+      end
+
+      def fund(id)
+        get("/giving/v1/fund/#{id}.json")
+      end
+
+    end
+  end
+end

data/lib/fellowshipone/resources/household.rb

@@ -0,0 +1,15 @@
+module Fellowshipone
+  class Client
+    module Household
+
+      def new_household
+        get("/v1/Households/new.json")
+      end
+
+      def create_household(household_params)
+        post("/v1/Households.json", household_params)
+      end
+
+    end
+  end
+end

data/lib/fellowshipone/resources/person.rb

@@ -0,0 +1,27 @@
+module Fellowshipone
+  class Client
+    module Person
+
+      def list_people(attrs={})
+        get('/v1/People/Search.json', attrs)
+      end
+
+      def find_person(id)
+        get("/v1/People/#{id}")
+      end
+
+      def new_person
+        get("/v1/People/new.json")
+      end
+
+      def create_person(person_params)
+        post("/v1/People.json", person_params.to_json)
+      end
+
+      def search_for_person(name, email)
+        get("/v1/People/Search.json?searchfor=#{name}&communication=#{email}").results
+      end
+
+    end
+  end
+end

data/test/person/person_test.rb

@@ -0,0 +1,7 @@
+require './test/test_helper'
+
+class FellowshipOnePersonTest < Minitest::Test
+  def test_exists
+    assert FellowshipOne::Person
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,9 @@
+require './lib/fellowship_one'
+require 'minitest/autorun'
+require 'webmock/minitest'
+require 'vcr'
+
+VCR.configure do |c|
+  c.cassette_library_dir = "test/fixtures"
+  c.hook_into :webmock
+end

data/tester.rb

@@ -0,0 +1,65 @@
+token = ""
+secret = ""
+church_code = ""
+
+@client ||= FellowshipOne::Client.new(token, secret, church_code)
+
+find_or_create_fellowship_person
+contribution = build_fellowship_contribution
+
+@donation.refs = {"f1_id" => contribution.id}
+raise
+@donation.save
+
+def find_or_create_fellowship_person
+  people = @client.search_for_person({name: "taylor", email: "tbrooks@gmail"})
+
+  if people.count == 0
+    @donor = build_fellowship_person
+    build_fellowship_email
+  else
+    @donor = people.first
+  end
+end
+
+def build_fellowship_person
+  household                          = @client.new_household
+  household.household_name           = "Taylor Brooks"
+  @client.save_household(household)
+
+  donor                              = @client.new_person
+  donor.household_id                 = household.id.to_s
+  donor.id                           = ''
+  donor.household_member_type['@id'] = '1'
+  donor.status['@id']                = '6'     # Contributor Only
+  donor.first_name                   = "Taylor"
+  donor.last_name                    = "Brooks"
+  @client.create_person(donor)
+end
+
+def build_fellowship_email
+  communication                            = @client.new_communication(@donor.id)
+  communication.communication_type['@id']  = '4'
+  communication.communication_type['name'] = 'Email'
+  communication.communication_general_type = 'Email'
+  communication.preferred                  = 'true'
+  communication.communication_value        = @customer.email
+  communication.search_communication_value = @customer.email
+  @client.create_communicate(@donor.id, communication.id, communication)
+end
+
+def build_fellowship_contribution
+  contribution                          = @client.new_contribution
+  contribution.amount                   = @donation.gross_amount/100.00
+
+  contribution.fund['@id']              = @donation.fund.settings['fellowship_fund_id']
+
+  contribution.household['@id']         = @donor.household_id
+  contribution.received_date            = @donation.created_at.iso8601 # Needs to be this format
+  contribution.contribution_type['@id'] = @donation.payment_type == 'bank account' ? 5 : 3 # 3 - Credit Card, 5 - ACH
+
+  contribution.memo                   = "Simple Donation - #{@donation.id}"
+
+  contribution.address_verification     = false
+  @client.create_contribution(contribution)
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fellowshipone
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 1.0.0
 platform: ruby
 authors:
 - Taylor Brooks
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-02-27 00:00:00.000000000 Z
+date: 2015-04-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -143,7 +143,23 @@ email:
 executables: []
 extensions: []
 extra_rdoc_files: []
-files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- fellowshipone.gemspec
+- lib/fellowshipone.rb
+- lib/fellowshipone/client.rb
+- lib/fellowshipone/resources/communication.rb
+- lib/fellowshipone/resources/contribution.rb
+- lib/fellowshipone/resources/fund.rb
+- lib/fellowshipone/resources/household.rb
+- lib/fellowshipone/resources/person.rb
+- test/person/person_test.rb
+- test/test_helper.rb
+- tester.rb
 homepage: https://github.com/taylorbrooks/fellowshipone
 licenses:
 - MIT
@@ -168,4 +184,6 @@ rubygems_version: 2.0.14
 signing_key: 
 specification_version: 4
 summary: Ruby gem/plugin to interact with the FellowshipOne API (https://developer.fellowshipone.com/).
-test_files: []
+test_files:
+- test/person/person_test.rb
+- test/test_helper.rb