instagram 0.1.0

data/MIT-LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2010 Mislav Marohnić
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of 
+this software and associated documentation files (the "Software"), to deal in 
+the Software without restriction, including without limitation the rights to 
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of 
+the Software, and to permit persons to whom the Software is furnished to do so, 
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all 
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS 
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR 
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER 
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN 
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,46 @@
+# Instagram Ruby library
+
+So far, the only way to browse [Instagram][] photos was their iPhone app. Well, no more.
+
+This library acts as a client for the [unofficial Instagram API][wiki]. You can:
+
+* fetch popular photos;
+* get user info;
+* browse photos by a user.
+
+Caveat: you need to know user IDs; usernames can't be used. However, you can start from the popular feed and drill down from there.
+
+## Example usage
+
+    require 'instagram'
+    
+    photos = Instagram::popular
+    photo = photos.first
+    
+    photo.caption     #=> "Extreme dog closeup"
+    photo.likes.size  #=> 54
+    
+    photo.user.username      #=> "johndoe"
+    photo.user.full_name     #=> "John Doe"
+    photo.comments[1].text   #=> "That's so cute"
+    photo.images.last.width  #=> 612
+    
+    
+    # fetch extended info for John
+    john_info = Instagram::user_info(photo.user.id)
+    
+    john_info.media_count   #=> 32
+    john_info.followers     #=> 160
+    
+    
+    # find more photos by John
+    photos_by_john = Instagram::by_user(photo.user.id)
+
+
+## Credits
+
+Instagram API reverse-engineered and Ruby library written by Mislav Marohnić.
+
+
+[instagram]: http://instagr.am/
+[wiki]: https://github.com/mislav/instagram/wiki "Instagram API"

data/lib/instagram.rb

@@ -0,0 +1,33 @@
+require 'addressable/uri'
+require 'addressable/template'
+require 'net/http'
+require 'instagram/models'
+
+module Instagram
+  
+  Popular = Addressable::URI.parse 'http://instagr.am/api/v1/feed/popular/'
+  UserFeed = Addressable::Template.new 'http://instagr.am/api/v1/feed/user/{user_id}/'
+  UserInfo = Addressable::Template.new 'http://instagr.am/api/v1/users/{user_id}/info/'
+  
+  def self.popular(params = {})
+    url = Popular.dup
+    parse_response(url, params, Timeline)
+  end
+  
+  def self.by_user(user_id, params = {})
+    url = UserFeed.expand :user_id => user_id
+    parse_response(url, params, Timeline)
+  end
+  
+  def self.user_info(user_id, params = {})
+    url = UserInfo.expand :user_id => user_id
+    parse_response(url, params, UserWrap)
+  end
+  
+  def self.parse_response(url, params, parser)
+    url.query_values = params
+    body = Net::HTTP.get url
+    parser.parse body
+  end
+  
+end

data/lib/instagram/models.rb

@@ -0,0 +1,71 @@
+require 'yajl/json_gem'
+require 'nibbler/json'
+
+module Instagram
+  
+  class Base < NibblerJSON
+    element 'pk' => :id
+  end
+  
+  class User < Base
+    element :username
+    element :full_name
+    element 'profile_pic_url' => :avatar
+    
+    # extended info
+    element :media_count
+    element 'following_count' => :following
+    element 'follower_count' => :followers
+    
+    def ==(other)
+      User === other and other.id == self.id
+    end
+  end
+  
+  class UserWrap < NibblerJSON
+    element :user, :with => User
+    # return user instead of self when done
+    def parse() super.user end
+  end
+  
+  class Media < Base
+    element :code
+    element :media_type
+    element :filter_type
+    element :device_timestamp
+    element :taken_at, :with => lambda { |sec| Time.at(sec) }
+    element :user, :with => User
+    
+    elements :likers, :with => User
+    
+    elements :comments, :with => NibblerJSON do
+      element :created_at, :with => lambda { |sec| Time.at(sec) }
+      element :content_type
+      element :type
+      element :media_id
+      element :text
+      element :user, :with => User
+    end
+    
+    elements 'image_versions' => :images, :with => NibblerJSON do
+      element :url
+      element :type
+      element :width
+      element :height
+    end
+    
+    def caption
+      # a bit of guesswork
+      if comments.first and self.user == comments.first.user
+        comments.first.text
+      end
+    end
+  end
+  
+  class Timeline < NibblerJSON
+    elements :items, :with => Media
+    # return items instead of self when done
+    def parse() super.items end
+  end
+  
+end

metadata

@@ -0,0 +1,113 @@
+--- !ruby/object:Gem::Specification 
+name: instagram
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- "Mislav Marohni\xC4\x87"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-30 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: addressable
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: yajl-ruby
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: nibbler
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 31
+        segments: 
+        - 1
+        - 2
+        - 0
+        version: 1.2.0
+  type: :runtime
+  version_requirements: *id003
+description: Ruby library for consuming the Instagram public API.
+email: mislav.marohnic@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/instagram/models.rb
+- lib/instagram.rb
+- README.md
+- MIT-LICENSE
+has_rdoc: false
+homepage: http://github.com/mislav/instagram
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Instagram API client
+test_files: []
+