Add support for listing contact segments (#557)

Author: rahulgdsouza

README.md

@@ -125,6 +125,9 @@ contact.create_note(body: "<p>Text for the note</p>")
 # List notes for a contact
 contact.notes.each {|n| p n.body}
 
+# List segments for a contact
+contact.segments.each {|segment| p segment.name}
+
 # Add a contact to a company
 company = intercom.companies.find(id: "123")
 contact.add_company(id: company.id)

lib/intercom/contact.rb

@@ -13,6 +13,7 @@ class Contact
     nested_resource_methods :tag, operations: %i[add delete list]
     nested_resource_methods :note, operations: %i[create list]
     nested_resource_methods :company, operations: %i[add delete list]
+    nested_resource_methods :segment, operations: %i[list]
 
     def self.collection_proxy_class
       Intercom::BaseCollectionProxy

lib/intercom/segment.rb

@@ -3,5 +3,9 @@
 module Intercom
   class Segment
     include Traits::ApiResource
+
+    def self.collection_proxy_class
+      Intercom::BaseCollectionProxy
+    end
   end
 end

spec/unit/intercom/contact_spec.rb

@@ -285,6 +285,13 @@
       _(proxy.resource_class).must_equal Intercom::Note
     end
 
+    it 'returns a collection proxy for listing segments' do
+      proxy = contact.segments
+      _(proxy.resource_name).must_equal 'segments'
+      _(proxy.url).must_equal '/contacts/1/segments'
+      _(proxy.resource_class).must_equal Intercom::Segment
+    end
+
     it 'returns a collection proxy for listing tags' do
       proxy = contact.tags
       _(proxy.resource_name).must_equal 'tags'