sugarcrm 0.9.0 → 0.9.1

data/README.rdoc

@@ -12,7 +12,7 @@ RubyGem for interacting with SugarCRM via REST.
 
 A less clunky way to interact with SugarCRM via REST.
 
-Instead of SugarCRM.connection.get_entry("Users", "1"), you can use SugarCRM::User.find(1).  There is also support for collections à la SugarCRM::User.find(1).email_addresses, or SugarCRM::Contact.first.meetings << new_meeting.  ActiveRecord style finders are in place, with limited support for conditions and joins. 
+Instead of SugarCRM.connection.get_entry("Users", "1") you could use SugarCRM::User.find(1).  There is support for collections à la SugarCRM::User.find(1).email_addresses, or SugarCRM::Contact.first.meetings << new_meeting.  ActiveRecord style finders are in place, with limited support for conditions and joins. 
 
 == FEATURES/PROBLEMS:
 

data/VERSION

@@ -1 +1 @@
-0.9.0
+0.9.1

data/lib/sugarcrm/associations/association_methods.rb

@@ -44,15 +44,10 @@ module SugarCRM; module AssociationMethods
         query_association :#{k}
       end
       ?
-      #seed_association_cache(k.to_syn)
     end
     self.class.association_methods_generated = true
   end
   
-#  def seed_association_cache(association)
-#    @association_cache[association] = AssociationCollection.new(self,association)
-#  end
-  
   # Returns the records from the associated module or returns the cached copy if we've already 
   # loaded it.  Force a reload of the records with reload=true
   #
@@ -76,17 +71,4 @@ module SugarCRM; module AssociationMethods
     collection
   end
 
-  # Loads related records for the given association
-#  def load_associations_for(association)
-#    SugarCRM.connection.get_relationships(self.class._module.name, self.id, association.to_s)
-#  end
-  
-  # pushes an element to the association collection
-  def append_to_association(association, record)
-    collection = query_association(association)
-    collection << record
-    collection
-  end
-    
-  
 end; end

data/lib/sugarcrm/attributes/attribute_methods.rb

@@ -2,7 +2,6 @@ module SugarCRM; module AttributeMethods
 
   module ClassMethods
     # Returns a hash of the module fields from the module
-    # merges matching keys if another attributes hash is provided
     def attributes_from_module_fields
       fields = {}.with_indifferent_access
       self._module.fields.keys.sort.each do |k|
@@ -12,10 +11,6 @@ module SugarCRM; module AttributeMethods
     end
   end
     
-  # TODO: Object.id is not being updated properly.  Figure out why...  
-  alias :pk :id
-  alias :primary_key :id
-  
   # Determines if attributes or associations have been changed
   def changed?
     return true if attributes_changed?
@@ -43,7 +38,7 @@ module SugarCRM; module AttributeMethods
   # with attributes from the module.fields array.  Skips any
   # fields that aren't in the module.fields array
   #
-  # BUG: SugarCRM likes to return fields you don't ask for, and
+  # BUG: SugarCRM likes to return fields you don't ask for and
   # aren't fields on a module (i.e. modified_user_name).  This 
   # royally screws up our typecasting code, so we handle it here.
   def merge_attributes(attrs={})

data/lib/sugarcrm/attributes/attribute_serializers.rb

@@ -21,9 +21,9 @@ module SugarCRM; module AttributeSerializers
   end
 
   # Converts the modified_attributes hash into format recognizable by Sugar
-  # { :last_name => {:old => "Smit", :new => "Smith"}} 
+  # {:last_name => {:old => "Smit", :new => "Smith"}} 
   # becomes
-  # { :last_name => {:name => "last_name", :value => "Smith"}}  
+  # {:last_name => {:name => "last_name", :value => "Smith"}}  
   def serialize_modified_attributes
     attr_hash = {}
     @modified_attributes.each_pair do |name,hash|
@@ -33,7 +33,7 @@ module SugarCRM; module AttributeSerializers
     attr_hash
   end
   
-  # Un-typecasts the attribute - false becomes 0
+  # Un-typecasts the attribute - false becomes "0", 5234 becomes "5234", etc.
   def serialize_attribute(name,value)
     attr_value = value
     attr_type  = attr_type_for(name) 

data/lib/sugarcrm/attributes/attribute_typecast.rb

@@ -4,13 +4,11 @@ module SugarCRM; module AttributeTypeCast
   
   # Returns the attribute type for a given attribute
   def attr_type_for(attribute)
-    # sometimes the module fields aren't loaded. Why?
     fields = self.class._module.fields
     field  = fields[attribute]
     raise UninitializedModule, "SugarCRM::Module #{self.class._module.name} was not initialized properly (fields.length == 0)" if fields.length == 0
     raise InvalidAttribute, "#{self.class}_module.fields does not contain an entry for #{attribute} (of type: #{attribute.class})\nValid fields: #{self.class._module.fields.keys.sort.join(", ")}" if field.nil?
     raise InvalidAttributeType, "#{self.class}._module.fields[#{attribute}] does not have a key for \'type\'" if field["type"].nil?
-    #return :string unless field.is_a? Hash
     field["type"].to_sym
   end
 

data/lib/sugarcrm/base.rb

@@ -32,7 +32,7 @@ module SugarCRM; class Base
       @debug  = options[:debug]
       @@connection = SugarCRM::Connection.new(url, user, pass, options)
     end
-  
+    
     def find(*args)
       options = args.extract_options!
       validate_find_options(options)
@@ -199,23 +199,6 @@ module SugarCRM; class Base
         if match.finder?
           finder = match.finder
           bang = match.bang?
-          # def self.find_by_login_and_activated(*args)
-          #   options = args.extract_options!
-          #   attributes = construct_attributes_from_arguments(
-          #     [:login,:activated],
-          #     args
-          #   )
-          #   finder_options = { :conditions => attributes }
-          #   validate_find_options(options)
-          #
-          #   if options[:conditions]
-          #     with_scope(:find => finder_options) do
-          #       find(:first, options)
-          #     end
-          #   else
-          #     find(:first, options.merge(finder_options))
-          #   end
-          # end
           self.class_eval <<-EOS, __FILE__, __LINE__ + 1
             def self.#{method_id}(*args)
               options = args.extract_options!
@@ -239,31 +222,6 @@ module SugarCRM; class Base
           send(method_id, *arguments)
         elsif match.instantiator?
           instantiator = match.instantiator
-          # def self.find_or_create_by_user_id(*args)
-          #   guard_protected_attributes = false
-          #
-          #   if args[0].is_a?(Hash)
-          #     guard_protected_attributes = true
-          #     attributes = args[0].with_indifferent_access
-          #     find_attributes = attributes.slice(*[:user_id])
-          #   else
-          #     find_attributes = attributes = construct_attributes_from_arguments([:user_id], args)
-          #   end
-          #
-          #   options = { :conditions => find_attributes }
-          #   set_readonly_option!(options)
-          #
-          #   record = find(:first, options)
-          #
-          #   if record.nil?
-          #     record = self.new { |r| r.send(:attributes=, attributes, guard_protected_attributes) }
-          #     yield(record) if block_given?
-          #     record.save
-          #     record
-          #   else
-          #     record
-          #   end
-          # end
           self.class_eval <<-EOS, __FILE__, __LINE__ + 1
             def self.#{method_id}(*args)
               attributes = [:#{attribute_names.join(',:')}]
@@ -322,10 +280,6 @@ module SugarCRM; class Base
   end
 
   # Creates an instance of a Module Class, i.e. Account, User, Contact, etc.
-  # This call depends upon SugarCRM.modules having actual data in it.  If you 
-  # are using Base.establish_connection, you should be fine.  But if you are 
-  # using the Connection class by itself, you may need to prime the pump with
-  # a call to Module.register_all
   def initialize(attributes={})
     @modified_attributes = {}
     merge_attributes(attributes.with_indifferent_access)
@@ -362,8 +316,8 @@ module SugarCRM; class Base
     true
   end
   
-  # Saves the current object, checks that required fields are present.
-  # raises an exception if a save fails
+  # Saves the current object, and any modified associations. 
+  # Raises an exceptions if save fails for any reason.
   def save!
     save_modified_attributes
     save_modified_associations
@@ -400,8 +354,6 @@ module SugarCRM; class Base
     id.hash
   end
   
-  
-  # Wrapper around class attribute
   def attribute_methods_generated?
     self.class.attribute_methods_generated
   end  

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: sugarcrm
 version: !ruby/object:Gem::Version 
-  hash: 59
+  hash: 57
   prerelease: false
   segments: 
   - 0
   - 9
-  - 0
-  version: 0.9.0
+  - 1
+  version: 0.9.1
 platform: ruby
 authors: 
 - Carl Hicks
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-12-29 00:00:00 -08:00
+date: 2011-01-04 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency