dribbble 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 18244d8f44973748844ce57d3de8bb36e597749b
+  data.tar.gz: b82d095959b81603f2fbed82ae435ff8f3084535
+SHA512:
+  metadata.gz: 64c1ab8b2f3aa5cd9696037f1af805ea52573cff3bec34daa454c6f5d49558ee43c9664fac11ebd936912bbf87848227ca05e1ad0d256cde8f36e60ddbc46c46
+  data.tar.gz: 048b0c14059f97a379360fe09f41a342d7e8af23300f338962056273941f673b28e9f1bcfa0ff87d99e85aa7311432d32a75213cf6a59678de225a9e25c443e9

data/.gitignore

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

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+
+cache: bundler
+rvm:
+  - 2.0.0
+  - 2.1.1

data/CONTRIBUTING.md

@@ -0,0 +1,7 @@
+# Contributing
+
+1. Fork repository
+2. Create a branch following a [successfull branching model](http://nvie.com/posts/a-successful-git-branching-model/)
+3. Write your feature/fix
+4. Write tests
+5. Pull request

data/Gemfile

@@ -0,0 +1,2 @@
+source 'http://rubygems.org'
+gemspec

data/Guardfile

@@ -0,0 +1,10 @@
+guard 'spork', rspec_env: { 'RAILS_ENV' => 'test' } do
+  watch('Gemfile.lock')
+  watch('spec/spec_helper.rb') { :rspec }
+end
+
+guard :rspec, cmd: 'bundle exec rspec' do
+  watch(/^spec\/.+_spec\.rb$/)
+  watch(/^lib\/(.+)\.rb$/)     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb') { :rspec }
+end

data/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Charley D.
+
+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,92 @@
+# DribbbleAPI
+
+![Codeship Status for Calyhre/dribbble](https://www.codeship.io/projects/11857a40-2b09-0132-c03d-1ac4495b4327/status)
+
+[![Build Status](https://travis-ci.org/Calyhre/dribbble.svg?branch=master)](https://travis-ci.org/Calyhre/dribbble)
+
+_Dribbble API gem_
+
+## Installation
+
+### Requirements
+
+* Ruby `~> 2.0`
+
+### In a Gemfile
+
+```ruby
+gem 'dribbble'
+```
+
+### By yourself
+
+```ruby
+gem install dribbble
+```
+
+## Usage
+
+First you need to instanciate a client with a client access token. You can get one by creating an application on [developer.dribbble.com](http://developer.dribbble.com/).
+
+```ruby
+client = Dribbble::Client.new token: '0123456789abcdef'
+```
+
+### User
+
+You can get the current user logged in by calling `client.user`
+
+```ruby
+client.get_user
+#=> #<Dribbble::User ...>
+```
+
+Or you can get a specific user by knowing his ID
+
+```ruby
+user = client.get_user(1)
+#=> #<Dribbble::User id=1 ...>
+```
+
+You can access users attributes like this :
+
+```ruby
+user.name
+#=> "Charley D."
+
+user.username
+#=> "Calyhre"
+```
+
+A user also have buckets :
+
+```ruby
+user.buckets
+#=> [#<Dribbble::Bucket ...>, #<Dribbble::Bucket ...>]
+```
+
+### Shots
+
+You can create a shot by calling `client.create_shot`
+
+```ruby
+shot = {
+  title: 'Shot title',
+  desciption: 'Shot description',
+  image: File.new('some/directory/image.jpg', 'rb'),
+  tags: %w(tag1 tag2)
+}
+
+client.create_shot(shot)
+#=> True
+```
+
+## Contributing
+
+Feel free to help me make this gem awesome !
+
+[Contributors](https://github.com/Calyhre/dribbble/graphs/contributors) and [CONTRIBUTING](https://github.com/Calyhre/dribbble/blob/master/CONTRIBUTING.md)
+
+## Licence
+
+Released under the MIT License. See the [LICENSE](https://github.com/Calyhre/dribbble/blob/master/LICENSE.md) file for further details.

data/Rakefile

@@ -0,0 +1,7 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new
+
+task default: :spec
+task test: :spec

data/dribbble.gemspec

@@ -0,0 +1,28 @@
+require File.expand_path('../lib/dribbble/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.name         = 'dribbble'
+  s.version      = Dribbble::VERSION
+  s.summary      = 'Dribbble API ruby wrapper'
+  s.description  = 'Simple gem to make shots and list stuff from Dribbble'
+  s.authors      = ['Calyhre']
+  s.email        = ['contact@calyh.re']
+  s.require_path = 'lib'
+  s.homepage     = 'http://github.com/Calyhre/dribbble'
+  s.license      = 'MIT'
+
+  s.files        = `git ls-files`.split("\n")
+  s.test_files   = `git ls-files -- {test,spec,features}/*`.split("\n")
+
+  s.required_ruby_version = '>= 2.0.0'
+  s.add_runtime_dependency 'rest_client', '~> 1.7'
+
+  s.add_development_dependency 'rake', '~> 10.3'
+  s.add_development_dependency 'rspec', '~> 2.14'
+  s.add_development_dependency 'guard-rspec', '~> 4.3'
+  s.add_development_dependency 'guard-spork', '~> 1.5'
+  s.add_development_dependency 'sinatra', '~> 1.4'
+  s.add_development_dependency 'webmock', '~> 1.17'
+  s.add_development_dependency 'factory_girl', '~> 4.0'
+  s.add_development_dependency 'faker', '~> 1.3'
+end

data/lib/dribbble/base.rb

@@ -0,0 +1,34 @@
+require 'dribbble/utils'
+
+module Dribbble
+  class Base
+    include Dribbble::Utils
+    extend Dribbble::Utils
+
+    attr_reader :token
+
+    def initialize(token, json)
+      @token = token
+      @raw = json.is_a?(Hash) ? json : JSON.parse(json)
+
+      @raw.each do |k, v|
+        define_singleton_method(k) { v }
+      end
+    end
+
+    def self.batch_new(token, json)
+      json = JSON.parse json unless json.is_a? Hash
+      json.map do |obj|
+        new token, obj
+      end
+    end
+
+    def get_user(id = nil)
+      if id
+        Dribbble::User.new @token, get("/users/#{id}")
+      else
+        Dribbble::User.new @token, get('/user')
+      end
+    end
+  end
+end

data/lib/dribbble/bucket.rb

@@ -0,0 +1,4 @@
+module Dribbble
+  class Bucket < Dribbble::Base
+  end
+end

data/lib/dribbble/client.rb

@@ -0,0 +1,24 @@
+require 'dribbble/base'
+require 'dribbble/user'
+require 'dribbble/errors'
+
+require 'rest_client'
+require 'json'
+
+module Dribbble
+  class Client < Dribbble::Base
+    include Dribbble::Utils
+
+    def initialize(token: nil)
+      @token = token
+      fail Dribbble::Error::MissingToken if @token.nil?
+    end
+
+    def create_shot(attrs = {})
+      fields = %i(title image description tags team_id rebound_source_id)
+      post '/shots' do |payload|
+        fields.each { |f| payload[f] = attrs[f] }
+      end
+    end
+  end
+end

data/lib/dribbble/errors.rb

@@ -0,0 +1,25 @@
+module Dribbble
+  module Error
+    ISSUES_URL = 'https://github.com/Calyhre/dribbble/issues/new'
+
+    # Standard error we will inherit
+    class Standard < StandardError
+      def initialize(message = nil)
+        if message && message.response
+          super message.response
+        else
+          super(message || self.message)
+        end
+      end
+    end
+
+    class MissingToken < Standard
+    end
+
+    class Unauthorized < Standard
+    end
+
+    class Unprocessable < Standard
+    end
+  end
+end

data/lib/dribbble/user.rb

@@ -0,0 +1,14 @@
+require 'dribbble/bucket'
+
+module Dribbble
+  class User < Dribbble::Base
+    def self.find(token, id = nil)
+      @token = token
+      get_user(id)
+    end
+
+    def buckets
+      Dribbble::Bucket.batch_new token, get("/users/#{id}/buckets")
+    end
+  end
+end

data/lib/dribbble/utils.rb

@@ -0,0 +1,31 @@
+module Dribbble
+  module Utils
+    def full_url(path)
+      "#{Dribbble::API_URI}#{path}"
+    end
+
+    def headers
+      if @token
+        { authorization: "Bearer #{@token}" }
+      else
+        {}
+      end
+    end
+
+    def get(path)
+      RestClient.get full_url(path), headers
+    rescue RestClient::Unauthorized => e
+      raise Dribbble::Error::Unauthorized, e
+    end
+
+    def post(path)
+      payload = {}
+      yield payload
+      RestClient.post full_url(path), payload, headers
+    rescue RestClient::Unauthorized => e
+      raise Dribbble::Error::Unauthorized, e
+    rescue RestClient::UnprocessableEntity => e
+      raise Dribbble::Error::Unprocessable, e
+    end
+  end
+end

data/lib/dribbble/version.rb

@@ -0,0 +1,4 @@
+# Dribbble Version
+module Dribbble
+  VERSION = '0.0.2'
+end

data/lib/dribbble.rb

@@ -0,0 +1,6 @@
+module Dribbble
+  API_URI = 'https://api.dribbble.com/v1'
+end
+
+require 'dribbble/client'
+require 'dribbble/version'

data/spec/factories.rb

@@ -0,0 +1,2 @@
+FactoryGirl.define do
+end

data/spec/lib/dribbble/client_spec.rb

@@ -0,0 +1,59 @@
+require 'spec_helper'
+
+describe Dribbble::Client do
+  describe 'without token' do
+    it 'raises Dribbble::Error::MissingToken' do
+      expect do
+        Dribbble::Client.new
+      end.to raise_error(Dribbble::Error::MissingToken)
+    end
+  end
+
+  describe 'on #user' do
+    describe 'with an invalid token' do
+      subject do
+        stub_dribbble_with DribbbleAPI::Unauthorized
+        Dribbble::Client.new(token: 'fake_invalid_token')
+      end
+
+      it 'raise Dribbble::Error::Unauthorized' do
+        expect do
+          subject.get_user
+        end.to raise_error(Dribbble::Error::Unauthorized)
+      end
+    end
+
+    describe 'with a valid token' do
+      subject do
+        stub_dribbble_with DribbbleAPI::UserSuccess
+        Dribbble::Client.new(token: 'valid_token')
+      end
+
+      it 'return a Dribbble::User' do
+        expect(subject.get_user).to be_a Dribbble::User
+        expect(subject.get_user.name).to be_a String
+      end
+    end
+  end
+
+  describe 'on #create_shot' do
+    before :all do
+      stub_dribbble_with DribbbleAPI::Created
+      @shot = {
+        title: 'Shot title',
+        desciption: 'Shot description',
+        image: File.new("#{Dir.pwd}/spec/support/fixtures/image.jpg", 'rb'),
+        tags: %w(tag1 tag2)
+      }
+      @client = Dribbble::Client.new(token: 'valid_token')
+    end
+
+    subject do
+      @client.create_shot(@shot)
+    end
+
+    it 'create the shot' do
+      expect(subject.code).to eq(202)
+    end
+  end
+end

data/spec/lib/dribbble/user_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+RAW_USER = data_from_json 'user_success.json'
+
+describe Dribbble::User do
+  before :all do
+    @user = Dribbble::User.new 'valid_token', RAW_USER
+  end
+
+  describe 'after initialization' do
+    RAW_USER.each do |field, value|
+      it "respond to #{field}" do
+        expect(@user.send field).to eq(value)
+      end
+    end
+  end
+
+  describe 'on #buckets' do
+    subject do
+      stub_dribbble_with DribbbleAPI::BucketsSuccess
+      @user.buckets
+    end
+
+    it 'responds with buckets' do
+      expect(subject.size).to eq 1
+      expect(subject.first).to be_a Dribbble::Bucket
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,25 @@
+require 'spork'
+
+Spork.prefork do
+  require 'dribbble'
+  require 'webmock/rspec'
+  require 'faker'
+  require 'factory_girl'
+
+  Dir[File.dirname(__FILE__) + '/support/**/*.rb'].each { |f| require f }
+
+  # WebMock.disable_net_connect! allow_localhost: true, allow: 'codeclimate.com'
+
+  def stub_dribbble_with(response_class)
+    stub_request(:any, /api\.dribbble\.com/).to_rack(response_class)
+  end
+
+  def data_from_json(json_name)
+    JSON.parse File.open(File.dirname(__FILE__) + "/support/fixtures/#{json_name}", 'rb').read
+  end
+end
+
+Spork.each_run do
+  # This code will be run each time you run your specs.
+
+end

data/spec/support/dribbble.rb

@@ -0,0 +1,44 @@
+require 'sinatra/base'
+
+module DribbbleAPI
+  class Base < Sinatra::Base
+    protected
+
+    def json_response(response_code, file_name)
+      content_type :json
+      status response_code
+      File.open(File.dirname(__FILE__) + '/fixtures/' + file_name, 'rb').read
+    end
+  end
+
+  class UserSuccess < Base
+    get '/*' do
+      json_response 200, 'user_success.json'
+    end
+  end
+
+  class BucketsSuccess < Base
+    get '/*' do
+      json_response 200, 'buckets_success.json'
+    end
+  end
+
+  class Created < Base
+    post '/*' do
+      status 202
+      {}.to_json
+    end
+  end
+
+  class NotFound < Base
+    get '/*' do
+      json_response 404, 'not_found.json'
+    end
+  end
+
+  class Unauthorized < Base
+    get '/*' do
+      json_response 401, 'unauthorized.json'
+    end
+  end
+end

data/spec/support/fixtures/buckets_success.json

@@ -0,0 +1,10 @@
+[
+  {
+    "id" : 2754,
+    "name" : "Great Marks",
+    "description" : "Collecting superb brand marks from the <a href=\"https://dribbble.com\">Dribbbleverse</a>.",
+    "shots_count" : 251,
+    "created_at" : "2011-05-20T21:05:55Z",
+    "updated_at" : "2014-02-21T16:37:12Z"
+  }
+]

data/spec/support/fixtures/not_found.json

@@ -0,0 +1,3 @@
+{
+  "error": "Not found"
+}

data/spec/support/fixtures/unauthorized.json

@@ -0,0 +1,3 @@
+{
+  "message": "Bad credentials."
+}

data/spec/support/fixtures/user_success.json

@@ -0,0 +1,25 @@
+{
+  "id" : 483195,
+  "name" : "Charley D.",
+  "username" : "Calyhre",
+  "html_url" : "https://dribbble.com/Calyhre",
+  "avatar_url" : "https://d13yacurqjgara.cloudfront.net/users/483195/avatars/normal/493064787.png?1390292526",
+  "bio" : "",
+  "location" : null,
+  "links" : {},
+  "followers_count" : 1,
+  "followings_count" : 4,
+  "likes_count" : 4,
+  "shots_count" : 0,
+  "type" : "Player",
+  "pro" : false,
+  "buckets_url" : "https://api.dribbble.com/v1/users/483195/buckets",
+  "followers_url" : "https://api.dribbble.com/v1/users/483195/followers",
+  "following_url" : "https://api.dribbble.com/v1/users/483195/following",
+  "likes_url" : "https://api.dribbble.com/v1/users/483195/likes",
+  "projects_url" : "https://api.dribbble.com/v1/users/483195/projects",
+  "shots_url" : "https://api.dribbble.com/v1/users/483195/shots",
+  "teams_url" : "https://api.dribbble.com/v1/users/483195/teams",
+  "created_at" : "2014-01-21T08:22:06Z",
+  "updated_at" : "2014-09-29T19:39:00Z"
+}

metadata

@@ -0,0 +1,207 @@
+--- !ruby/object:Gem::Specification
+name: dribbble
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Calyhre
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-10-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest_client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.3'
+- !ruby/object:Gem::Dependency
+  name: guard-spork
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+- !ruby/object:Gem::Dependency
+  name: factory_girl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: faker
+  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'
+description: Simple gem to make shots and list stuff from Dribbble
+email:
+- contact@calyh.re
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- CONTRIBUTING.md
+- Gemfile
+- Guardfile
+- LICENSE.md
+- README.md
+- Rakefile
+- dribbble.gemspec
+- lib/dribbble.rb
+- lib/dribbble/base.rb
+- lib/dribbble/bucket.rb
+- lib/dribbble/client.rb
+- lib/dribbble/errors.rb
+- lib/dribbble/user.rb
+- lib/dribbble/utils.rb
+- lib/dribbble/version.rb
+- spec/factories.rb
+- spec/lib/dribbble/client_spec.rb
+- spec/lib/dribbble/user_spec.rb
+- spec/spec_helper.rb
+- spec/support/dribbble.rb
+- spec/support/fixtures/buckets_success.json
+- spec/support/fixtures/image.jpg
+- spec/support/fixtures/not_found.json
+- spec/support/fixtures/unauthorized.json
+- spec/support/fixtures/user_success.json
+homepage: http://github.com/Calyhre/dribbble
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Dribbble API ruby wrapper
+test_files:
+- spec/factories.rb
+- spec/lib/dribbble/client_spec.rb
+- spec/lib/dribbble/user_spec.rb
+- spec/spec_helper.rb
+- spec/support/dribbble.rb
+- spec/support/fixtures/buckets_success.json
+- spec/support/fixtures/image.jpg
+- spec/support/fixtures/not_found.json
+- spec/support/fixtures/unauthorized.json
+- spec/support/fixtures/user_success.json