flickrie 0.0.1

data/lib/flickrie/media.rb

@@ -0,0 +1,254 @@
+require 'flickrie/media/visibility'
+require 'flickrie/media/note'
+require 'flickrie/location'
+require 'date'
+
+module Flickrie
+  module Media
+    def id;             @info['id']           end
+    def secret;         @info['secret']       end
+    def server;         @info['server']       end
+    def farm;           @info['farm']         end
+    def title;          @info['title']        end
+    def description;    @info['description']  end
+    def tags;           @info['tags']         end
+    def machine_tags;   @info['machine_tags'] end
+    def media_status;   @info['media_status'] end
+    def path_alias;     @info['pathalias']    end
+
+    def views_count
+      @info['views'].to_i if @info['views']
+    end
+
+    def comments_count
+      @info['comments_count'].to_i if @info['comments_count']
+    end
+
+    def location
+      Location.new(@info['location']) if @info['location']
+    end
+
+    def geo_permissions
+      if @info['geoperms']
+        Visibility.new \
+          *[@info['geoperms']['ispublic'],
+            @info['geoperms']['isfriend'],
+            @info['geoperms']['isfamily'],
+            @info['geoperms']['iscontact']]
+      end
+    end
+
+    def license
+      License.new(@info['license']) if @info['license']
+    end
+
+    def posted_at;   Time.at(@info['dates']['posted'].to_i) if @info['dates']['posted']         end
+    def uploaded_at; Time.at(@info['dates']['uploaded'].to_i) if @info['dates']['uploaded']     end
+    def updated_at;  Time.at(@info['dates']['lastupdate'].to_i) if @info['dates']['lastupdate'] end
+    def taken_at;    DateTime.parse(@info['dates']['taken']).to_time if @info['dates']['taken'] end
+
+    def taken_at_granularity
+      @info['dates']['takengranularity'].to_i if @info['dates']['takengranularity']
+    end
+
+    def owner
+      User.new(@info['owner']) if @info['owner']
+    end
+
+    def safety_level; @info['safety_level'].to_i if @info['safety_level'] end
+
+    def safe?;       safety_level <= 1 if safety_level end
+    def moderate?;   safety_level == 2 if safety_level end
+    def restricted?; safety_level == 3 if safety_level end
+
+    def url
+      if owner and id
+        "http://www.flickr.com/photos/#{owner.nsid}/#{id}"
+      end
+    end
+
+    def visibility
+      if @info['visibility']
+        Visibility.new \
+          *[@info['visibility']['ispublic'],
+            @info['visibility']['isfriend'],
+            @info['visibility']['isfamily']]
+      end
+    end
+
+    def primary?; @info['isprimary'].to_i == 1 if @info['isprimary'] end
+
+    def favorite?; @info['isfavorite'].to_i == 1 if @info['isfavorite'] end
+
+    def can_comment?;  @info['editability']['cancomment'].to_i == 1 if @info['editability'] end
+    def can_add_meta?; @info['editability']['canaddmeta'].to_i == 1 if @info['editability'] end
+
+    def can_everyone_comment?
+      @info['publiceditability']['cancomment'].to_i == 1 if @info['publiceditability']
+    end
+
+    def can_everyone_add_meta?
+      @info['publiceditability']['canaddmeta'].to_i == 1 if @info['publiceditability']
+    end
+
+    def can_download?; @info['usage']['candownload'].to_i == 1 if @info['usage']['candownload'] end
+    def can_blog?;     @info['usage']['canblog'].to_i == 1     if @info['usage']['canblog']     end
+    def can_print?;    @info['usage']['canprint'].to_i == 1    if @info['usage']['canprint']    end
+    def can_share?;    @info['usage']['canshare'].to_i == 1    if @info['usage']['canshare']    end
+
+    def has_people?; @info['people']['haspeople'].to_i == 1 if @info['people'] end
+
+    def notes
+      @info['notes']['note'].map { |hash| Note.new(hash) } if @info['notes']
+    end
+
+    def get_info(info = nil)
+      info ||= Flickrie.client.get_media_info(id).body['photo']
+
+      # Fixes
+      info['title'] = info['title']['_content']
+      info['description'] = info['description']['_content']
+      info['comments_count'] = info.delete('comments')['_content']
+      info['dates']['uploaded'] = info.delete('dateuploaded')
+      info['machine_tags'] = info['tags']['tag'].
+        select { |tag| tag['machine_tag'].to_i == 1 }.
+        map { |tag| tag['_content']}.join(' ')
+      info['tags'] = info['tags']['tag'].
+        select { |tag| tag['machine_tag'].to_i == 0 }.
+        map { |tag| tag['_content']}.join(' ')
+
+      @info.update(info)
+      self
+    end
+
+    def initialize(info = {})
+      @info = info
+      @info['dates'] ||= {}
+      @info['usage'] ||= {}
+    end
+
+    module ClassMethods
+      def from_set(hash)
+        hash['photo'].map do |info|
+          info['owner'] = {
+            'nsid' => hash['owner'],
+            'username' => hash['ownername'],
+            'iconserver' => info.delete('iconserver'),
+            'iconfarm' => info.delete('iconfarm')
+          }
+          if info['place_id']
+            geo_info = %w[latitude longitude accuracy context place_id woeid]
+            info['location'] = geo_info.inject({}) do |location, geo|
+              location.update(geo => info.delete(geo))
+            end
+            info['geoperms'] = {
+              'isfamily' => info['geo_is_family'],
+              'isfriend' => info['geo_is_friend'],
+              'iscontact' => info['geo_is_contact'],
+              'ispublic' => info['geo_is_public']
+            }
+          end
+          info['dates'] = {
+            'uploaded' => info.delete('dateupload'),
+            'lastupdate' => info.delete('lastupdate'),
+            'taken' => info.delete('datetaken'),
+            'takengranularity' => info.delete('datetakengranularity'),
+          }
+          info['usage'] = {}
+
+          new(info)
+        end
+      end
+
+      def from_info(info)
+        new('media' => info['media']).get_info(info)
+      end
+
+      def from_user(hash)
+        hash['owner'] = hash['photo'].first['owner']
+        hash['ownername'] = hash['photo'].first['ownername']
+        hash['photo'].each do |info|
+          info['visibility'] = {
+            'ispublic' => info.delete('ispublic'),
+            'isfriend' => info.delete('isfriend'),
+            'isfamily' => info.delete('isfamily')
+          }
+        end
+
+        from_set(hash)
+      end
+
+      def from_sizes(info)
+        new.get_sizes(info)
+      end
+
+      def from_search(info)
+        from_user(info)
+      end
+    end
+    extend(ClassMethods)
+
+    def self.included(klass)
+      klass.extend(ClassMethods)
+    end
+
+    def self.new(info)
+      eval(info['media'].capitalize).new(info)
+    end
+  end
+end
+
+__END__
+
+
+{
+  "id"=>"6923154272",
+  "secret"=>"5519fab554",
+  "server"=>"5279",
+  "farm"=>6,
+  "dateuploaded"=>"1334189525",
+  "isfavorite"=>0,
+  "license"=>"0",
+  "safety_level"=>"0",
+  "rotation"=>0,
+  "owner"=>
+   {"nsid"=>"67131352@N04",
+    "username"=>"Janko Marohnić",
+    "realname"=>"",
+    "location"=>"",
+    "iconserver"=>"0",
+    "iconfarm"=>0},
+  "title"=>{"_content"=>"David Belle - Canon commercial"},
+  "description"=>{"_content"=>""},
+  "visibility"=>{"ispublic"=>1, "isfriend"=>0, "isfamily"=>0},
+  "dates"=>
+   {"posted"=>"1334189525",
+    "taken"=>"2012-04-11 17:12:05",
+    "takengranularity"=>"0",
+    "lastupdate"=>"1334259651"},
+  "views"=>"1",
+  "editability"=>{"cancomment"=>0, "canaddmeta"=>0},
+  "publiceditability"=>{"cancomment"=>1, "canaddmeta"=>0},
+  "usage"=>{"candownload"=>1, "canblog"=>0, "canprint"=>0, "canshare"=>0},
+  "comments"=>{"_content"=>"0"},
+  "notes"=>{"note"=>[]},
+  "people"=>{"haspeople"=>0},
+  "tags"=>
+   {"tag"=>
+     [{"id"=>"67099213-6923154272-471",
+       "author"=>"67131352@N04",
+       "raw"=>"David",
+       "_content"=>"david",
+       "machine_tag"=>0},
+      {"id"=>"67099213-6923154272-18012",
+       "author"=>"67131352@N04",
+       "raw"=>"Belle",
+       "_content"=>"belle",
+       "machine_tag"=>0}]},
+  "location"=> {...}
+  "geoperms"=>{"ispublic"=>1, "iscontact"=>0, "isfriend"=>0, "isfamily"=>0},
+  "urls"=>
+   {"url"=>
+     [{"type"=>"photopage",
+       "_content"=>"http://www.flickr.com/photos/67131352@N04/6923154272/"}]},
+}

data/lib/flickrie/photo.rb

@@ -0,0 +1,109 @@
+module Flickrie
+  class Photo
+    include Media
+
+    attr_reader :size
+
+    SIZES = {
+      'Square 75'  => 'sq',
+      'Square 150' => 'q',
+      'Thumbnail'  => 't',
+      'Small 240'  => 's',
+      'Small 320'  => 'n',
+      'Medium 500' => 'm',
+      'Medium 640' => 'z',
+      'Medium 800' => 'c',
+      'Large 1024' => 'l',
+      'Original'   => 'o'
+    }
+
+    def square!(number); @size = "Square #{number}"; self end
+    def thumbnail!;      @size = "Thumbnail";        self end
+    def small!(number);  @size = "Small #{number}";  self end
+    def medium!(number); @size = "Medium #{number}"; self end
+    def large!(number);  @size = "Large #{number}";  self end
+    def original!;       @size = "Original";         self end
+
+    def square(number); dup.square!(number) end
+    def thumbnail;      dup.thumbnail!      end
+    def small(number);  dup.small!(number)  end
+    def medium(number); dup.medium!(number) end
+    def large(number);  dup.large!(number)  end
+    def original;       dup.original!       end
+
+    [75, 150].each do |n|
+      define_method("square#{n}!") { square!(n) }
+      define_method("square#{n}") { square(n) }
+    end
+    [240, 320].each do |n|
+      define_method("small#{n}!") { small!(n) }
+      define_method("small#{n}") { small(n) }
+    end
+    [500, 640, 800].each do |n|
+      define_method("medium#{n}!") { medium!(n) }
+      define_method("medium#{n}") { medium(n) }
+    end
+    [1024].each do |n|
+      define_method("large#{n}!") { large!(n) }
+      define_method("large#{n}") { large(n) }
+    end
+
+    def largest!; @size = largest_size; self end
+    def largest;  dup.largest! end
+
+    def available_sizes
+      SIZES.select { |_, s| @info["url_#{s}"] }.keys
+    end
+
+    def width;      @info["width_#{size_abbr}"].to_i if @info["width_#{size_abbr}"]   end
+    def height;     @info["height_#{size_abbr}"].to_i if @info["height_#{size_abbr}"] end
+
+    def source_url; @info["url_#{size_abbr}"] end
+
+    def rotation; @info['rotation'].to_i if @info['rotation'] end
+
+    def get_sizes(info = nil)
+      info ||= Flickrie.client.get_media_sizes(id).body['sizes']
+      @info['usage'].update \
+        'canblog'     => info['canblog'],
+        'canprint'    => info['canprint'],
+        'candownload' => info['candownload']
+      flickr_sizes = {
+        'Square' => 'sq',
+        'Large Square' => 'q',
+        'Thumbnail' => 't',
+        'Small' => 's',
+        'Small 320' => 'n',
+        'Medium' => 'm',
+        'Medium 640' => 'z',
+        'Medium 800' => 'c',
+        'Large' => 'l',
+        'Original' => 'o'
+      }
+      info['size'].each do |size_info|
+        size_abbr = flickr_sizes[size_info['label']]
+        @info["width_#{size_abbr}"] = size_info['width']
+        @info["height_#{size_abbr}"] = size_info['height']
+        @info["url_#{size_abbr}"] = size_info['source']
+      end
+
+      @size = largest_size
+      self
+    end
+
+    private
+
+    def initialize(info = {}, size = nil)
+      super(info)
+      @size = size || largest_size
+    end
+
+    def largest_size
+      available_sizes.last
+    end
+
+    def size_abbr
+      SIZES[size]
+    end
+  end
+end

data/lib/flickrie/set.rb

@@ -0,0 +1,89 @@
+module Flickrie
+  class Set
+    def id;          @info['id']          end
+    def secret;      @info['secret']      end
+    def server;      @info['server']      end
+    def farm;        @info['farm']        end
+    def title;       @info['title']       end
+    def description; @info['description'] end
+
+    def primary_media_id; @info['primary'] end
+    alias primary_photo_id primary_media_id
+    alias primary_video_id primary_media_id
+
+    def views_count; @info['count_views'].to_i if @info['count_views'] end
+    def comments_count; @info['count_comments'].to_i if @info['count_comments'] end
+    def photos_count; @info['count_photos'].to_i if @info['count_photos'] end
+    def videos_count; @info['count_videos'].to_i if @info['count_videos'] end
+    def media_count; photos_count + videos_count rescue nil end
+
+    def owner; User.new('nsid' => @info['owner']) if @info['owner'] end
+
+    def photos; Flickrie.photos_from_set(id) end
+    def videos; Flickrie.videos_from_set(id) end
+    def media;  Flickrie.media_from_set(id)  end
+
+    def can_comment?; @info['can_comment'].to_i == 1 if @info['can_comment'] end
+
+    # TODO: Figure out what this is
+    def needs_interstitial?; @info['needs_interstitial'].to_i == 1 end
+    def visibility_can_see_set?; @info['visibility_can_see_set'].to_i == 1 end
+
+    def created_at; Time.at(@info['date_create'].to_i) end
+    def updated_at; Time.at(@info['date_update'].to_i) end
+
+    def url; "http://www.flickr.com/photos/#{owner.nsid}/sets/#{id}" end
+
+    def get_info(info = nil)
+      info ||= Flickrie.client.get_set_info(id).body['photoset']
+      info['title'] = info['title']['_content']
+      info['description'] = info['description']['_content']
+      @info.update(info)
+
+      self
+    end
+
+    private
+
+    def initialize(info = {})
+      @info = info
+    end
+
+    def self.from_info(info)
+      new.get_info(info)
+    end
+
+    def self.from_user(info, user_nsid)
+      info.map do |info|
+        info['count_photos'] = info.delete('photos')
+        info['count_videos'] = info.delete('videos')
+        info['title'] = info['title']['_content']
+        info['description'] = info['description']['_content']
+        info['owner'] = user_nsid
+
+        new(info)
+      end
+    end
+  end
+end
+
+__END__
+
+{
+  "id"=>"72157629443464020",
+  "primary"=>"6913731566",
+  "secret"=>"23879c079a",
+  "server"=>"7130",
+  "farm"=>8,
+  "photos"=>"1",
+  "videos"=>0,
+  "title"=>{"_content"=>"Bla"},
+  "description"=>{"_content"=>""},
+  "needs_interstitial"=>0,
+  "visibility_can_see_set"=>1,
+  "count_views"=>"0",
+  "count_comments"=>"0",
+  "can_comment"=>0,
+  "date_create"=>"1334331151",
+  "date_update"=>"1334331155
+}

data/lib/flickrie/user.rb

@@ -0,0 +1,84 @@
+require 'date'
+
+module Flickrie
+  class User
+    def id;           @info['id']          end
+    def nsid;         @info['nsid']        end
+    def username;     @info['username']    end
+    def real_name;    @info['realname']    end
+    def location;     @info['location']    end
+    def time_zone;    @info['timezone']    end
+    def description;  @info['description'] end
+    def profile_url;  @info['profileurl']  end
+    def mobile_url;   @info['mobileurl']   end
+    def photos_url;   @info['photosurl']   end
+    def path_alias;   @info['path_alias']  end
+    def icon_server;  @info['iconserver']  end
+    def icon_farm;    @info['iconfarm']    end
+
+    def buddy_icon_url
+      if icon_farm
+        if icon_server.to_i > 0
+          "http://farm{#{icon_farm}}.staticflickr.com/{#{icon_server}}/buddyicons/#{nsid}.jpg"
+        else
+          "http://www.flickr.com/images/buddyicon.jpg"
+        end
+      end
+    end
+
+    def first_taken
+      if @info['photos'] and @info['photos']['firstdatetaken']
+        DateTime.parse(@info['photos']['firstdatetaken']).to_time
+      end
+    end
+
+    def first_uploaded
+      if @info['photos'] and @info['photos']['firstdate']
+        Time.at(@info['photos']['firstdate'].to_i)
+      end
+    end
+
+    def media_count
+      if @info['photos'] and @info['photos']['count']
+        @info['photos']['count'].to_i
+      end
+    end
+
+    def public_photos; Flickrie.public_photos_from_user(nsid) end
+
+    def pro?
+      @info['ispro'].to_i == 1 if @info['ispro']
+    end
+
+    def get_info(info = nil)
+      info ||= Flickrie.client.get_user_info(nsid).body['person']
+      @info.update(info)
+
+      # Fixes
+      %w[username realname location description profileurl
+         mobileurl photosurl].each do |attribute|
+        @info[attribute] = @info[attribute]['_content']
+      end
+      %w[count firstdatetaken firstdate].each do |photo_attribute|
+        @info['photos'][photo_attribute] = @info['photos'][photo_attribute]['_content']
+      end
+
+      self
+    end
+
+    private
+
+    def initialize(info = {})
+      @info = info
+    end
+
+    def self.from_info(info)
+      new.get_info(info)
+    end
+
+    def self.from_find(info)
+      info['username'] = info['username']['_content']
+      new(info)
+    end
+  end
+end

data/lib/flickrie/version.rb

@@ -0,0 +1,3 @@
+module Flickrie
+  VERSION = '0.0.1'
+end

data/lib/flickrie/video.rb

@@ -0,0 +1,62 @@
+module Flickrie
+  class Video
+    include Media
+
+    def ready?;   @video['ready'].to_i == 1 if @video['ready']     end
+    def failed?;  @video['failed'].to_i == 1 if @video['failed']   end
+    def pending?; @video['pending'].to_i == 1 if @video['pending'] end
+
+    def duration; @video['duration'].to_i if @video['duration'] end
+
+    def width;  @video['width'].to_i if @video['width']   end
+    def height; @video['height'].to_i if @video['height'] end
+
+    def source_url;          @video['source_url']          end
+    def download_url;        @video['download_url']        end
+    def mobile_download_url; @video['mobile_download_url'] end
+
+    def get_sizes(info = nil)
+      info ||= Flickrie.client.get_media_sizes(id).body['sizes']
+      @info['usage'].update \
+        'canblog'     => info['canblog'],
+        'canprint'    => info['canprint'],
+        'candownload' => info['candownload']
+      info['size'].each do |hash|
+        case hash['label']
+        when 'Video Player' then @video['source_url'] = hash['source']
+        when 'Site MP4'     then @video['download_url'] = hash['source']
+        when 'Mobile MP4'   then @video['mobile_download_url'] = hash['source']
+        end
+      end
+
+      self
+    end
+
+    def get_info(info = nil)
+      super
+      @video = @info['video']
+
+      self
+    end
+
+    private
+
+    def initialize(info = {})
+      super
+      @video = {}
+    end
+  end
+end
+
+__END__
+
+{
+  ...
+  "video"=>
+   {"ready"=>1,
+    "failed"=>0,
+    "pending"=>0,
+    "duration"=>"34",
+    "width"=>"480",
+    "height"=>"360"}
+}