aperture 0.3.0

data/lib/aperture/photo.rb

@@ -0,0 +1,27 @@
+
+module Aperture
+  # = Overview
+  # The Photo object is built from two files (.apmaster and .apfile) for each file imported 
+  # into an Aperture Library. Photo objects have attributes for the path it was found at. It's
+  # associated Version objects. As well as any Album objects it belongs to and the Project it's 
+  # inside. Also it has twxo sets of attribute hashs one from the .apmaster file and the other
+  # from the .apfile file.
+  class Photo
+    attr_accessor :path, :versions, :albums, :project, :file_attributes, :master_attributes
+    
+    # creates a new Photo object give a +path+ which is where the directory for the photo and 
+    # it's metadata are found on disk.
+    def initialize(path)
+      @path = path
+      raise ArgumentError, "Requires valid directory path" unless File.directory?(@path)
+      @versions = []
+      @albums = []
+    end
+    
+    # Takes a interger and returns back the Version object that matches the number
+    def version(n)
+      return @versions.select {|v| v.filename == "Version-#{n}.apversion"}.first
+    end
+    
+  end
+end

data/lib/aperture/photo_set.rb

@@ -0,0 +1,88 @@
+
+module Aperture
+
+  # = Overview
+  # The PhotoSet object that contains a series of Photo objects in a hash. This object is used
+  # by the Library, Album and Project objects cotain photos. This object also contains methods
+  # to look up interest statistics across the set.
+  #
+  # = Statistic gathering methods
+  # * photo_count - number of photos in set
+  # * version_count - number of versions across all photos in set
+  # * camera_model_count_hash - count of how many times each camera used in the set
+  # * lens_model_count_hash - count of how many times each lens used in the set
+  #
+  # *Note* This object can be directly treated like an array using each or any method from 
+  # the Enumerable module. These will access the the values, the Photo objects, contained 
+  # within the hash.
+  class PhotoSet
+    include Enumerable
+    attr_accessor :photos
+    
+    # Creates a new PhotoSet, can be passed an array of Photo objects
+    def initialize(photos = {})
+      @photos = photos
+    end
+    
+    # Adds a Photo to the hash PhotoSet uses to track Photo's using the photo's UUID. This UUID
+    # matches up to the masterUuid found in Version#attributes
+    def <<(photo)
+      @photos[ photo.master_attributes['uuid'] ] = photo
+    end
+    
+    # Iterates over the hash's values, ie the photos, the PhotoSet is tracking 
+    def each &blk
+      @photos.values.each &blk
+    end
+    
+    # This method passes any unknown method calls onto the hash of photos, allowing you to 
+    # treat the PhotoSet object as the Hash of photos it holds.
+    def method_missing(sym, *args, &block)
+      @photos.send(sym, *args, &block) if @photos.respond_to?(sym)
+    end
+    
+
+    # Returns the number of photos tracked by the PhotoSet 
+    def photo_count
+      return size
+    end
+    
+    # Returns the number of versions across all the photos tracked by the PhotoSet
+    def version_count
+      return inject(0) {|sum, photo| sum += photo.versions.size}      
+    end
+    
+    # Returns a hash in the following format
+    # * The keys are the camera model for the photo parsed from the EXIF information
+    # * The value is the number of times that camera model shows up across all the photos in 
+    #   the set
+    def camera_model_count_hash
+      hash = Hash.new(0)
+      self.each do |photo|
+        model = photo.version(1).attributes['exifProperties']['Model']
+        hash[model] += 1
+      end
+
+      return hash
+    end
+    
+    # Returns a hash in the following format
+    # * The keys are the lens model for the photo parsed from the EXIF information
+    # * The value is the number of times that lens model shows up across all the photos in 
+    #   the set    
+    def lens_model_count_hash
+      hash = Hash.new(0)
+      self.each do |photo|
+        model = photo.version(1).attributes['exifProperties']['LensModel']
+        hash[model] += 1
+      end
+
+      return hash
+    end
+    
+    # def find_photos_by_keyword
+    
+    # def find_photos_by_rating
+      
+  end
+end

data/lib/aperture/project.rb

@@ -0,0 +1,16 @@
+
+module Aperture
+  # = Overview
+  # The Project object matches up with Projects entries from an Aperture Library. Projects cotain
+  # Aperture::Photo objects through an Aperture::PhotoSet.
+  class Project
+    attr_accessor :photos, :attributes
+    
+    # Creates a new Project object given a hash of attributes, this should be the hash returned
+    # from parsing the .approject/Info.apfolder file by the plist gem.
+    def initialize(attributes = {})
+      @attributes = attributes
+      @photos = PhotoSet.new
+    end
+  end
+end

data/lib/aperture/version.rb

@@ -0,0 +1,20 @@
+
+module Aperture
+  # = Overview
+  # The Version object matches up with Version entries from an Aperture Library. Version 
+  # objects are linked an Aperture::Photo
+  class Version
+    attr_accessor :photo, :attributes, :filename
+    
+    # Creates a new Version object given the following required arugments:
+    # * the filename for the .apversion file as found on the disk
+    # * a hash of attributes, this should be the hash returned from parsing the .apversion 
+    #   file by the plist gem.
+    # * the Photo object that the version is associated with
+    def initialize(filename, attributes, photo)
+      @attributes = attributes
+      @filename   = filename
+      @photo      = photo
+    end
+  end
+end

data/test/data/ Built-in Smart Albums/.implicitAlbum

@@ -0,0 +1,123 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>FilterInfo</key>
+	<dict>
+		<key>queryClassName</key>
+		<string>RKMultiItemQuery</string>
+		<key>queryIsEnabled</key>
+		<true/>
+		<key>queryMatchType</key>
+		<integer>1</integer>
+		<key>queryPredicateComponents</key>
+		<integer>1</integer>
+		<key>queryStackPicksOnly</key>
+		<false/>
+		<key>querySubqueries</key>
+		<array>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKSingleItemQuery</string>
+				<key>queryIsEnabled</key>
+				<false/>
+				<key>queryPropertyKey</key>
+				<string>properties.any</string>
+				<key>queryQualifier</key>
+				<integer>23</integer>
+				<key>queryTimeValue</key>
+				<integer>1</integer>
+				<key>queryType</key>
+				<integer>14</integer>
+			</dict>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKSingleItemQuery</string>
+				<key>queryFirstValue</key>
+				<integer>0</integer>
+				<key>queryIsEnabled</key>
+				<true/>
+				<key>queryPropertyKey</key>
+				<string>basicProperties.MainRating</string>
+				<key>queryQualifier</key>
+				<integer>8</integer>
+				<key>queryTimeValue</key>
+				<integer>1</integer>
+				<key>queryType</key>
+				<integer>5</integer>
+			</dict>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKMultiItemQuery</string>
+				<key>queryIsEnabled</key>
+				<false/>
+				<key>queryMatchType</key>
+				<integer>0</integer>
+				<key>queryStackPicksOnly</key>
+				<false/>
+				<key>querySubqueries</key>
+				<array/>
+				<key>queryType</key>
+				<integer>2</integer>
+			</dict>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKMultiItemQuery</string>
+				<key>queryIsEnabled</key>
+				<false/>
+				<key>queryMatchType</key>
+				<integer>0</integer>
+				<key>queryStackPicksOnly</key>
+				<false/>
+				<key>querySubqueries</key>
+				<array/>
+				<key>queryType</key>
+				<integer>4</integer>
+			</dict>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKMultiItemQuery</string>
+				<key>queryIsEnabled</key>
+				<false/>
+				<key>queryMatchType</key>
+				<integer>0</integer>
+				<key>queryStackPicksOnly</key>
+				<false/>
+				<key>querySubqueries</key>
+				<array/>
+				<key>queryType</key>
+				<integer>3</integer>
+			</dict>
+		</array>
+		<key>queryType</key>
+		<integer>1</integer>
+	</dict>
+	<key>InfoDictionary</key>
+	<dict>
+		<key>albumSubclass</key>
+		<integer>1</integer>
+		<key>albumType</key>
+		<integer>1</integer>
+		<key>createDate</key>
+		<date>2009-12-11T00:08:24Z</date>
+		<key>dateLastSavedInDatabase</key>
+		<date>2009-12-11T00:08:24Z</date>
+		<key>folderUuid</key>
+		<string>05ejET0+QEyCLf0w96BQqA</string>
+		<key>metadataChangeDate</key>
+		<date>2009-12-11T00:08:24Z</date>
+		<key>name</key>
+		<string>.implicitAlbum</string>
+		<key>queryFolderUuid</key>
+		<string>05ejET0+QEyCLf0w96BQqA</string>
+		<key>sortAscending</key>
+		<true/>
+		<key>sortKeyPath</key>
+		<string>exifProperties.ImageDate</string>
+		<key>uuid</key>
+		<string>nceApmRuSti/y2P9fW3zPw</string>
+		<key>version</key>
+		<integer>74</integer>
+	</dict>
+</dict>
+</plist>

data/test/data/ Built-in Smart Albums/090-entireLibraryQuery.apsmartalbum

@@ -0,0 +1,159 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>FilterInfo</key>
+	<dict>
+		<key>queryClassName</key>
+		<string>RKMultiItemQuery</string>
+		<key>queryIsEnabled</key>
+		<true/>
+		<key>queryMatchType</key>
+		<integer>0</integer>
+		<key>queryPredicateComponents</key>
+		<integer>1</integer>
+		<key>queryStackPicksOnly</key>
+		<false/>
+		<key>querySubqueries</key>
+		<array>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKSingleItemQuery</string>
+				<key>queryFirstValue</key>
+				<string></string>
+				<key>queryIsEnabled</key>
+				<false/>
+				<key>queryPropertyKey</key>
+				<string>properties.any</string>
+				<key>queryQualifier</key>
+				<integer>23</integer>
+				<key>queryTimeValue</key>
+				<integer>1</integer>
+				<key>queryType</key>
+				<integer>14</integer>
+			</dict>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKSingleItemQuery</string>
+				<key>queryFirstValue</key>
+				<integer>0</integer>
+				<key>queryIsEnabled</key>
+				<true/>
+				<key>queryPropertyKey</key>
+				<string>basicProperties.MainRating</string>
+				<key>queryQualifier</key>
+				<integer>8</integer>
+				<key>queryTimeValue</key>
+				<integer>1</integer>
+				<key>queryType</key>
+				<integer>5</integer>
+			</dict>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKMultiItemQuery</string>
+				<key>queryIsEnabled</key>
+				<false/>
+				<key>queryMatchType</key>
+				<integer>0</integer>
+				<key>queryStackPicksOnly</key>
+				<false/>
+				<key>querySubqueries</key>
+				<array/>
+				<key>queryType</key>
+				<integer>2</integer>
+			</dict>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKMultiItemQuery</string>
+				<key>queryIsEnabled</key>
+				<false/>
+				<key>queryMatchType</key>
+				<integer>0</integer>
+				<key>queryStackPicksOnly</key>
+				<false/>
+				<key>querySubqueries</key>
+				<array/>
+				<key>queryType</key>
+				<integer>4</integer>
+			</dict>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKMultiItemQuery</string>
+				<key>queryIsEnabled</key>
+				<false/>
+				<key>queryMatchType</key>
+				<integer>0</integer>
+				<key>queryStackPicksOnly</key>
+				<false/>
+				<key>querySubqueries</key>
+				<array/>
+				<key>queryType</key>
+				<integer>3</integer>
+			</dict>
+		</array>
+		<key>queryType</key>
+		<integer>1</integer>
+	</dict>
+	<key>InfoDictionary</key>
+	<dict>
+		<key>albumSubclass</key>
+		<integer>2</integer>
+		<key>albumType</key>
+		<integer>1</integer>
+		<key>createDate</key>
+		<date>2009-12-11T00:08:24Z</date>
+		<key>dateLastSavedInDatabase</key>
+		<date>2009-12-11T00:08:24Z</date>
+		<key>folderUuid</key>
+		<string>05ejET0+QEyCLf0w96BQqA</string>
+		<key>metadataChangeDate</key>
+		<date>2009-12-11T00:08:24Z</date>
+		<key>name</key>
+		<string>090-entireLibraryQuery.apsmartalbum</string>
+		<key>queryFolderUuid</key>
+		<string>Kj1eGir7SyiZ1B/uQrgfcQ</string>
+		<key>sortAscending</key>
+		<true/>
+		<key>sortKeyPath</key>
+		<string>exifProperties.ImageDate</string>
+		<key>uuid</key>
+		<string>USH4MRvhSfCxGw+WHVXzIg</string>
+		<key>version</key>
+		<integer>74</integer>
+	</dict>
+	<key>UserQueryInfo</key>
+	<dict>
+		<key>queryClassName</key>
+		<string>RKMultiItemQuery</string>
+		<key>queryIsEnabled</key>
+		<true/>
+		<key>queryMatchType</key>
+		<integer>0</integer>
+		<key>queryPredicateComponents</key>
+		<integer>1</integer>
+		<key>queryStackPicksOnly</key>
+		<false/>
+		<key>querySubqueries</key>
+		<array>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKSingleItemQuery</string>
+				<key>queryFirstValue</key>
+				<real>-1</real>
+				<key>queryIsEnabled</key>
+				<true/>
+				<key>queryPropertyKey</key>
+				<string>basicProperties.MainRating</string>
+				<key>queryQualifier</key>
+				<integer>8</integer>
+				<key>queryTimeValue</key>
+				<integer>1</integer>
+				<key>queryType</key>
+				<integer>5</integer>
+			</dict>
+		</array>
+		<key>queryType</key>
+		<integer>1</integer>
+	</dict>
+</dict>
+</plist>

data/test/data/ Built-in Smart Albums/100-selectsQuery.apsmartalbum

@@ -0,0 +1,159 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>FilterInfo</key>
+	<dict>
+		<key>queryClassName</key>
+		<string>RKMultiItemQuery</string>
+		<key>queryIsEnabled</key>
+		<true/>
+		<key>queryMatchType</key>
+		<integer>0</integer>
+		<key>queryPredicateComponents</key>
+		<integer>1</integer>
+		<key>queryStackPicksOnly</key>
+		<false/>
+		<key>querySubqueries</key>
+		<array>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKSingleItemQuery</string>
+				<key>queryFirstValue</key>
+				<string></string>
+				<key>queryIsEnabled</key>
+				<false/>
+				<key>queryPropertyKey</key>
+				<string>properties.any</string>
+				<key>queryQualifier</key>
+				<integer>23</integer>
+				<key>queryTimeValue</key>
+				<integer>1</integer>
+				<key>queryType</key>
+				<integer>14</integer>
+			</dict>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKSingleItemQuery</string>
+				<key>queryFirstValue</key>
+				<integer>0</integer>
+				<key>queryIsEnabled</key>
+				<false/>
+				<key>queryPropertyKey</key>
+				<string>basicProperties.MainRating</string>
+				<key>queryQualifier</key>
+				<integer>8</integer>
+				<key>queryTimeValue</key>
+				<integer>1</integer>
+				<key>queryType</key>
+				<integer>5</integer>
+			</dict>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKMultiItemQuery</string>
+				<key>queryIsEnabled</key>
+				<false/>
+				<key>queryMatchType</key>
+				<integer>0</integer>
+				<key>queryStackPicksOnly</key>
+				<false/>
+				<key>querySubqueries</key>
+				<array/>
+				<key>queryType</key>
+				<integer>2</integer>
+			</dict>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKMultiItemQuery</string>
+				<key>queryIsEnabled</key>
+				<false/>
+				<key>queryMatchType</key>
+				<integer>0</integer>
+				<key>queryStackPicksOnly</key>
+				<false/>
+				<key>querySubqueries</key>
+				<array/>
+				<key>queryType</key>
+				<integer>4</integer>
+			</dict>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKMultiItemQuery</string>
+				<key>queryIsEnabled</key>
+				<false/>
+				<key>queryMatchType</key>
+				<integer>0</integer>
+				<key>queryStackPicksOnly</key>
+				<false/>
+				<key>querySubqueries</key>
+				<array/>
+				<key>queryType</key>
+				<integer>3</integer>
+			</dict>
+		</array>
+		<key>queryType</key>
+		<integer>1</integer>
+	</dict>
+	<key>InfoDictionary</key>
+	<dict>
+		<key>albumSubclass</key>
+		<integer>2</integer>
+		<key>albumType</key>
+		<integer>1</integer>
+		<key>createDate</key>
+		<date>2009-12-11T00:08:24Z</date>
+		<key>dateLastSavedInDatabase</key>
+		<date>2009-12-11T00:08:24Z</date>
+		<key>folderUuid</key>
+		<string>05ejET0+QEyCLf0w96BQqA</string>
+		<key>metadataChangeDate</key>
+		<date>2009-12-11T00:08:24Z</date>
+		<key>name</key>
+		<string>100-selectsQuery.apsmartalbum</string>
+		<key>queryFolderUuid</key>
+		<string>Kj1eGir7SyiZ1B/uQrgfcQ</string>
+		<key>sortAscending</key>
+		<true/>
+		<key>sortKeyPath</key>
+		<string>exifProperties.ImageDate</string>
+		<key>uuid</key>
+		<string>vjnMZlvcRHGR6i0eYm4QPA</string>
+		<key>version</key>
+		<integer>74</integer>
+	</dict>
+	<key>UserQueryInfo</key>
+	<dict>
+		<key>queryClassName</key>
+		<string>RKMultiItemQuery</string>
+		<key>queryIsEnabled</key>
+		<true/>
+		<key>queryMatchType</key>
+		<integer>0</integer>
+		<key>queryPredicateComponents</key>
+		<integer>1</integer>
+		<key>queryStackPicksOnly</key>
+		<false/>
+		<key>querySubqueries</key>
+		<array>
+			<dict>
+				<key>queryClassName</key>
+				<string>RKSingleItemQuery</string>
+				<key>queryFirstValue</key>
+				<real>5</real>
+				<key>queryIsEnabled</key>
+				<true/>
+				<key>queryPropertyKey</key>
+				<string>basicProperties.MainRating</string>
+				<key>queryQualifier</key>
+				<integer>8</integer>
+				<key>queryTimeValue</key>
+				<integer>1</integer>
+				<key>queryType</key>
+				<integer>5</integer>
+			</dict>
+		</array>
+		<key>queryType</key>
+		<integer>1</integer>
+	</dict>
+</dict>
+</plist>