pipejump 0.2.0 → 0.3.0

data/lib/pipejump/base/session.rb

@@ -1,99 +1,103 @@
 module Pipejump
-  
+
   # The Pipejump::Session instance represents an active Session with the Pipejump API
-  # 
-  # Any access to the Pipejump API requires authentication, which means you need to initialize a 
+  #
+  # Any access to the Pipejump API requires authentication, which means you need to initialize a
   # Pipejump::Session instance before calling any other methods
-  # 
+  #
   # == Authentication
-  # 
+  #
   # To authenticate, simply call Pipejump::Session.new with a argument hash with the following keys:
-  # 
+  #
   # * _email_ - your Pipejump user account email
   # * _password_ - your Pipejump user account password
-  # * _endpoint_ - (optional) Default is http://api.pipejump.com, however you can override it (for example for development)
-  # 
+  # * _endpoint_ - (optional) Default is https://sales.futuresimple.com, however you can override it (for example for development)
+  #
   # You can perform later actions either on a instance returned by the canstructor or within a supplied block
-  # 
-  # 
+  #
+  #
   #     @session = Pipejump::Session.new(:email => EMAIL, :password => PASSWORD)
   #     @session.account
-  # 
-  # 
-  # or 
-  # 
-  # 
+  #
+  #
+  # or
+  #
+  #
   #     Pipejump::Session.new(:email => EMAIL, :password => PASSWORD) do |session|
   #       session.account
   #     end
   #
   # As of version 0.1.1 you can use the token which is fetched when authenticating using the email and password. So once you get the token, you can use it for future initialization of the Session and not send the username and password, which is a more secure.
-  # 
+  #
   #   @session = Pipejump::Session.new(:token => 'your_token')
-  # 
+  #
   # Also, as of version 0.1.1 connection is performed over SSL.
-  # 
-  # 
-  # 
-  # 
+  #
+  #
+  #
+  #
   # == Account
-  # 
+  #
   # To access the Account instance, call the account method
-  # 
-  # 
+  #
+  #
   #      @session.account # => #<Pipejump::Account name: "myaccount", id: "1", currency_name: "$">
-  # 
-  # 
+  #
+  #
   # == Deals
-  # 
-  # You can access your deals by calling 
-  # 
-  # 
+  #
+  # You can access your deals by calling
+  #
+  #
   #      @session.deals
-  # 
-  # 
+  #
+  #
   # With Deals you get access to Notes, Reminders and Deal Contacts.
-  # 
+  #
   # For more information, consult the Deals page.
-  # 
+  #
   # == Clients
-  # 
-  # You can access your clients by calling 
-  # 
-  # 
+  #
+  # You can access your clients by calling
+  #
+  #
   #      @session.clients
-  # 
-  # 
+  #
+  #
   # For more information, consult the Clients page.
-  # 
+  #
   # == Contacts
-  # 
-  # You can access your contacts by calling 
-  # 
-  # 
+  #
+  # You can access your contacts by calling
+  #
+  #
   #      @session.contacts
-  # 
-  # 
+  #
+  #
   # For more information, consult the Contacts page.
-  # 
+  #
   # == Sources
-  # 
-  # You can access your sources by calling 
-  # 
-  # 
+  #
+  # You can access your sources by calling
+  #
+  #
   #      @session.sources
-  # 
-  # 
+  #
+  #
   # For more information, consult the Sources page.
-  # 
+  #
   class Session
-    
-    attr_accessor :token
-    
-    def initialize(params, &block) 
+
+    attr_accessor :token, :version
+
+    def initialize(params, &block)
       if endpoint = params.delete("endpoint") or endpoint = params.delete(:endpoint)
         connection(endpoint)
       end
+
+      if version = params.delete('version') or version = params.delete(:version)
+        self.version = "v#{version}"
+      end
       # If user supplies token, do not connect for authentication
       if token = params.delete('token') or token = params.delete(:token)
         self.token = token
@@ -102,18 +106,26 @@ module Pipejump
       end
       yield(self) if block_given?
     end
-    
+
+    def version_prefix(url)
+      if self.version and !url.match(/^\/api\/#{self.version}/)
+        "/api/#{self.version}#{url}"
+      else
+        url
+      end
+    end
+
     def authenticate(params) #:nodoc:
-      response = connection.post('/authentication', params.collect { |pair| pair.join('=') }.join('&'))
+      response = connection.post(version_prefix('/authentication.json'), params.collect { |pair| pair.join('=') }.join('&'))
       data = JSON.parse(response.body)
       self.token = data['authentication']['token']
       raise AuthenticationFailed if response.code == '401'
     end
-    
+
     def connection(endpoint = nil) #:nodoc:
       @connection ||= Connection.new(self, endpoint)
     end
-        
+
     def get(url) #:nodoc:
       response = connection.get(url)
       data = (response.code.to_i == 200 and url.match('.json')) ? JSON.parse(response.body) : ''
@@ -131,22 +143,22 @@ module Pipejump
       data = url.match('.json') ? JSON.parse(response.body) : response.body
       [response.code.to_i, data]
     end
-    
+
     def delete(url) #:nodoc:
       response = connection.delete(url)
       [response.code.to_i, response.body]
     end
-    
+
     def inspect
       "#<#{self.class} token: \"#{token}\">"
     end
-    
+
     # Returns a Pipejump::Account instance of the current account
     def account
-      code, response = get('/account.json')
+      code, response = get(version_prefix('/account.json'))
       Account.new(response['account'])
     end
-    
+
     # Returns a Pipejump::Collection instance of Clients
     def clients
       Collection.new(self, Client)
@@ -167,6 +179,6 @@ module Pipejump
       Collection.new(self, Deal)
     end
 
-    
+
   end
 end

data/lib/pipejump/resources/contact.rb

@@ -1,225 +1,235 @@
 module Pipejump
-  
+
   # A Contact is represented by an instance of Pipejump::Contact.
-  # 
+  #
   # *Note*: To access any contacts, you need a valid Session instance, referred to as @session in the following examples.
-  # 
+  #
   # == Access
-  # 
+  #
   # === Collection
-  # 
+  #
   # To fetch a collection of Pipejump::Contact instances, call
-  # 
-  # 
-  #      @session.contacts 
+  #
+  #
+  #      @session.contacts
   #      # => #<Pipejump::Collection recontact: Pipejump::Contact>
-  # 
-  # 
+  #
+  #
   # This returns a Pipejump::Collection instance. To retrieve an array of Pipejump::Contact instances, call the _all_ method on the collection:
-  # 
-  # 
-  #      @session.contacts.all 
+  #
+  #
+  #      @session.contacts.all
   #      # => [#<Pipejump::Contact name: "Tom", id: "1", mobile: "123", phone: "456", email: "tom@email.com">, #<Pipejump::Contact name: "Mike", id: "2", mobile: "321", phone: "654", email: "mike@email.com">]
-  # 
-  # 
+  #
+  #
   # Instead of _all_, you can also call a variety of Array methods in the collection which will be delegated to the array returned by _all_, such as:
-  # 
+  #
   # * first
   # * last
   # * each
   # * size
   # * collect
   # * reject
-  # 
+  #
   # *Examples*:
-  # 
-  #      @session.contacts.first 
+  #
+  #      @session.contacts.first
   #      # => #<Pipejump::Contact name: "Tom", id: "1", mobile: "123", phone: "456", email: "tom@email.com">
-  #      @session.contacts.last 
+  #      @session.contacts.last
   #      # => #<Pipejump::Contact name: "Mike", id: "2", mobile: "321", phone: "654", email: "mike@email.com">
   #      @session.contacts.size
   #      # => 2
-  #      @session.contacts.each { |contact| puts contact.name } 
+  #      @session.contacts.each { |contact| puts contact.name }
   #      # Prints out "Tom" and "Mike"
-  #      @session.contacts.collect { |contact| contact.name } 
+  #      @session.contacts.collect { |contact| contact.name }
   #      # => ["Tom",  "Mike"]
-  #      @session.contacts.reject { |contact| contact.name == 'Tom' } 
+  #      @session.contacts.reject { |contact| contact.name == 'Tom' }
   #      # => ["Mike"]
-  # 
-  # 
+  #
+  #
   # === Resource
-  # 
+  #
   # To fetch a single contact, call the _find_ method with the contact id as an argument:
-  # 
-  # 
-  #      @session.contacts.find(1) 
+  #
+  #
+  #      @session.contacts.find(1)
   #      # => #<Pipejump::Contact name: "Tom", id: "1", mobile: "123", phone: "456", email: "tom@email.com">
-  # 
-  # 
+  #
+  #
   # == Creation
-  # 
+  #
   # *Note*: Contacts require the following fields in the hash of attributes:
-  # 
+  #
   # * _name_: a valid name
-  # * _client_id_: a valid a Client| id 
-  # 
-  # To create a new contact, call the _create_ method on the Contact Pipejump::Collection with a hash of attributes as an argument. 
-  # 
-  # 
-  #      @session.contacts.create(:name => 'Jerry', :client_id => 1) 
+  # * _client_id_: a valid a Client| id
+  #
+  # To create a new contact, call the _create_ method on the Contact Pipejump::Collection with a hash of attributes as an argument.
+  #
+  #
+  #      @session.contacts.create(:name => 'Jerry', :client_id => 1)
   #      # => #<Pipejump::Contact name: "Jerry", id: "3", mobile: "", client_id: "1", phone: "", email: "">
-  # 
-  # 
+  #
+  #
   # If the contact was created properly, it will be returned with a id assigned to it. You can check it by calling the created? method
-  # 
-  # 
-  #      contact = @session.contacts.create(:name => 'Jerry', :client_id => 1) 
+  #
+  #
+  #      contact = @session.contacts.create(:name => 'Jerry', :client_id => 1)
   #      # => #<Pipejump::Contact name: "Jerry", id: "3", mobile: "", client_id: "1", phone: "", email: "">
-  #      contact.created? 
+  #      contact.created?
   #      # => true
-  #      contact = @session.contacts.create(:name => '') 
+  #      contact = @session.contacts.create(:name => '')
   #      # => #<Pipejump::Contact name: "">
-  #      contact.created? 
+  #      contact.created?
   #      # => false
-  # 
-  # 
+  #
+  #
   # You can access validation/creation errors by calling the _errors_ method on the instance returned by _create_:
-  # 
-  # 
-  #      contact = @session.contacts.create(:name => '') 
+  #
+  #
+  #      contact = @session.contacts.create(:name => '')
   #      # => #<Pipejump::Contact name: "">
-  #      contact.created? 
+  #      contact.created?
   #      # => false
-  #      contact.errors 
+  #      contact.errors
   #      # => "contact"=>[{"error"=>{"code"=>"E0001", "field"=>"name", "description"=>"Well... we need a name."}}, {"error"=>{"code"=>"E0001", "field"=>"client", "description"=>"can't be blank"}}]}
-  # 
-  # 
+  #
+  #
   # == Update
-  # 
+  #
   # To update a contact, change the attributes and call the _save_ method.
-  # 
+  #
   # === Changing attributes
-  # 
+  #
   # Each attribute has an accessor which you can use to change the values:
-  # 
-  # 
-  #      contact = @session.contacts.create(:name => 'Jerry', :client_id => 1) 
+  #
+  #
+  #      contact = @session.contacts.create(:name => 'Jerry', :client_id => 1)
   #      # => #<Pipejump::Contact name: "Jerry", id: "3", mobile: "", client_id: "1", phone: "", email: "">
-  #      contact.name 
+  #      contact.name
   #      # => 'Jerry'
-  #      contact.name = 'Wally' 
+  #      contact.name = 'Wally'
   #      # => 'Wally'
-  #      contact.name 
+  #      contact.name
   #      # => 'Wally'
-  # 
-  # 
+  #
+  #
   # === Saving
-  # 
+  #
   # Once you've changed the attributes, call the _save_ method on the contact instance:
-  # 
-  # 
-  #      contact = @session.contacts.create(:name => 'Jerry', :client_id => 1) 
+  #
+  #
+  #      contact = @session.contacts.create(:name => 'Jerry', :client_id => 1)
   #      # => #<Pipejump::Contact name: "Jerry", id: "3", mobile: "", client_id: "1", phone: "", email: "">
-  #      contact.name = 'Wally' 
+  #      contact.name = 'Wally'
   #      # => 'Wally'
   #      contact.save
   #      # => true
-  # 
-  # 
+  #
+  #
   # _save_ returns _true_ if save was successful and _false_ if it failed. In the latter scenario, you can access the errors via the _errors_ method:
-  # 
-  # 
-  #      contact = @session.contacts.create(:name => 'Jerry', :client_id => 1) 
+  #
+  #
+  #      contact = @session.contacts.create(:name => 'Jerry', :client_id => 1)
   #      # => #<Pipejump::Contact name: "Jerry", id: "3", mobile: "", client_id: "1", phone: "", email: "">
   #      contact.name = 'Wally'
   #      # => 'Wally'
-  #      contact.save 
+  #      contact.save
   #      # => true
-  #      contact.name = '' 
+  #      contact.name = ''
   #      # => ''
-  #      contact.save 
+  #      contact.save
   #      # => false
-  #      contact.errors 
+  #      contact.errors
   #      # => "contact"=>[{"error"=>{"code"=>"E0001", "field"=>"name", "description"=>"Well... we need a name."}}, {"error"=>{"code"=>"E0001", "field"=>"client", "description"=>"can't be blank"}}]}
-  # 
-  # 
+  #
+  #
   # == Removal
-  # 
+  #
   # To remove a contact, call the _destroy_ method on the instance:
-  # 
-  # 
-  #      contact = @session.contacts.find(1) 
+  #
+  #
+  #      contact = @session.contacts.find(1)
   #      #  => #<Pipejump::Contact name: "Tom", id: "1", mobile: "123", phone: "456", email: "tom@email.com">
-  #      contact.destroy 
+  #      contact.destroy
   #      # => true
-  # 
+  #
   #
   # = Contacts within a Deal
-  # 
+  #
   # A Contact is represented by an instance of Pipejump::Contact. Deal Contacts, however, can only be accessed from a specific deal.
   #
   # *Note*: To access any Deal Contacts, you need a valid Deal| instance, referred to as @deal in the following examples. Deal Contacts belong to a deal, so you can only access them via @deal, not the session.
-  # 
+  #
   # == Access
-  # 
+  #
   # === Collection
-  # 
+  #
   # To fetch a collection of Pipejump::Contact instances belonging to a specific Deal, call
-  # 
-  # 
-  #      @deal.contacts 
+  #
+  #
+  #      @deal.contacts
   #      # => #<Pipejump::Collection resource: Pipejump::Contact, owner: #<Pipejump::Deal name: "My Deal", scope: "0", hot: "false", stage_name: "incoming", id: "1", deal_tags: "">>
-  # 
-  # 
+  #
+  #
   # This returns a Pipejump::Collection instance. To retrieve an array of Pipejump::Contact instances belonging to a specific Deal, call the _all_ method on the collection:
-  # 
-  # 
-  #      @deal.contacts.all 
-  #      # => [#<Pipejump::Contact name: "Tom", id: "1", mobile: "123", phone: "456", email: "tom@email.com">, 
+  #
+  #
+  #      @deal.contacts.all
+  #      # => [#<Pipejump::Contact name: "Tom", id: "1", mobile: "123", phone: "456", email: "tom@email.com">,
   #      #     #<Pipejump::Contact name: "Mike", id: "2", mobile: "321", phone: "654", email: "mike@email.com">]
-  # 
-  # 
+  #
+  #
   # Instead of _all_, you can also call a variety of Array methods in the collection which will be delegated to the array returned by _all_, such as:
-  # 
+  #
   # * first
   # * last
   # * each
   # * size
   # * collect
   # * reject
-  # 
+  #
   # *Examples*:
-  # 
-  #      @deal.contacts.first 
+  #
+  #      @deal.contacts.first
   #      # => #<Pipejump::Contact name: "Tom", id: "1", mobile: "123", phone: "456", email: "tom@email.com">
-  #      @deal.contacts.last 
+  #      @deal.contacts.last
   #      # => #<Pipejump::Contact name: "Mike", id: "2", mobile: "321", phone: "654", email: "mike@email.com">
   #      @deal.contacts.size
   #      # => 2
-  #      @deal.contacts.each { |contact| puts contact.name } 
+  #      @deal.contacts.each { |contact| puts contact.name }
   #      # Prints out "Tom" and "Mike"
-  #      @deal.contacts.collect { |contact| contact.name } 
+  #      @deal.contacts.collect { |contact| contact.name }
   #      # => ["Tom",  "Mike"]
-  #      @deal.contacts.reject { |contact| contact.name == 'Tom' } 
+  #      @deal.contacts.reject { |contact| contact.name == 'Tom' }
   #      # => ["Mike"]
-  # 
-  # 
+  #
+  #
   # == Updating
-  # 
+  #
   # To update the Contacts that are assigned to a Deal|, call the _update_ method on the Contacts collection:
-  # 
-  # 
+  #
+  #
   #      @deal.contacts.collect(&:id)
   #      # => ['1', '2', '3']
   #      @deal.contacts.update('1,2')
   #      # => true
   #      @deal.contacts.collect(&:id)
   #      # => ['1', '2']
-  # 
-  # 
+  #
+  #
   # *Note*: The Contacts must have the same Client as the Deal or update will return _false_
   class Contact < Resource
-    belongs_to :client
+    belongs_to :organisation, :class_name => 'Contact'
+
+    has_many :notes
+    has_many :reminders
+
+    def before_save
+      @attributes.delete('organisation')
+      @attributes.delete('linkedin_display')
+      @attributes.delete('tags_joined_by_comma')
+    end
+
   end
-  
+
 end