xcodeproj 0.4.0.rc2 → 0.4.0.rc3

data/lib/xcodeproj.rb

@@ -1,5 +1,5 @@
 module Xcodeproj
-  VERSION = '0.4.0.rc2'
+  VERSION = '0.4.0.rc3'
 
   class PlainInformative < StandardError
   end

data/lib/xcodeproj/constants.rb

@@ -16,31 +16,37 @@ module Xcodeproj
     #
     KNOWN_ISAS = {
       'AbstractObject' => %w[
-      PBXBuildFile
-      AbstractBuildPhase
-      PBXBuildRule
-      XCBuildConfiguration
-      XCConfigurationList
-      PBXContainerItemProxy
-      PBXFileReference
-      PBXGroup
-      PBXNativeTarget
-      PBXProject
-      PBXTargetDependency
+        PBXBuildFile
+        AbstractBuildPhase
+        PBXBuildRule
+        XCBuildConfiguration
+        XCConfigurationList
+        PBXContainerItemProxy
+        PBXFileReference
+        PBXGroup
+        PBXProject
+        PBXTargetDependency
+        PBXReferenceProxy
       ],
 
       'AbstractBuildPhase' => %w[
-      PBXCopyFilesBuildPhase
-      PBXResourcesBuildPhase
-      PBXSourcesBuildPhase
-      PBXFrameworksBuildPhase
-      PBXHeadersBuildPhase
-      PBXShellScriptBuildPhase
+        PBXCopyFilesBuildPhase
+        PBXResourcesBuildPhase
+        PBXSourcesBuildPhase
+        PBXFrameworksBuildPhase
+        PBXHeadersBuildPhase
+        PBXShellScriptBuildPhase
+      ],
+
+      'AbstractTarget' => %w[
+        PBXNativeTarget
+        PBXAggregateTarget
+        PBXLegacyTarget
       ],
 
       'PBXGroup' => %w[
-      XCVersionGroup
-      PBXVariantGroup
+        XCVersionGroup
+        PBXVariantGroup
       ]
     }.freeze
 

data/lib/xcodeproj/project.rb

@@ -176,6 +176,7 @@ module Xcodeproj
     #
     def new_from_plist(uuid, objects_by_uuid_plist, root_object = false)
       attributes = objects_by_uuid_plist[uuid]
+      raise "[Xcodeproj] Unable to find attributes for UUID #{uuid}" unless attributes
       klass = Object.const_get(attributes['isa'])
       object = klass.new(self, uuid)
       object.add_referrer(self) if root_object

data/lib/xcodeproj/project/object.rb

@@ -156,6 +156,11 @@ module Xcodeproj
             list = attrb.get_value(self)
             list.delete(object)
           end
+
+          references_by_keys_attributes.each do |attrb|
+            list = attrb.get_value(self)
+            list.each { |dictionary| dictionary.remove_reference(object) }
+          end
         end
 
         # @!group Plist related methods
@@ -191,12 +196,25 @@ module Xcodeproj
           to_many_attributes.each do |attrb|
             ref_uuids = object_plist[attrb.plist_name] || []
             list = attrb.get_value(self)
-            ref_uuids.each do |ref_uuid|
-              ref = project.objects_by_uuid[ref_uuid] || project.new_from_plist(ref_uuid, objects_by_uuid_plist)
-              list << ref
+            ref_uuids.each do |uuid|
+              list << object_with_uuid(uuid, objects_by_uuid_plist)
+            end
+            object_plist.delete(attrb.plist_name)
+          end
+
+          references_by_keys_attributes.each do |attrb|
+            hashes = object_plist[attrb.plist_name] || {}
+            list = attrb.get_value(self)
+            hashes.each do |hash|
+              dictionary = ObjectDictionary.new(attrb, self)
+              hash.each do |key, uuid|
+                dictionary[key] = object_with_uuid(uuid, objects_by_uuid_plist)
+              end
+              list << dictionary
             end
             object_plist.delete(attrb.plist_name)
           end
+
           unless object_plist.empty?
             raise "[!] Xcodeproj doesn't know about the following attributes " \
                   "#{object_plist} for the '#{isa}' isa.\n" \
@@ -204,6 +222,15 @@ module Xcodeproj
           end
         end
 
+        def object_with_uuid(uuid, objects_by_uuid_plist)
+          project.objects_by_uuid[uuid] || project.new_from_plist(uuid, objects_by_uuid_plist)
+        rescue NameError => exception
+          attributes = objects_by_uuid_plist[uuid]
+          raise "`#{isa}` attempted to initialize an object with unknown ISA "\
+                "`#{attributes['isa']}` from attributes: `#{attributes}`\n"   \
+                "Please file and issue: https://github.com/CocoaPods/Xcodeproj/issues/new"
+        end
+
         # @note the key for simple and to_one attributes usually appears only
         #       if there is a value. To many keys always appear with an empty
         #       array.
@@ -227,6 +254,11 @@ module Xcodeproj
             plist[attrb.plist_name] = list.uuids
           end
 
+          references_by_keys_attributes.each do |attrb|
+            list = attrb.get_value(self)
+            plist[attrb.plist_name] = list.map { |dictionary| dictionary.to_plist }
+          end
+
           plist
         end
         alias :to_hash :to_plist
@@ -262,6 +294,11 @@ module Xcodeproj
             hash[attrb.plist_name] = list.map { |obj| obj.to_tree_hash }
           end
 
+          references_by_keys_attributes.each do |attrb|
+            list = attrb.get_value(self)
+            hash[attrb.plist_name] = list.map { |dictionary| dictionary.to_tree_hash }
+          end
+
           hash
         end
 
@@ -285,8 +322,9 @@ module Xcodeproj
   end
 end
 
-require 'xcodeproj/project/object_attributes'
 require 'xcodeproj/project/object_list'
+require 'xcodeproj/project/object_dictionary'
+require 'xcodeproj/project/object_attributes'
 
 # Required because some classes have cyclical references to each other.
 #
@@ -317,4 +355,5 @@ require 'xcodeproj/project/object/group'
 require 'xcodeproj/project/object/native_target'
 require 'xcodeproj/project/object/root_object'
 require 'xcodeproj/project/object/target_dependency'
+require 'xcodeproj/project/object/reference_proxy'
 

data/lib/xcodeproj/project/object/build_phase.rb

@@ -121,6 +121,12 @@ module Xcodeproj
 
       end
 
+      # Apparently a build phase named `Build Carbon Resources` (Observed for
+      # kernel extensions targets).
+      #
+      class PBXRezBuildPhase < AbstractBuildPhase
+      end
+
       class AbstractBuildPhase < AbstractObject
 
         ## CONVENIENCE METHODS #################################################
@@ -148,13 +154,42 @@ module Xcodeproj
           files << build_file
           build_file
         end
-        
+
+        # Removes the build file associated with the given file reference from
+        # the phase.
+        #
+        # @param [PBXFileReference] file the file to remove
+        #
+        # @return [void]
+        #
         def remove_file_reference(file)
           build_file = files.find { |bf| bf.file_ref == file }
-          files.delete(build_file)
           build_file.file_ref = nil
           build_file.remove_from_project
         end
+
+        # Removes a build file from the phase and clears its relationship to
+        # the file reference.
+        #
+        # @param [PBXBuildFile] file the file to remove
+        #
+        # @return [void]
+        #
+        def remove_build_file(build_file)
+          build_file.file_ref = nil
+          build_file.remove_from_project
+        end
+
+        # Removes all the build files from the phase and clears their
+        # relationship to the file reference.
+        #
+        # @return [void]
+        #
+        def clear_build_files
+          files.objects.each do |bf|
+            remove_build_file(bf)
+          end
+        end
       end
     end
   end

data/lib/xcodeproj/project/object/container_item_proxy.rb

@@ -8,21 +8,32 @@ module Xcodeproj
       # This class is referenced by {PBXTargetDependency}; for information
       # about it usage see the specs of that class.
       #
-      # @note This class references the other objects by uuid instead of
+      # @note This class references the other objects by UUID instead of
       #       creating proper relationships because the other objects might be
       #       part of another project. This implies that the references to
-      #       other objects should not increase the retain coutn of the
+      #       other objects should not increase the retain count of the
       #       targets.
       #
-      # @todo: this class needs some work to support targets accross workspaces,
+      # @todo: this class needs some work to support targets across workspaces,
       #        as the container portal might not be initialized leading
-      #        xcodproj to raise because ti can't find the UUID.
+      #        xcodeproj to raise because ti can't find the UUID.
       #
       class PBXContainerItemProxy < AbstractObject
 
         # @return [String] apparently the UUID of the root object
         #   {PBXProject} of the project containing the represented object.
         #
+        # @todo this is an attribute because a it is usually a reference to the
+        #       root object or to a file reference to another project. The
+        #       reference to the root object causes a retain cycle that could
+        #       cause issues (e.g. in to_tree_hash). Usually those objects are
+        #       retained by at least another object (the {Project} for the root
+        #       object and a {PBXGroup} for the reference to another project)
+        #       and so the referenced object should be serialized.
+        #
+        #       If this assumption is incorrect, there could be loss of
+        #       information opening and saving an existing project.
+        #
         attribute :container_portal, String
 
         # @return [String] the type of the proxy.
@@ -34,7 +45,15 @@ module Xcodeproj
         # @return [String] apparently the UUID of the represented
         #   object.
         #
-        # @note If the object is in another project this will return nil.
+        # @note If the object is in another project the UUID would not be
+        #       present in the {Project#objects_by_uuid} hash. For this reason
+        #       this is not an `has_one` attribute. It is assumes that if the
+        #       object belongs to the project at least another object should be
+        #       retaining it. This assumption is reasonable because this is a
+        #       proxy class.
+        #
+        #       If this assumption is incorrect, there could be loss of
+        #       information opening and saving an existing project.
         #
         attribute :remote_global_id_string, String
 

data/lib/xcodeproj/project/object/group.rb

@@ -10,7 +10,7 @@ module Xcodeproj
         # @return [ObjectList<PBXGroup, PBXFileReference>]
         #   the objects contained by the group.
         #
-        has_many :children, [PBXGroup, PBXFileReference]
+        has_many :children, [PBXGroup, PBXFileReference, PBXReferenceProxy]
 
         # @return [String] the source tree to which this group is relative.
         #
@@ -57,7 +57,7 @@ module Xcodeproj
 
       end
 
-      # The purpose of this subclass is not understood.
+      # This class is used to gather localized files into one entry.
       #
       class PBXVariantGroup < PBXGroup
 
@@ -209,6 +209,16 @@ module Xcodeproj
           find_subpath(path)
         end
 
+        # Removes children files and groups under this group.
+        #
+        def remove_children_recursively
+          groups.each do |g|
+            g.remove_children_recursively
+            g.remove_from_project
+          end
+          files.each { |f| f.remove_from_project }
+        end
+
         # Traverses the children groups and finds the children with the given
         # path, optionally, creating any needed group. If the given path is
         # `nil` it returns itself.

data/lib/xcodeproj/project/object/native_target.rb

@@ -2,20 +2,48 @@ module Xcodeproj
   class Project
     module Object
 
-      # Represents a target.
-      #
-      class PBXNativeTarget < AbstractObject
+      class AbstractTarget < AbstractObject
 
         # @return [String] The name of the Target.
         #
         attribute :name, String
 
+        # @return [String] the name of the build product.
+        #
+        attribute :product_name, String
+
         # @return [XCConfigurationList] the list of the build configurations of
         #   the target. This list commonly include two configurations `Debug`
         #   and `Release`.
         #
         has_one :build_configuration_list, XCConfigurationList
 
+        # @return [PBXNativeTarget] the targets necessary to build this target.
+        #
+        has_many :dependencies, PBXTargetDependency
+
+      end
+
+      # Represents a target handled by Xcode.
+      #
+      class PBXNativeTarget < AbstractTarget
+
+        # @return [PBXBuildRule] the build rules of this target.
+        #
+        has_many :build_rules, PBXBuildRule
+
+        # @return [String] the build product type identifier.
+        #
+        attribute :product_type, String, 'com.apple.product-type.library.static'
+
+        # @return [PBXFileReference] the reference to the product file.
+        #
+        has_one :product_reference, PBXFileReference
+
+        # @return [String] the install path of the product.
+        #
+        attribute :product_install_path, String
+
         # @return [PBXBuildRule] the build phases of the target.
         #
         # @note Apparently only PBXCopyFilesBuildPhase and
@@ -23,31 +51,58 @@ module Xcodeproj
         #
         has_many :build_phases, AbstractBuildPhase
 
-        # @return [PBXBuildRule] the build rules of this target.
+      end
+
+      # Represents a target that only consists in a aggregate of targets.
+      #
+      # @todo apparently it can't have build rules.
+      #
+      class PBXAggregateTarget < AbstractTarget
+
+        # @return [PBXBuildRule] the build phases of the target.
         #
-        has_many :build_rules, PBXBuildRule
+        # @note Apparently only PBXCopyFilesBuildPhase and
+        #   PBXShellScriptBuildPhase can appear multiple times in a target.
+        #
+        has_many :build_phases, [ PBXCopyFilesBuildPhase, PBXShellScriptBuildPhase ]
 
-        # @return [PBXNativeTarget] the targets necessary to build this target.
+      end
+
+      # Represents a legacy target which uses an external build tool.
+      #
+      # Apparently it can't have any build phase but the attribute can be
+      # present.
+      #
+      class PBXLegacyTarget < AbstractTarget
+
+        # @return [String] e.g "Dir"
         #
-        has_many :dependencies, PBXTargetDependency
+        attribute :build_working_directory, String
 
-        # @return [String] the name of the build product.
+        # @return [String] e.g "$(ACTION)"
         #
-        attribute :product_name, String
+        attribute :build_arguments_string, String
 
-        # @return [String] the build product type identifier.
+        # @return [String] e.g "1"
         #
-        attribute :product_type, String, 'com.apple.product-type.library.static'
+        attribute :pass_build_settings_in_environment, String
 
-        # @return [PBXFileReference] the reference to the product file.
+        # @return [String] e.g "/usr/bin/make"
         #
-        has_one :product_reference, PBXFileReference
+        attribute :build_tool_path, String
 
-        # @return [String] the install path of the product.
+        # @return [PBXBuildRule] the build phases of the target.
         #
-        attribute :product_install_path, String
+        # @note Apparently only PBXCopyFilesBuildPhase and
+        #   PBXShellScriptBuildPhase can appear multiple times in a target.
+        #
+        has_many :build_phases, AbstractBuildPhase
+
+      end
+
+      #----------------------------------------------------------------------#
 
-        ## CONVENIENCE METHODS #################################################
+      class AbstractTarget < AbstractObject
 
         # @!group Convenience methods
 
@@ -68,6 +123,54 @@ module Xcodeproj
           build_configuration_list.build_settings(build_configuration_name)
         end
 
+
+        # @return [Array<PBXCopyFilesBuildPhase>]
+        #   the copy files build phases of the target.
+        #
+        def copy_files_build_phases
+          build_phases.select { |bp| bp.class == PBXCopyFilesBuildPhase }
+        end
+
+        # @return [Array<PBXShellScriptBuildPhase>]
+        #   the copy files build phases of the target.
+        #
+        def shell_script_build_phases
+          build_phases.select { |bp| bp.class == PBXShellScriptBuildPhase }
+        end
+
+        # Creates a new copy files build phase.
+        #
+        # @param [String] name
+        #   an optional name for the phase.
+        #
+        # @return [PBXCopyFilesBuildPhase] the new phase.
+        #
+        def new_copy_files_build_phase(name = nil)
+          phase = project.new(PBXCopyFilesBuildPhase)
+          phase.name = name
+          build_phases << phase
+          phase
+        end
+
+        # Creates a new shell script build phase.
+        #
+        # @param (see #new_copy_files_build_phase)
+        #
+        # @return [PBXShellScriptBuildPhase] the new phase.
+        #
+        def new_shell_script_build_phase(name = nil)
+          phase = project.new(PBXShellScriptBuildPhase)
+          phase.name = name
+          build_phases << phase
+          phase
+        end
+
+      end
+
+      class PBXNativeTarget < AbstractTarget
+
+        # @!group Convenience methods
+
         # Adds source files to the target.
         #
         # @param [Array<PBXFileReference>] file_references
@@ -88,8 +191,7 @@ module Xcodeproj
             header_extensions = Constants::HEADER_FILES_EXTENSIONS
             if (header_extensions.include?(extension))
               build_file.settings = { 'ATTRIBUTES' => ["Public"] }
-              phase = headers_build_phase
-              phase.files << build_file
+              headers_build_phase.files << build_file
             else
               build_file.settings = { 'COMPILER_FLAGS' => compiler_flags } if compiler_flags && !compiler_flags.empty?
               source_build_phase.files << build_file
@@ -97,9 +199,6 @@ module Xcodeproj
           end
         end
 
-
-        # @!group Accessing build phases
-
         # Finds or creates the headers build phase of the target.
         #
         # @note A target should have only one headers build phase.
@@ -169,50 +268,6 @@ module Xcodeproj
           end
           bp
         end
-
-        # @return [Array<PBXCopyFilesBuildPhase>]
-        #   the copy files build phases of the target.
-        #
-        def copy_files_build_phases
-          build_phases.select { |bp| bp.class == PBXCopyFilesBuildPhase }
-        end
-
-        # @return [Array<PBXShellScriptBuildPhase>]
-        #   the copy files build phases of the target.
-        #
-        def shell_script_build_phases
-          build_phases.select { |bp| bp.class == PBXShellScriptBuildPhase }
-        end
-
-
-        # @!group Creating build phases
-
-        # Creates a new copy files build phase.
-        #
-        # @param [String] name
-        #   an optional name for the pahse.
-        #
-        # @return [PBXCopyFilesBuildPhase] the new phase.
-        #
-        def new_copy_files_build_phase(name = nil)
-          phase = project.new(PBXCopyFilesBuildPhase)
-          phase.name = name
-          build_phases << phase
-          phase
-        end
-
-        # Creates a new shell script build phase.
-        #
-        # @param (see #new_copy_files_build_phase)
-        #
-        # @return [PBXShellScriptBuildPhase] the new phase.
-        #
-        def new_shell_script_build_phase(name = nil)
-          phase = project.new(PBXShellScriptBuildPhase)
-          phase.name = name
-          build_phases << phase
-          phase
-        end
       end
     end
   end

data/lib/xcodeproj/project/object/reference_proxy.rb

@@ -0,0 +1,35 @@
+module Xcodeproj
+  class Project
+    module Object
+
+      # Apparently a proxy for a reference object which might belong another
+      # project contained in the same workspace of the project document.
+      #
+      # This class is used for referencing the products of another project.
+      #
+      class PBXReferenceProxy < AbstractObject
+
+        # @return [String] the path of the referenced filed.
+        #
+        attribute :path, String
+
+        # @return [String] the file type of the referenced filed.
+        #
+        attribute :file_type, String
+
+        # @return [PBXContainerItemProxy] the proxy to the project that
+        #   contains the object.
+        #
+        has_one :remote_ref, PBXContainerItemProxy
+
+        # @return [String] the source tree for the path of the reference.
+        #
+        # E.g. "BUILT_PRODUCTS_DIR"
+        #
+        attribute :source_tree, String
+
+      end
+    end
+  end
+end
+

data/lib/xcodeproj/project/object/root_object.rb

@@ -9,7 +9,7 @@ module Xcodeproj
         # @return [ObjectList<PBXNativeTarget>] a list of all the targets in
         #   the project.
         #
-        has_many :targets, PBXNativeTarget
+        has_many :targets, AbstractTarget
 
         # @return [Hash{String => String}] attributes the attributes of the
         #   target.
@@ -60,6 +60,13 @@ module Xcodeproj
         #
         attribute :project_root, String
 
+        # @return [Array<ObjectDictionary>] any reference to other projects.
+        #
+        has_many_references_by_keys :project_references, {
+          :project_ref   => PBXFileReference,
+          :product_group => PBXGroup
+        }
+
       end
     end
   end

data/lib/xcodeproj/project/object_attributes.rb

@@ -205,6 +205,10 @@ module Xcodeproj
             @to_many_attributes ||= attributes.select { |a| a.type == :to_many }
           end
 
+          def references_by_keys_attributes
+            @references_by_keys_attributes ||= attributes.select { |a| a.type == :references_by_keys }
+          end
+
           private
 
           # Defines a new simple attribute and synthesises the corresponding
@@ -330,6 +334,41 @@ module Xcodeproj
             end
           end
 
+          # Defines a new ordered relationship to many.
+          #
+          # @note This attribute only generates the reader method. Clients are
+          #       not supposed to create {ObjectList} objects which are created
+          #       by the methods synthesised by this attribute on demand.
+          #       Clients, however can mutate the list according to its
+          #       interface. The list is responsible to manage the reference
+          #       counting for its values.
+          #
+          # @param [String] plural_name
+          #   the name of the relationship.
+          #
+          # @param [Class, Array<Class>] isas
+          #   the list of the classes corresponding to the accepted isas for
+          #   this relationship.
+          #
+          # @macro [attach] has_many
+          #   @!attribute [r] $1
+          #
+          def has_many_references_by_keys(plural_name, isas_hash)
+            attrb = AbstractObjectAttribute.new(:references_by_keys, plural_name, self)
+            attrb.classes = isas_hash.values
+            add_attribute(attrb)
+
+            define_method(attrb.name) do
+              # Here we are in the context of the instance
+              list = instance_variable_get("@#{attrb.name}")
+              unless list
+                list = ObjectList.new(attrb, self)
+                instance_variable_set("@#{attrb.name}", list)
+              end
+              list
+            end
+          end
+
           protected
 
           # Adds an attribute to the list of attributes of the class.
@@ -376,6 +415,12 @@ module Xcodeproj
         def to_many_attributes
           self.class.to_many_attributes
         end
+
+        # @return (see AbstractObject.to_many_attributes)
+        #
+        def references_by_keys_attributes
+          self.class.references_by_keys_attributes
+        end
       end # AbstractObject
     end
   end

data/lib/xcodeproj/project/object_dictionary.rb

@@ -0,0 +1,191 @@
+module Xcodeproj
+  class Project
+
+    # This class represents relationships to other objects stored in a
+    # Dictionary.
+    #
+    # It works in conjunction with the {AbstractObject} class to ensure that
+    # the project is not serialized with unreachable objects by updating the
+    # with reference count on modifications.
+    #
+    # @note This class is a stub currently only being used by
+    #       {PBXProject#project_references}. It doesn't perform type cheeking
+    #       and the keys of the dictionary are in camel-case. To provide full
+    #       support as the other classes the dictionary should be able to
+    #
+    #       Give the following attribute:
+    #
+    #            has_many_references_by_keys :project_references, {
+    #              :project_ref   => PBXFileReference,
+    #              :product_group => PBXGroup
+    #            }
+    #
+    #       This should be possible:
+    #
+    #            #=> Note the API:
+    #            root_object.project_references.project_ref = file
+    #
+    #            #=> This should raise:
+    #            root_object.project_references.product_group = file
+    #
+    #       generate setters and getters from the specification hash.
+    #
+    #       Also the interface is a dirty hybrid between the
+    #       {AbstractObjectAttribute} and the {ObjectList}.
+    #
+    # @note Concerning the mutations methods it is safe to call only those
+    #       which are overridden to inform objects reference count. Ideally all
+    #       the hash methods should be covered, but this is not done yet.
+    #       Moreover it is a moving target because the methods of array
+    #       usually are implemented in C
+    #
+    # @todo Cover all the mutations methods of the {Hash} class.
+    #
+    class ObjectDictionary < Hash
+
+      # {Xcodeproj} clients are not expected to create instances of
+      # {ObjectDictionary}, it is always initialized empty and automatically by
+      # the synthesized methods generated by {AbstractObject.has_many}.
+      #
+      def initialize(attribute, owner)
+        @attribute = attribute
+        @owner = owner
+      end
+
+      # @return [Array<Class>] The attribute that generated the list.
+      #
+      attr_reader :attribute
+
+      # @return [Array<Class>] The object that owns the list.
+      #
+      attr_reader :owner
+
+      #------------------------------------------------------------------------#
+
+      # @!group Notification enabled methods
+
+      # TODO: the overridden methods are incomplete.
+
+      # Associates an object to the given key and updates its references count.
+      #
+      # @param [String] key
+      #   the key
+      #
+      # @param [AbstractObject] object
+      #   the object to add to the dictionary.
+      #
+      # @return [void]
+      #
+      def []=(key, object)
+        if object
+          perform_additions_operations(object)
+        else
+          perform_deletion_operations(self[key])
+        end
+        super
+      end
+
+      # Removes the given key from the dictionary and informs the object that
+      # is not longer referenced by the owner.
+      #
+      # @param [String] key
+      #   the key
+      #
+      # @return [void]
+      #
+      def delete(key)
+        object = self[key]
+        perform_deletion_operations(object)
+        super
+      end
+
+      #------------------------------------------------------------------------#
+
+      # @!group Integration with {AbstractObject}
+
+      # The plist reppresentation of the dictionary where the objects are
+      # replaced by their UUIDs.
+      #
+      # @return [Hash<String => String>]
+      #
+      def to_plist
+        result = {}
+        each { |key, obj| result[key] = obj.uuid }
+        result
+      end
+
+      # Returns a cascade reppresentation of the object without UUIDs.
+      #
+      # @return [Hash<String => String>]
+      #
+      def to_tree_hash
+        result = {}
+        each { |key, obj| result[key] = obj.to_tree_hash }
+        result
+      end
+
+      # Removes all the references to a given object.
+      #
+      # @return [void]
+      #
+      def remove_reference(object)
+        each { |key, obj| self[key] = nil if obj == object }
+      end
+
+      #------------------------------------------------------------------------#
+
+      # @!group Integration with {ObjectList}
+
+      # Informs the objects contained in the dictionary that another object is
+      # referencing them.
+      #
+      # @return [void]
+      #
+      def add_referrer(referrer)
+        values.each { |obj| obj.add_referrer(referrer) }
+      end
+
+      # Informs the objects contained in the dictionary that another object
+      # stopped referencing them.
+      #
+      # @return [void]
+      #
+      def remove_referrer(referrer)
+        values.each { |obj| obj.remove_referrer(referrer) }
+      end
+
+      #------------------------------------------------------------------------#
+
+      # @!group Notification Methods
+
+      private
+
+      # Informs an object that it was added to the dictionary. In practice it
+      # adds the owner of the list as referrer to the objects. It also
+      # validates the value.
+      #
+      # @return [void]
+      #
+      def perform_additions_operations(objects)
+        objects = [objects] unless objects.is_a?(Array)
+        objects.each do |obj|
+          obj.add_referrer(owner)
+          attribute.validate_value(obj)
+        end
+      end
+
+      # Informs an object that it was removed from to the dictionary, so it can
+      # remove it from its referrers and take the appropriate actions.
+      #
+      # @return [void]
+      #
+      def perform_deletion_operations(objects)
+        objects = [objects] unless objects.is_a?(Array)
+        objects.each do |obj|
+          obj.remove_referrer(owner)
+        end
+      end
+    end
+  end
+end
+

data/lib/xcodeproj/project/object_list.rb

@@ -10,10 +10,10 @@ module Xcodeproj
     # @note Concerning the mutations methods it is safe to call only those
     #       which are overridden to inform objects reference count. Ideally all
     #       the array methods should be covered, but this is not done yet.
-    #       Moreover it is a moving target because the methods of array 
+    #       Moreover it is a moving target because the methods of array
     #       usually are implemented in C
     #
-    # @todo Cover all the array methods.
+    # @todo Cover all the mutations methods of the {Array} class.
     #
     class ObjectList < Array
 
@@ -26,40 +26,90 @@ module Xcodeproj
         @owner = owner
       end
 
-      # @return [Array<Class>] The attribute that generated the list.
+      # @return [Array<Class>] the attribute that generated the list.
       #
       attr_reader :attribute
 
-      # @return [Array<Class>] The object that owns the list.
+      # @return [Array<Class>] the object that owns the list.
       #
       attr_reader :owner
 
-      # @return [Array<String>] The UUIDs of all the objects referenced by this
-      #   list.
+      #------------------------------------------------------------------------#
+
+      # @!group Integration with {ObjectList}
+
+      # @return [Array<String>]
+      #   the UUIDs of all the objects referenced by this list.
       #
       def uuids
         map { |obj| obj.uuid }
       end
 
+      # @return [Array<AbstractObject>]
+      #   a new array generated with the objects contained in the list.
+      #
+      def objects
+        to_a
+      end
+
+      #------------------------------------------------------------------------#
+
       # @!group Notification enabled methods
 
       # TODO: the overridden methods are incomplete.
 
+      # Adds an array of objects to list and updates their references count.
+      #
+      # @param [Array<AbstractObject, ObjectDictionary>] object
+      #   an array of objects to add to the list.
+      #
+      # @return [void]
+      #
       def +(objects)
         super
         perform_additions_operations(objects)
       end
 
+      # Adds an object to list and updates its references count.
+      #
+      # @param [AbstractObject, ObjectDictionary] object
+      #   the object to add to the list.
+      #
+      # @return [void]
+      #
       def <<(object)
         super
         perform_additions_operations(object)
       end
 
+      # Removes an object to list and updates its references count.
+      #
+      # @param [AbstractObject, ObjectDictionary] object
+      #   the object to delete from the list.
+      #
+      # @return [void]
+      #
       def delete(object)
         super
         perform_deletion_operations(object)
       end
 
+      # Removes all the objects contained in the list and updates their
+      # reference counts.
+      #
+      # @return [void]
+      #
+      def clear
+        objects.each do |object|
+          perform_deletion_operations(object)
+        end
+        super
+      end
+
+      #------------------------------------------------------------------------#
+
+      # @!group Notification Methods
+
       private
 
       # Informs an object that it was added to the list. In practice it adds
@@ -72,19 +122,19 @@ module Xcodeproj
         objects = [objects] unless objects.is_a?(Array)
         objects.each do |obj|
           obj.add_referrer(owner)
-          attribute.validate_value(obj)
+          attribute.validate_value(obj) unless obj.is_a?(ObjectDictionary)
         end
       end
 
       # Informs an object that it was removed from to the list, so it can
-      # remove it from its referrers and take the appropriate actions.
+      # remove its owner from its referrers and take the appropriate actions.
       #
       # @return [void]
       #
       def perform_deletion_operations(objects)
         objects = [objects] unless objects.is_a?(Array)
         objects.each do |obj|
-          obj.remove_referrer(owner)
+          obj.remove_referrer(owner) unless obj.is_a?(ObjectDictionary)
         end
       end
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: xcodeproj
 version: !ruby/object:Gem::Version
-  version: 0.4.0.rc2
+  version: 0.4.0.rc3
   prerelease: 6
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-22 00:00:00.000000000 Z
+date: 2012-10-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -60,6 +60,7 @@ files:
 - lib/xcodeproj/config.rb
 - lib/xcodeproj/constants.rb
 - lib/xcodeproj/helper.rb
+- lib/xcodeproj/project/object/aggregate_target.rb
 - lib/xcodeproj/project/object/build_configuration.rb
 - lib/xcodeproj/project/object/build_file.rb
 - lib/xcodeproj/project/object/build_phase.rb
@@ -69,10 +70,12 @@ files:
 - lib/xcodeproj/project/object/file_reference.rb
 - lib/xcodeproj/project/object/group.rb
 - lib/xcodeproj/project/object/native_target.rb
+- lib/xcodeproj/project/object/reference_proxy.rb
 - lib/xcodeproj/project/object/root_object.rb
 - lib/xcodeproj/project/object/target_dependency.rb
 - lib/xcodeproj/project/object.rb
 - lib/xcodeproj/project/object_attributes.rb
+- lib/xcodeproj/project/object_dictionary.rb
 - lib/xcodeproj/project/object_list.rb
 - lib/xcodeproj/project/recursive_diff.rb
 - lib/xcodeproj/project.rb
@@ -99,7 +102,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 2919884453979069373
+      hash: 1005029667767319661
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: