imgur-api 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ab91171bd2f3ec61e508f2b9b8e85eac18479562
+  data.tar.gz: 41bd543ea770fe094d6c0903de6e862954dc4f6e
+SHA512:
+  metadata.gz: 7be725a58539db5d13b304476e7e1dd412780aea4b7d12eb62214796f379e44564d060a59598d5dcbddc5301305b92d327b0de9855aa5fcc494d4b61f26da2cc
+  data.tar.gz: f554e94eeac10659d4f1b3a6dc7b972b8ab86d05239b5720ea18b136ff200a426f5aefcd64e5269e2402d9c1bc3121b46d00284361c52eae1965abadde1060ad

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+.idea

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in imgur.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 August
+
+MIT License
+
+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,38 @@
+# Imgur
+
+Ruby wrapper for the Imgur API.
+
+## Installation
+
+If you're using Bundler:
+
+```ruby
+gem 'imgur', github: 'augustt198/imgur'
+```
+
+## Usage
+
+For anonymous usage, create a new client with your Client-ID
+
+```ruby
+client = Imgur.new(client_id) # or Imgur::Client.new(client_id)
+```
+
+To upload an image, first create a `Imgur::LocalImage`
+```ruby
+image = Imgur::LocalImage.new('path/to/image', title: 'Awesome photo')
+```
+
+Then use the client to upload it and recieve a `Imgur::Image`
+```ruby
+uploaded = client.upload(image)
+# uploaded.link => http://i.imgur.com/...
+```
+
+Creating an album is super easy!
+```ruby
+# The first argument can also be an array of images, or nil for a blank album.
+album = client.new_album(uploaded, title: 'My Photography')
+
+# album.link => http://imgur.com/a/...
+```

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/imgur.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'imgur/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'imgur-api'
+  spec.version       = Imgur::VERSION
+  spec.authors       = ['August']
+  spec.email         = ['augustt198@gmail.com']
+  spec.description   = %q{Imgur API wrapper}
+  spec.summary       = %q{Imgur API wrapper}
+  spec.homepage      = ''
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'rake'
+  spec.add_dependency 'httparty'
+
+end

data/lib/imgur.rb

@@ -0,0 +1,190 @@
+require 'imgur/version'
+require 'httparty'
+
+module Imgur
+
+  HTML_PATH = 'https://imgur.com/'
+  API_PATH = 'https://api.imgur.com/3/'
+  UPLOAD_PATH = 'upload'
+  IMAGE_PATH = 'image/'
+  ALBUM_GET_PATH = 'album/'
+  ALBUM_CREATE_PATH = 'album'
+
+  class Client
+    attr_accessor :client_id
+
+    def initialize(client_id)
+      @client_id = client_id
+    end
+
+    def post(url, body={})
+      HTTParty.post(url, body: body, headers: auth_header)
+    end
+
+    def get(url, data={})
+      HTTParty.get(url, query: data, headers: auth_header)
+    end
+
+    def get_image(id)
+      url = API_PATH + IMAGE_PATH + id
+      resp = get(url).parsed_response
+      Image.new(resp['data'])
+    end
+
+    def get_album(id)
+      url = API_PATH + ALBUM_GET_PATH + id
+      resp = get(url).parsed_response
+      Album.new resp['data']
+    end
+
+    def upload(local_file)
+      local_file.file.rewind
+      image = local_file.file.read
+      body = {image: image, type: 'file'}
+      body[:title] = local_file.title if local_file.title
+      body[:description] = local_file.description if local_file.description
+      body[:album] = local_file.album_id if local_file.album_id
+      resp = post(API_PATH + UPLOAD_PATH, body).parsed_response
+      # the Imgur API doesn't send title or description back apparently.
+      data = resp['data'].merge({'title' => body[:title], 'description' => body[:description]})
+      Image.new(data)
+    end
+
+    def new_album(images=nil, options={})
+      image_ids = []
+      if images.is_a? Array
+        if images[0].is_a? Image
+          images.each do |img|
+            image_ids << img.id
+          end
+        elsif images[0].is_a? String
+          image_ids = images
+        end
+      elsif
+        if images.is_a? Image
+          image_ids << images.id
+        elsif images.is_a? String
+          image_ids << images
+        end
+      end
+      options[:cover] = options[:cover].id if options[:cover].is_a? Image
+      body = {ids: image_ids}.merge options
+      url = API_PATH + ALBUM_CREATE_PATH
+      resp = post(url, body).parsed_response
+      id = resp['data']['id']
+      album = get_album id
+      album.deletehash = resp['data']['deletehash']
+      album
+    end
+
+    def auth_header
+      {'Authorization' => 'Client-ID ' + @client_id}
+    end
+
+  end
+
+  class Album
+    attr_accessor :id
+    attr_accessor :title
+    attr_accessor :description
+    attr_accessor :date
+    attr_accessor :cover
+    attr_accessor :cover_width
+    attr_accessor :cover_height
+    attr_accessor :account_url
+    attr_accessor :privacy
+    attr_accessor :layout
+    attr_accessor :views
+    attr_accessor :link
+    attr_accessor :deletehash
+    attr_accessor :images_count
+    attr_accessor :images
+
+    def initialize(data)
+      @id = data['id']
+      @title = data['title']
+      @description = data['description']
+      @date = Time.at data['datetime']
+      @cover = data['cover']
+      @cover_width = data['cover_width']
+      @account_url = data['account_url']
+      @privacy = data['privacy']
+      @layout = data['layout']
+      @views = data['views']
+      @link = data['link']
+      @deletehash = data['deletehash']
+      @images_count = data['images_count']
+      @images = []
+      data['images'].each do |img|
+        @images << Image.new(img)
+      end
+    end
+  end
+
+  # Represents an image stored on the computer
+  class LocalImage
+    attr_accessor :file
+    attr_accessor :title
+    attr_accessor :description
+    attr_accessor :album_id
+
+    def initialize(file, options={})
+      if file.is_a? String
+        @file = File.open file, 'rb'
+      else
+        @file = file
+      end
+      @title = options[:title]
+      @description = options[:description]
+      @album_id = options[:album_id]
+    end
+
+  end
+
+  # Represents an image on Imgur
+  class Image
+    attr_accessor :id
+    attr_accessor :title
+    attr_accessor :description
+    attr_accessor :date # Time object of :datetime
+    attr_accessor :type
+    attr_accessor :animated
+    attr_accessor :width
+    attr_accessor :height
+    attr_accessor :size
+    attr_accessor :views
+    attr_accessor :bandwidth
+    attr_accessor :favorite
+    attr_accessor :nsfw
+    attr_accessor :section
+    attr_accessor :deletehash
+    attr_accessor :link
+    attr_accessor :html_link
+
+    def initialize(data)
+      @id = data['id']
+      @title = data['title']
+      @description = data['description']
+      @date = Time.at data['datetime']
+      @type = data['type']
+      @animated = data['animated']
+      @width = data['width']
+      @height = data['height']
+      @size = data['size']
+      @views = data['views']
+      @bandwidth = data['bandwidth']
+      @favorite = data['favorite']
+      @nsfw = data['nsfw']
+      @section = data['section']
+      @deletehash = data['deletehash']
+      @link = data['link']
+      @html_link = HTML_PATH + @id
+    end
+
+  end
+
+  def self.new(client_id)
+    Client.new client_id
+  end
+
+end

data/lib/imgur/version.rb

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

metadata

@@ -0,0 +1,94 @@
+--- !ruby/object:Gem::Specification
+name: imgur-api
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- August
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Imgur API wrapper
+email:
+- augustt198@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- imgur.gemspec
+- lib/imgur.rb
+- lib/imgur/version.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.0.rc.1
+signing_key: 
+specification_version: 4
+summary: Imgur API wrapper
+test_files: []