clio_client 0.0.5 → 0.1.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    NDBlZmYwNzdmM2I4MzQ4NzZlMzZhNjEwYWJiZTg0MzQzZTBkNWYzYQ==
+    NjJjZjQzMzQwMjdiMzNkNzUwZTlkZTlkZDdlMDk0NTk2NDgwOTc0Mw==
   data.tar.gz: !binary |-
-    OGE0NTk3ZTJlNTE4YjRkYzIwN2UxZmYyYzU1OTAyMzgwNGI4Y2Q2MA==
+    YTE1YjQ2OTU0ODBlZGRkMjg4ZjU0ZGYwNGEyMjM4NzZlY2U1ZDE3ZA==
 SHA512:
   metadata.gz: !binary |-
-    MGI2N2UyM2UxODUxYjcxZTQ3M2ExNzE4YmExMDFhN2ZmOTk3ZTcwY2QxMDRl
-    MmRmZDcwMTliMTNjODU5YTdlYzM1MDY2ZjM1NGVhMDg4ZTVmZGIwNWUxNWIw
-    ZDU2Yjk3ZTc4NTZmMWEzYzg5YzYwNjM1ZjRhZDkxNGQ3OGRiMWY=
+    NDAxNGI0MzZmYzZjZjgyMDFmYjViODFkZDY4ZWJjYWY5NmU3OTRjNzk4N2I2
+    MTc2NTI5MGVmYWE2MjM0Y2M1MTljNDhiZTM5NmM3ZjEyZjE0MjZhYTUwOGYz
+    Y2MxMTZiNmI3ZTE4N2ExYTg2YzIzM2NiNmY0NjcwZjYwNGVjN2Y=
   data.tar.gz: !binary |-
-    NDJmOGMzYmU1Nzc1MjE0YTQwYTU5OGJiMmVkMjAwYjFlYTAyMjhlZWRjNWNj
-    MzA5NDg4MmE0ZjQwNzExNDM2Yjg5OTQ2OTA5N2UyZjEwMzMxOTRkMzBkMTY0
-    YTg2Mzc3YjMxZTczZjQ1NjFiMDg4Zjk3NGM4ZmQ5ZDMyMDc1NGQ=
+    NmI0MjJjZDhiNDQ2MTM0Mjg2MGVkMjc4MmU4NmFlM2MwNTBiN2RjNDMwZTZk
+    M2JiMjI4OWY4ZjYzODhkYWFjZjI2NDBlOWIxMmEwMzdmYjYxNWE2ZjZiOTk4
+    MmE5N2ZhODhkYTRiODYyYjMyODJjMTc5NGM3NzM1ODAyOGNkZmM=

data/lib/clio_client.rb

@@ -14,33 +14,35 @@ module ClioClient
 
   # Models
   {
-    :Account =>             'account',
-    :Activity =>            'activity',
-    :ActivityDescription => 'activity_description',
-    :Bill =>                'bill',
-    :CalendarEntry =>       'calendar_entry',
-    :Calendar =>            'calendar',
-    :Communication =>       'communication',
-    :Company =>             'company',
-    :Contact =>             'contact',
-    :CustomFieldSet =>      'custom_field_set',
-    :CustomField =>         'custom_field',
-    :DocumentVersion =>     'document_version',
-    :Document =>            'document',
-    :ExpenseEntry =>        'expense_entry',
-    :EmailCommunication =>  'email_communication',
-    :Group =>               'group',
-    :Matter =>              'matter',
-    :Note =>                'note',
-    :Person =>              'person',
-    :PhoneCommunication =>  'phone_communication',
-    :PracticeArea =>        'practice_area',
-    :TimeEntry =>           'time_entry',
-    :Relationship =>        'relationship',
-    :Task =>                'task',
-    :TimelineEvent =>       'timeline_event',
-    :Timer =>               'timer',
-    :User =>                'user'
+    :Account =>                 'account',
+    :Activity =>                'activity',
+    :ActivityDescription =>     'activity_description',
+    :Bill =>                    'bill',
+    :CalendarEntry =>           'calendar_entry',
+    :Calendar =>                'calendar',
+    :ClientConnectPermission => 'client_connect_permission',
+    :Communication =>           'communication',
+    :Company =>                 'company',
+    :Contact =>                 'contact',
+    :CustomFieldSet =>          'custom_field_set',
+    :CustomField =>             'custom_field',
+    :DocumentCategory =>        'document_category',
+    :DocumentVersion =>         'document_version',
+    :Document =>                'document',
+    :ExpenseEntry =>            'expense_entry',
+    :EmailCommunication =>      'email_communication',
+    :Group =>                   'group',
+    :Matter =>                  'matter',
+    :Note =>                    'note',
+    :Person =>                  'person',
+    :PhoneCommunication =>      'phone_communication',
+    :PracticeArea =>            'practice_area',
+    :TimeEntry =>               'time_entry',
+    :Relationship =>            'relationship',
+    :Task =>                    'task',
+    :TimelineEvent =>           'timeline_event',
+    :Timer =>                   'timer',
+    :User =>                    'user'
   }.each_pair do |klass, file| 
     autoload klass, "clio_client/models/#{file}"
   end
@@ -73,27 +75,29 @@ module ClioClient
 
   module Api
     {
-      :Base =>              'base',
-      :Activity =>           'activity',
-      :ActivityDescription =>'activity_description',
-      :Bill =>               'bill',
-      :CalendarEntry =>      'calendar_entry',
-      :Calendar =>           'calendar',
-      :Communication =>      'communication',
-      :Contact =>            'contact',
-      :CustomFieldSet =>     'custom_field_set',    
-      :CustomField =>        'custom_field',
-      :DocumentVersion =>    'document_version',
-      :Document =>           'document',
-      :Group =>              'group',
-      :Matter =>             'matter',
-      :Note =>               'note',
-      :PracticeArea =>       'practice_area',
-      :Relationship =>       'relationship',
-      :Task =>               'task',
-      :TimelineEvent =>     'timeline_event',
-      :Timer =>              'timer',
-      :User =>               'user',
+      :Base =>                    'base',
+      :Activity =>                'activity',
+      :ActivityDescription =>     'activity_description',
+      :Bill =>                    'bill',
+      :CalendarEntry =>           'calendar_entry',
+      :Calendar =>                'calendar',
+      :ClientConnectPermission => 'client_connect_permission',
+      :Communication =>           'communication',
+      :Contact =>                 'contact',
+      :CustomFieldSet =>          'custom_field_set',    
+      :CustomField =>             'custom_field',
+      :DocumentCategory =>        'document_category',
+      :DocumentVersion =>         'document_version',
+      :Document =>                'document',
+      :Group =>                   'group',
+      :Matter =>                  'matter',
+      :Note =>                    'note',
+      :PracticeArea =>            'practice_area',
+      :Relationship =>            'relationship',
+      :Task =>                    'task',
+      :TimelineEvent =>           'timeline_event',
+      :Timer =>                   'timer',
+      :User =>                    'user',
 
       :Crudable =>          'crudable',
       :Findable =>          'findable',

data/lib/clio_client/api/activity.rb

@@ -9,8 +9,11 @@ module ClioClient
       private
       def data_klass(attributes)
         accepted_types = %w(TimeEntry ExpenseEntry)
-        if accepted_types.include? attributes["type"]
-          ClioClient.const_get attributes["type"].intern
+        type = attributes["type"] || attriutes[:type]
+        if accepted_types.include? type
+          ClioClient.const_get type
+        else
+          ClioClient::Activity
         end
       end
 

data/lib/clio_client/api/client_connect_permission.rb

@@ -0,0 +1,20 @@
+module ClioClient
+  module Api
+    class ClientConnectPermission < Base
+
+      include ClioClient::Api::Listable
+      include ClioClient::Api::Findable
+      include ClioClient::Api::Crudable
+
+      private
+      def data_klass(*args)
+        ClioClient::ClientConnectPermission
+      end
+
+      def end_point_url;     'client_connect_permissions';  end
+      def plural_resource;   'client_connect_permissions';  end
+      def singular_resource; 'client_connect_permission';   end
+
+    end
+  end
+end

data/lib/clio_client/api/contact.rb

@@ -9,8 +9,11 @@ module ClioClient
       private
       def data_klass(attributes)
         accepted_types = %w(Person Company)
-        if accepted_types.include? attributes["type"]
-          ClioClient.const_get attributes["type"].intern
+        type = attributes["type"] || attriutes[:type]
+        if accepted_types.include? type
+          ClioClient.const_get type
+        else
+          ClioClient::Contact
         end
       end
 

data/lib/clio_client/api/crudable.rb

@@ -7,17 +7,40 @@ module ClioClient
       end
 
       def create(params = {})
-        response = session.post(end_point_url, {singular_resource => params}.to_json)
-        data_item(response[singular_resource])        
+        begin
+          resource = params.is_a?(Array) ? create_plural(params) : create_singular(params)
+        rescue ClioClient::UnknownResponse
+          false
+        end
       end
 
       def update(id, params = {})
-        response = session.put("#{end_point_url}/#{id}", {singular_resource => params}.to_json)
-        data_item(response[singular_resource])        
+        begin
+          response = session.put("#{end_point_url}/#{id}", {singular_resource => params}.to_json)
+          data_item(response[singular_resource])        
+        rescue ClioClient::UnknownResponse
+          false
+        end
       end
 
       def destroy(id)
-        session.delete("#{end_point_url}/#{id}", false)
+        begin
+          session.delete("#{end_point_url}/#{id}", false)
+        rescue ClioClient::UnknownResponse
+          false
+        end
+      end
+
+      private
+
+      def create_singular(params)
+        response = session.post(end_point_url, {singular_resource => params}.to_json)
+        data_item(response[singular_resource])
+      end
+
+      def create_plural(params)
+        response = session.post(end_point_url, {plural_resource => params}.to_json)
+        response[plural_resource].map { |resource| data_item(resource) }
       end
 
     end

data/lib/clio_client/api/document_category.rb

@@ -0,0 +1,19 @@
+module ClioClient
+  module Api
+    class DocumentCategory < Base
+
+      include ClioClient::Api::Listable
+      include ClioClient::Api::Findable
+
+      private
+      def data_klass(*args)
+        ClioClient::DocumentCategory
+      end
+
+      def end_point_url;     'document_categories';  end
+      def plural_resource;   'document_categories';  end
+      def singular_resource; 'document_category';   end
+
+    end
+  end
+end

data/lib/clio_client/api/findable.rb

@@ -6,7 +6,7 @@ module ClioClient
         begin
           response = session.get("#{end_point_url}/#{id}")
           data_item(response[singular_resource])
-        rescue ClioClient::ResourceNotFound
+        rescue ClioClient::ResourceNotFound, ClioClient::UnknownResponse
           nil
         end
       end

data/lib/clio_client/api/listable.rb

@@ -9,12 +9,16 @@ module ClioClient
       end
 
       def list(params = {})
-        response = session.get(end_point_url, params)
-        @pagination_details = {last_query: params, records: 0, next_offset: response["next_offset"], 
-          total_records: response["total_records"]
-        }
-        @pagination_details[:records] += response["records"] || 0
-        response[plural_resource].collect{ |r| data_item(r) }
+        begin
+          response = session.get(end_point_url, params)
+          @pagination_details = {last_query: params, records: 0, next_offset: response["next_offset"], 
+            total_records: response["total_records"]
+          }
+          @pagination_details[:records] += response["records"] || 0
+          response[plural_resource].collect{ |r| data_item(r) }
+        rescue ClioClient::UnknownResponse
+          []
+        end
       end
       
       def next_page

data/lib/clio_client/api/timeline_event.rb

@@ -3,6 +3,15 @@ module ClioClient
     class TimelineEvent < Base
 
       include ClioClient::Api::Listable
+      include ClioClient::Api::Crudable
+
+      def update
+        raise NotImplementedError
+      end
+
+      def destroy
+        raise NotImplementedError
+      end
 
       private
 

data/lib/clio_client/http.rb

@@ -1,8 +1,9 @@
 module ClioClient
 
-  class Unauthorized < Exception; end 
-  class ResourceNotFound < Exception; end
-  class BadRequest < Exception; end
+  class Unauthorized < StandardError; end 
+  class ResourceNotFound < StandardError; end
+  class BadRequest < StandardError; end
+  class UnknownResponse < StandardError; end
   
   module Http
 
@@ -48,7 +49,7 @@ module ClioClient
     end
 
     def make_api_request(req, uri, parse = true)
-      return nil if self.access_token.nil? || self.access_token.empty?
+      raise ClioClient::Unauthorized if self.access_token.nil? || self.access_token.empty?
       req.add_field("Authorization", "Bearer #{self.access_token}")
       make_request(req, uri, parse)
     end
@@ -64,27 +65,33 @@ module ClioClient
     end
 
     def parse_response(res, parse)
-      if res.body !~ /^\s*$/ && !res.body.nil?
-        body = parse ? JSON.parse(res.body) : res.body
-      end
-
       case res
       when Net::HTTPNotFound
-        raise ClioClient::ResourceNotFound.new(body["message"])
+        raise ClioClient::ResourceNotFound.new(parse_body(res.body)["message"])
       when Net::HTTPSuccess
-        body
+        parse ? parse_body(res.body) : res.body
       when Net::HTTPUnauthorized
-        raise ClioClient::Unauthorized.new(body["message"])
+        begin
+          message = parse_body(res.body)["message"]
+        rescue JSON::ParserError
+          message = res.body
+        end
+        raise ClioClient::Unauthorized.new(message)
       when Net::HTTPBadRequest
-        raise ClioClient::BadRequest.new(body["message"])        
+        raise ClioClient::BadRequest.new(parse_body(res.body)["message"])
       when Net::HTTPSeeOther
         res["Location"]
       else
-        raise "Unknown #{res.class} response. #{body["message"]}"
+        raise UnknownResponse.new(res.body)
       end
     end
 
     private
+    def parse_body(body)
+      if body !~ /^\s*$/ && !body.nil?
+        JSON.parse(body)
+      end
+    end
     def api_prefix; "/api/v2"; end
 
   end

data/lib/clio_client/models/account.rb

@@ -6,7 +6,9 @@ module ClioClient
                    created_at:        {type: :datetime, readonly: true},
                    updated_at:        {type: :datetime, readonly: true},
                    maildrop_address:  {type: :string},
-                   name:              {type: :string, readonly: true}
+                   name:              {type: :string, readonly: true},
+                   date_format:       {type: :string, readonly: true},
+                   time_format:       {type: :string, readonly: true}
                    )
     
     has_association :owner, ClioClient::User

data/lib/clio_client/models/activity.rb

@@ -17,6 +17,7 @@ module ClioClient
     
 
     has_association :user,                 ClioClient::User
+    has_association :bill,                 ClioClient::Bill
     has_association :matter,               ClioClient::Matter
     has_association :activity_description, ClioClient::ActivityDescription
     has_association :communication,        ClioClient::Communication

data/lib/clio_client/models/client_connect_permission.rb

@@ -0,0 +1,25 @@
+module ClioClient
+  class ClientConnectPermission < Resource
+
+    set_attributes(id:                     {type: :int, readonly: true},
+                   created_at:             {type: :datetime, readonly: true},
+                   updated_at:             {type: :datetime, readonly: true},
+                   client_connect_user_id: {type: :int, readonly: true},
+                   resource_type:          {type: :string},
+                   )
+
+    has_association :contact, ClioClient::Contact
+    has_association :user,    ClioClient::User
+    has_association :matter,  ClioClient::Matter
+    has_association(:resource, ClioClient::Resource,
+      :polymorphic => true,
+      :accepted_types => %w(Bill Document Task Matter CalendarEntry))
+
+    private
+
+    def api
+      session.client_connect_permissions
+    end
+      
+  end
+end

data/lib/clio_client/models/contact.rb

@@ -9,7 +9,9 @@ module ClioClient
                    prefix:               {type: :string                  },
                    first_name:           {type: :string                  },
                    last_name:            {type: :string                  }, 
-                   title:                {type: :string                  }
+                   title:                {type: :string                  },
+                   clio_connect_email:   {type: :string,   readonly: true},
+                   email:                {type: :string,   readonly: true}
                    )
 
     has_many_association :phone_numbers,       ClioClient::PhoneNumber

data/lib/clio_client/models/document.rb

@@ -8,12 +8,14 @@ module ClioClient
                    category:      {type: :string, readonly: true},
                    content_type:  {type: :string, readonly: true},
                    filename:      {type: :string, readonly: true},
+                   number:        {type: :int, readonly: true},
                    size:          {type: :int, readonly: true},
-                   last_modified: {type: :datetime},
+                   last_modified_at: {type: :datetime},
                    )
 
     has_association :matter, ClioClient::Matter
     has_association :user,   ClioClient::User
+    has_association :document_category,   ClioClient::DocumentCategory
     has_many_association :document_versions, ClioClient::DocumentVersion
 
     def document_versions=(arr)

data/lib/clio_client/models/document_category.rb

@@ -0,0 +1,14 @@
+module ClioClient
+
+  class DocumentCategory < Resource
+    
+    set_attributes(id:                {type: :int, readonly: true},
+                   account_id:        {type: :int, readonly: true},
+                   created_at:        {type: :datetime, readonly: true},
+                   updated_at:        {type: :datetime, readonly: true},
+                   name:              {type: :string, readonly: true}
+                   )
+
+  end
+
+end

data/lib/clio_client/models/document_version.rb

@@ -8,7 +8,7 @@ module ClioClient
                    updated_at:    {type: :datetime, readonly: true},
                    size:          {type: :int, readonly: true},
                    content_type:  {type: :string, readonly: true},
-                   last_modified: {type: :datetime},
+                   last_modified_at: {type: :datetime},
                    filename:      {type: :string}
                    )
 

data/lib/clio_client/models/matter.rb

@@ -15,6 +15,7 @@ module ClioClient
                    close_date:            {type: :date},
                    billable:              {type: :boolean},
                    maildrop_address:      {type: :int, readonly: true},
+                   group_id:              {type: :int},
                    )
 
     alias_method :name, :display_number

data/lib/clio_client/models/user.rb

@@ -11,9 +11,15 @@ module ClioClient
                    last_name:         {type: :string, readonly: true}, 
                    email:             {type: :string, readonly: true},
                    enabled:           {type: :boolean, readonly: true},
-                   name:              {type: :string, readonly: true}
+                   name:              {type: :string, readonly: true},
+                   clio_connect:      {type: :boolean, readonly: true},
+                   has_avatar:        {type: :boolean, readonly: true},
+                   co_counsel:        {type: :boolean, readonly: true}
                    )
 
+    has_association(:contact,            ClioClient::Contact, 
+                    :polymorphic => true, :accepted_types => %w(Person Company))
+
     def avatar
       api.avatar(id)
     end

data/lib/clio_client/resource.rb

@@ -71,6 +71,7 @@ module ClioClient
           write_attribute("#{name}_id", attributes["id"])
           if options[:polymorphic]
             obj = polymorphic_object(attributes, options[:accepted_types])
+            obj ||= klass.new(attributes, session)
           else
             obj = klass.new(attributes, session)
           end
@@ -84,7 +85,8 @@ module ClioClient
         define_method "#{name}=" do |arr|
           many = arr.collect do |attributes| 
             if options[:polymorphic]
-              polymorphic_object(attributes, options[:accepted_types])
+              obj = polymorphic_object(attributes, options[:accepted_types])
+              obj ||= klass.new(attributes, session)
             else
               klass.new(attributes, session)
             end
@@ -167,7 +169,7 @@ module ClioClient
       when :decimal
         val.to_f
       when :boolean 
-        val == "true"
+        val == true || val == "true"
       when :datetime 
         val.kind_of?(DateTime) ? val : DateTime.parse(val)
       when :datetime 

data/lib/clio_client/session.rb

@@ -23,26 +23,28 @@ module ClioClient
       self.end_points = {}
     end
 
-    { activities:            ClioClient::Api::Activity,
-      activity_descriptions: ClioClient::Api::ActivityDescription,
-      bills:                 ClioClient::Api::Bill,
-      calendar_entries:      ClioClient::Api::CalendarEntry,
-      calendars:             ClioClient::Api::Calendar,
-      communications:        ClioClient::Api::Communication,
-      contacts:              ClioClient::Api::Contact,
-      custom_field_sets:     ClioClient::Api::CustomFieldSet,
-      custom_fields:         ClioClient::Api::CustomField,
-      document_versions:     ClioClient::Api::DocumentVersion,
-      documents:             ClioClient::Api::Document,
-      groups:                ClioClient::Api::Group,
-      matters:               ClioClient::Api::Matter,
-      notes:                 ClioClient::Api::Note,
-      practice_areas:        ClioClient::Api::PracticeArea,
-      relationships:         ClioClient::Api::Relationship,
-      tasks:                 ClioClient::Api::Task,
-      timeline_events:       ClioClient::Api::TimelineEvent,
-      timer:                 ClioClient::Api::Timer,
-      users:                 ClioClient::Api::User
+    { activities:                 ClioClient::Api::Activity,
+      activity_descriptions:      ClioClient::Api::ActivityDescription,
+      bills:                      ClioClient::Api::Bill,
+      calendar_entries:           ClioClient::Api::CalendarEntry,
+      calendars:                  ClioClient::Api::Calendar,
+      client_connect_permissions: ClioClient::Api::ClientConnectPermission,
+      communications:             ClioClient::Api::Communication,
+      contacts:                   ClioClient::Api::Contact,
+      custom_field_sets:          ClioClient::Api::CustomFieldSet,
+      custom_fields:              ClioClient::Api::CustomField,
+      document_versions:          ClioClient::Api::DocumentVersion,
+      documents:                  ClioClient::Api::Document,
+      document_categories:        ClioClient::Api::DocumentCategory,
+      groups:                     ClioClient::Api::Group,
+      matters:                    ClioClient::Api::Matter,
+      notes:                      ClioClient::Api::Note,
+      practice_areas:             ClioClient::Api::PracticeArea,
+      relationships:              ClioClient::Api::Relationship,
+      tasks:                      ClioClient::Api::Task,
+      timeline_events:            ClioClient::Api::TimelineEvent,
+      timer:                      ClioClient::Api::Timer,
+      users:                      ClioClient::Api::User
     }.each_pair do |method, klass| 
       define_method method do
         end_points[method] ||= klass.new(self)

data/lib/clio_client/support/email_address.rb

@@ -5,7 +5,8 @@ module ClioClient
                    created_at:              {type: :datetime, readonly: true},
                    updated_at:              {type: :datetime, readonly: true},
                    name:                    {type: :string},
-                   address:                 {type: :string}
+                   address:                 {type: :string},
+                   default_email:           {type: :boolean}
                    )
 
   end

data/lib/clio_client/version.rb

@@ -1,3 +1,3 @@
 module ClioClient
-  VERSION = "0.0.5"
+  VERSION = "0.1.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: clio_client
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.1.0
 platform: ruby
 authors:
 - Kyle d'Oliveira
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-15 00:00:00.000000000 Z
+date: 2014-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -100,12 +100,14 @@ files:
 - lib/clio_client/api/bill.rb
 - lib/clio_client/api/calendar.rb
 - lib/clio_client/api/calendar_entry.rb
+- lib/clio_client/api/client_connect_permission.rb
 - lib/clio_client/api/communication.rb
 - lib/clio_client/api/contact.rb
 - lib/clio_client/api/crudable.rb
 - lib/clio_client/api/custom_field.rb
 - lib/clio_client/api/custom_field_set.rb
 - lib/clio_client/api/document.rb
+- lib/clio_client/api/document_category.rb
 - lib/clio_client/api/document_version.rb
 - lib/clio_client/api/findable.rb
 - lib/clio_client/api/group.rb
@@ -126,12 +128,14 @@ files:
 - lib/clio_client/models/bill.rb
 - lib/clio_client/models/calendar.rb
 - lib/clio_client/models/calendar_entry.rb
+- lib/clio_client/models/client_connect_permission.rb
 - lib/clio_client/models/communication.rb
 - lib/clio_client/models/company.rb
 - lib/clio_client/models/contact.rb
 - lib/clio_client/models/custom_field.rb
 - lib/clio_client/models/custom_field_set.rb
 - lib/clio_client/models/document.rb
+- lib/clio_client/models/document_category.rb
 - lib/clio_client/models/document_version.rb
 - lib/clio_client/models/email_communication.rb
 - lib/clio_client/models/expense_entry.rb