ruby_instagram 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: fe7275167fc3269ceacc12539eb7d4974ad11db3ff007f49ab8743d8bdc1601f
+  data.tar.gz: b2a9c0f6e058e85fdb950d80cc3f063e0c01662c992aa5d402052309dc4b9102
+SHA512:
+  metadata.gz: 6d26a1ce7f97161971ca25768411692240904c5182ff611b92726bee8fc1b2e05baa912334b1f53ac6f9306e50efa0f61b84a9bfcca9745ff32e738e5402020a
+  data.tar.gz: f880bcb78b4437227d8af5e3321e1266db3d91eb55198406ee6a0a6858bf8d9869b9b5bf81f9f4ff59553ccb81978dcb5db429b692667c8d7e230cde88942cd7

data/.coveralls.yml

@@ -0,0 +1 @@
+repo_token: $COVERALLS_REPO_TOKEN

data/.gitignore

@@ -0,0 +1,2 @@
+.rspec_status
+coverage

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at federico@prebo.com.ar. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,93 @@
+PATH
+  remote: .
+  specs:
+    ruby_instagram (0.1.0)
+      faraday (~> 0.17.0)
+      faraday_middleware (~> 0.13)
+      hashie (~> 4.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.7.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    coderay (1.1.2)
+    coveralls (0.8.23)
+      json (>= 1.8, < 3)
+      simplecov (~> 0.16.1)
+      term-ansicolor (~> 1.3)
+      thor (>= 0.19.4, < 2.0)
+      tins (~> 1.6)
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.3)
+    docile (1.3.2)
+    faraday (0.17.1)
+      multipart-post (>= 1.2, < 3)
+    faraday_middleware (0.13.1)
+      faraday (>= 0.7.4, < 1.0)
+    hashdiff (0.4.0)
+    hashie (4.0.0)
+    json (2.2.0)
+    method_source (0.9.2)
+    multipart-post (2.1.1)
+    mustermann (1.0.3)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    public_suffix (4.0.1)
+    rack (2.0.7)
+    rack-protection (2.0.7)
+      rack
+    rake (10.5.0)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
+    safe_yaml (1.0.5)
+    simplecov (0.16.1)
+      docile (~> 1.1)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.2)
+    sinatra (2.0.7)
+      mustermann (~> 1.0)
+      rack (~> 2.0)
+      rack-protection (= 2.0.7)
+      tilt (~> 2.0)
+    term-ansicolor (1.7.1)
+      tins (~> 1.0)
+    thor (0.20.3)
+    tilt (2.0.10)
+    tins (1.22.2)
+    vcr (5.0.0)
+    webmock (3.6.0)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  coveralls
+  pry
+  rake (~> 10.0)
+  rspec (~> 3.0)
+  ruby_instagram!
+  sinatra (~> 2.0)
+  vcr
+  webmock
+
+BUNDLED WITH
+   2.0.2

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 goprebo
+
+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/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Fede
+
+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,62 @@
+[![wercker status](https://app.wercker.com/status/18ae5df682bec0bc60b9ed3174f9f98b/s/master "wercker status")](https://app.wercker.com/project/byKey/18ae5df682bec0bc60b9ed3174f9f98b)
+[![Coverage Status](https://coveralls.io/repos/github/goprebo/ruby_instagram/badge.svg?branch=master)](https://coveralls.io/github/goprebo/ruby_instagram?branch=master)
+
+# RubyInstagram
+
+Ruby wrapper for the Instagram APIs
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ruby_instagram'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ruby_instagram
+
+## Usage
+
+```ruby
+RubyInstagram.configure do |config|
+  config.client_id = "YOUR_CLIENT_ID"
+  config.client_secret = "YOUR_CLIENT_SECRET"
+  redirect_uri = "YOUR_REDIRECT_URI"
+end
+```
+
+### Authentication
+
+get "/oauth/connect" do
+  redirect Instagram.authorize_url(:redirect_uri => CALLBACK_URL)
+end
+
+get "/oauth/callback" do
+  response = Instagram.get_access_token(params[:code], :redirect_uri => CALLBACK_URL)
+  session[:access_token] = response.access_token
+  redirect "/nav"
+end
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/goprebo/ruby_instagram. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the RubyInstagram project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/goprebo/ruby_instagram/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'ruby_instagram'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+require 'pry'
+Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/faraday/mashify.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'faraday'
+
+module FaradayMiddleware
+  # Public: Converts parsed response bodies to a Hashie::Mash if they were of
+  # Hash or Array type.
+  class Mashify < Faraday::Response::Middleware
+    attr_accessor :mash_class
+
+    class << self
+      attr_accessor :mash_class
+    end
+
+    dependency do
+      require 'hashie/mash'
+      self.mash_class = ::Hashie::Mash
+    end
+
+    def initialize(app = nil, options = {})
+      super(app)
+      self.mash_class = options[:mash_class] || self.class.mash_class
+    end
+
+    def parse(body)
+      case body
+      when Hash
+        mash_class.new(body)
+      when Array
+        body.map { |item| parse(item) }
+      else
+        body
+      end
+    end
+  end
+end

data/lib/faraday/raise_http_exception.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require 'faraday'
+
+# @private
+module FaradayMiddleware
+  # @private
+  class RaiseHttpException < Faraday::Middleware
+    def call(env)
+      @app.call(env).on_complete do |response|
+        case response[:status].to_i
+        when 400
+          raise RubyInstagram::BadRequest, error_message_400(response)
+        when 404
+          raise RubyInstagram::NotFound, error_message_400(response)
+        when 429
+          raise RubyInstagram::TooManyRequests, error_message_400(response)
+        when 500
+          raise RubyInstagram::InternalServerError, error_message_500(response, 'Something is technically wrong.')
+        when 502
+          raise RubyInstagram::BadGateway, error_message_500(response, 'The server returned an invalid or incomplete response.')
+        when 503
+          raise RubyInstagram::ServiceUnavailable, error_message_500(response, 'Instagram is rate limiting your requests.')
+        when 504
+          raise RubyInstagram::GatewayTimeout, error_message_500(response, '504 Gateway Time-out')
+        end
+      end
+    end
+
+    def initialize(app)
+      super app
+      @parser = nil
+    end
+
+    private
+
+    def content_type(response)
+      response[:response_headers][:content_type]
+    end
+
+    def text_response?(response)
+      content_type(response) == 'text/html; charset=utf-8'
+    end
+
+    def error_message_400(response)
+      "#{response[:method].to_s.upcase} #{response[:url]}: #{response[:status]} #{error_body(response)}"
+    end
+
+    def error_message_500(response, body = nil)
+      "#{response[:method].to_s.upcase} #{response[:url]}: #{[response[:status].to_s + ':', body].compact.join(' ')}"
+    end
+
+    def error_body(response)
+      return response[:body] if text_response?(response)
+
+      JSON.parse(response[:body])
+    end
+  end
+end

data/lib/ruby_instagram.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require File.expand_path('ruby_instagram/error', __dir__)
+require File.expand_path('ruby_instagram/configuration', __dir__)
+require File.expand_path('ruby_instagram/api', __dir__)
+require File.expand_path('ruby_instagram/client', __dir__)
+require File.expand_path('ruby_instagram/response', __dir__)
+
+module RubyInstagram
+  extend Configuration
+
+  # Alias for Instagram::Client.new
+  #
+  # @return [Instagram::Client]
+  def self.client(options = {})
+    RubyInstagram::Client.new(options)
+  end
+
+  # Delegate to Instagram::Client
+  def self.method_missing(method, *args, &block)
+    return super unless client.respond_to?(method)
+
+    client.send(method, *args, &block)
+  end
+
+  # Delegate to Instagram::Client
+  def self.respond_to?(method, include_all = false)
+    client.respond_to?(method, include_all) || super
+  end
+end

data/lib/ruby_instagram/api.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require File.expand_path('connection', __dir__)
+require File.expand_path('request', __dir__)
+require File.expand_path('oauth', __dir__)
+
+module RubyInstagram
+  class API
+    attr_accessor(*Configuration::VALID_OPTIONS_KEYS)
+
+    # Creates a new API
+    def initialize(options = {})
+      options = RubyInstagram.options.merge(options)
+      Configuration::VALID_OPTIONS_KEYS.each do |key|
+        send("#{key}=", options[key])
+      end
+    end
+
+    def config
+      {}.tap do |conf|
+        Configuration::VALID_OPTIONS_KEYS.each do |key|
+          conf[key] = send(key)
+        end
+      end
+    end
+
+    include Connection
+    include Request
+    include OAuth
+  end
+end

data/lib/ruby_instagram/client.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module RubyInstagram
+  # Wrapper for the Instagram REST API
+  #
+  # @note All methods have been separated into modules and follow the same grouping used in https://developers.facebook.com/docs/instagram-basic-display-api/reference
+  # @see http://instagram.com/developer/
+  class Client < API
+    Dir[File.expand_path('client/*.rb', __dir__)].each { |f| require f }
+
+    include RubyInstagram::Client::Users
+  end
+end

data/lib/ruby_instagram/client/users.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module RubyInstagram
+  class Client
+    # Defines methods related to users
+    module Users
+      # Returns extended information of a given user
+      #
+      # @overload user(id=nil, options={})
+      #   @param user [Integer] An Instagram user ID
+      #   @return [Hashie::Mash] The requested user.
+      #   @example Return extended information for @shayne
+      #     RubyInstagram.user(20)
+      # @authenticated true
+      #
+      #   If getting this data of a protected user, you must authenticate (and be allowed to see that user).
+      # @see https://developers.facebook.com/docs/instagram-basic-display-api/reference/user
+      def user(*args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        get(args.first || 'me', options)
+      end
+    end
+
+    # Returns a list of recent media items for a given user
+    #
+    # @overload user_recent_media(options={})
+    #   @param options [Hash] A customizable set of options.
+    #   @return [Hashie::Mash]
+    #   @example Returns a list of user media items for the currently authenticated user
+    #     RubyInstagram.user_media
+    # @see https://developers.facebook.com/docs/instagram-basic-display-api/reference/user/media
+    # @authenticated true
+    #
+    # For getting this data, you must authenticate (and be allowed to see that user).
+    def user_media(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      id = args.first || 'me'
+      get("#{id}/media", options)
+    end
+  end
+end

data/lib/ruby_instagram/configuration.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require File.expand_path('version', __dir__)
+
+module RubyInstagram
+  # Defines constants and methods related to configuration
+  module Configuration
+    # An array of valid keys in the options hash when configuring a {RubyInstagram::API}
+    VALID_OPTIONS_KEYS = %i[
+      access_token
+      app_id
+      app_secret
+      scope
+      connection_options
+      redirect_uri
+      endpoint
+      user_agent
+    ].freeze
+
+    # By default, don't set a user access token
+    DEFAULT_ACCESS_TOKEN = nil
+
+    # By default, don't set an application ID
+    DEFAULT_APP_ID = nil
+
+    # By default, don't set an application secret
+    DEFAULT_APP_SECRET = nil
+
+    # By default, don't set any connection options
+    DEFAULT_CONNECTION_OPTIONS = {}.freeze
+
+    # The endpoint that will be used to connect if none is set
+    #
+    # @note There is no reason to use any other endpoint at this time
+    DEFAULT_ENDPOINT = 'https://graph.instagram.com/'
+
+    # By default, don't set an application redirect uri
+    DEFAULT_REDIRECT_URI = nil
+
+    # By default, don't set a user scope
+    DEFAULT_SCOPE = 'user_profile'
+
+    # The user agent that will be sent to the API endpoint if none is set
+    DEFAULT_USER_AGENT = "Instagram Ruby Gem #{RubyInstagram::VERSION}"
+
+    # @private
+    attr_accessor(*VALID_OPTIONS_KEYS)
+
+    # When this module is extended, set all configuration options to their default values
+    def self.extended(base)
+      base.reset
+    end
+
+    # Convenience method to allow configuration options to be set in a block
+    def configure
+      yield self
+    end
+
+    # Create a hash of options and their values
+    def options
+      VALID_OPTIONS_KEYS.inject({}) do |option, key|
+        option.merge!(key => send(key))
+      end
+    end
+
+    # Reset all configuration options to defaults
+    def reset
+      self.access_token       = DEFAULT_ACCESS_TOKEN
+      self.app_id             = DEFAULT_APP_ID
+      self.app_secret         = DEFAULT_APP_SECRET
+      self.connection_options = DEFAULT_CONNECTION_OPTIONS
+      self.scope              = DEFAULT_SCOPE
+      self.redirect_uri       = DEFAULT_REDIRECT_URI
+      self.endpoint           = DEFAULT_ENDPOINT
+      self.user_agent         = DEFAULT_USER_AGENT
+    end
+  end
+end

data/lib/ruby_instagram/connection.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'faraday_middleware'
+Dir[File.expand_path('../faraday/*.rb', __dir__)].each { |f| require f }
+
+module RubyInstagram
+  module Connection
+    private
+
+    def connection(raw = false)
+      options = { headers: { 'Accept' => 'application/json; charset=utf-8', 'User-Agent' => user_agent },
+                  url: endpoint }.merge(connection_options)
+
+      Faraday::Connection.new(options) do |builder|
+        builder.use(FaradayMiddleware::OAuth2, access_token, token_type: :param) if access_token
+        builder.use(Faraday::Request::UrlEncoded)
+        builder.use FaradayMiddleware::Mashify unless raw
+        builder.use(Faraday::Response::ParseJson) unless raw
+        builder.use(FaradayMiddleware::RaiseHttpException)
+        builder.adapter Faraday.default_adapter
+      end
+    end
+  end
+end

data/lib/ruby_instagram/error.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module RubyInstagram
+  # Custom error class for rescuing from all Instagram errors
+  class Error < StandardError; end
+
+  # Raised when Instagram returns the HTTP status code 400
+  class BadRequest < Error; end
+
+  # Raised when Instagram returns the HTTP status code 404
+  class NotFound < Error; end
+
+  # Raised when Instagram returns the HTTP status code 429
+  class TooManyRequests < Error; end
+
+  # Raised when Instagram returns the HTTP status code 500
+  class InternalServerError < Error; end
+
+  # Raised when Instagram returns the HTTP status code 502
+  class BadGateway < Error; end
+
+  # Raised when Instagram returns the HTTP status code 503
+  class ServiceUnavailable < Error; end
+
+  # Raised when Instagram returns the HTTP status code 504
+  class GatewayTimeout < Error; end
+
+  # Raised when a subscription payload hash is invalid
+  class InvalidSignature < Error; end
+
+  # Raised when Instagram returns the HTTP status code 429
+  class RateLimitExceeded < Error; end
+end

data/lib/ruby_instagram/oauth.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module RubyInstagram
+  module OAuth
+    OAUTH_ENDPOINT = 'https://api.instagram.com/'
+    # Return URL for OAuth authorization
+    def authorize_url(options = {})
+      send('endpoint=', OAUTH_ENDPOINT)
+      options[:response_type] ||= 'code'
+      options[:redirect_uri] ||= options[:redirect_uri]
+      options[:scope] ||= scope
+      params = authorization_params.merge(options)
+      connection.build_url('/oauth/authorize/', params).to_s
+    end
+
+    # Return an access token from authorization
+    def get_access_token(code, options = {})
+      send('endpoint=', OAUTH_ENDPOINT)
+      options[:grant_type] ||= 'authorization_code'
+      options[:redirect_uri] ||= redirect_uri
+      params = access_token_params.merge(options)
+      post('/oauth/access_token/', params.merge(code: code))
+    end
+
+    private
+
+    def authorization_params
+      { app_id: app_id }
+    end
+
+    def access_token_params
+      {
+        app_id: app_id,
+        app_secret: app_secret
+      }
+    end
+  end
+end

data/lib/ruby_instagram/request.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'openssl'
+require 'base64'
+
+module RubyInstagram
+  # Defines HTTP request methods
+  module Request
+    # Perform an HTTP GET request
+    def get(path, options = {}, raw = false)
+      request(:get, path, options, raw)
+    end
+
+    # Perform an HTTP POST request
+    def post(path, options = {}, raw = false)
+      request(:post, path, options, raw)
+    end
+
+    private
+
+    # Perform an HTTP request
+    def request(method, path, options, raw = false)
+      response = connection(raw).send(method) do |request|
+        options = options.compact
+        case method
+        when :get
+          request.url(path, options)
+        when :post
+          request.url(path)
+          request.body = options unless options.empty?
+        end
+      end
+
+      return response if raw
+
+      Response.create(response.body)
+    end
+  end
+end

data/lib/ruby_instagram/response.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module RubyInstagram
+  module Response
+    def self.create(response_hash)
+      return response_hash.data if response_hash.respond_to?(:data)
+
+      response_hash
+    end
+  end
+end

data/lib/ruby_instagram/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module RubyInstagram
+  VERSION = '0.1.0'
+end

data/ruby_instagram.gemspec

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ruby_instagram/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'ruby_instagram'
+  spec.version       = RubyInstagram::VERSION
+  spec.authors       = ['Kickser', 'Federico Farina', 'Alejo Zárate', 'Nicolás Vázquez']
+  spec.email         = ['support@goprebo.com', 'federico@goprebo.com', 'ale@goprebo.com', 'nico@goprebo.com']
+
+  spec.summary       = 'Ruby wrapper for the Instagram API'
+  spec.homepage      = 'https://github.com/goprebo/ruby_instagram'
+  spec.license       = 'MIT'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'coveralls', '~> 0.8.23'
+  spec.add_development_dependency 'pry', '~> 0.12'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'sinatra', '~> 2.0'
+  spec.add_development_dependency 'vcr', '~> 5.0'
+  spec.add_development_dependency 'webmock', '~> 3.6'
+
+  spec.add_runtime_dependency('faraday', '~> 0.17.0')
+  spec.add_runtime_dependency('faraday_middleware', '~> 0.13')
+  spec.add_runtime_dependency('hashie', '~> 4.0')
+end

data/sample_app.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'sinatra'
+require 'pry'
+require File.expand_path('lib/ruby_instagram', __dir__)
+
+enable :sessions
+
+CALLBACK_URL = 'localhost:4567/oauth/callback'
+
+RubyInstagram.configure do |config|
+  config.app_id = 2_335_514_866_760_592
+  config.app_secret = 'f1b89d271654aba579f3c7eccfe7f7a9'
+  config.access_token = 'IGQVJVUlRMY2hiRWxKbG9SLUxaNXZAhYTUtUFgyS3hLd1daTGZAOSTlDN29wTFdERG10aW82OVcwTWZAZAOE0wa3FvMFFHRkFZAUThGZA1dlTmV5ZAWktOGdTQm8wUHhnMlBfcEpmaGcyaEN4MnFNN1RMbGcwaEl1U1BhdTBSZAUw4'
+end
+
+get '/' do
+  html =
+    "\n <h1>Ruby Instagram Gem Sample Application</h1>
+      <ol>
+        <li><a href='/oauth/authorize'>Connect with Instagram</a></li>
+        <li><a href='/user_media'>User Media</a> Get a list of a user's media</li>
+      </ol>
+    "
+  html
+end
+
+get '/oauth/authorize' do
+  redirect RubyInstagram.authorize_url(redirect_uri: CALLBACK_URL)
+end
+
+get '/oauth/callback' do
+  response = RubyInstagram.get_access_token(params[:code], redirect_uri: CALLBACK_URL)
+  session[:access_token] = response.access_token
+  redirect '/nav'
+end
+
+get '/user_media' do
+  access_token = session[:access_token] || RubyInstagram.access_token
+  return '<h1>Not logged user</h1>' unless access_token
+
+  client = RubyInstagram.client(access_token: access_token)
+  user = client.user(fields: 'media_count,username,media,account_type')
+  html = "<h1>#{user.username}'s media, media_count:#{user.media_count}, account_type: #{user.account_type} </h1>"
+  items = client.user_media(fields: 'thumbnail_url,media_type,media_url,caption,username')
+  items.each do |media_item|
+    html += "<div style='float:left;'><img height='100' width='100' src='#{media_item.media_url}'><br/></div>"
+  end
+  html
+end

data/wercker.yml

@@ -0,0 +1,10 @@
+box: ruby:2.5
+build:
+    steps:
+        - script:
+            name: Bundler update
+            code: gem install bundler
+        - bundle-install
+        - script:
+            name: Tests
+            code: bundle exec rake

metadata

@@ -0,0 +1,233 @@
+--- !ruby/object:Gem::Specification
+name: ruby_instagram
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kickser
+- Federico Farina
+- Alejo Zárate
+- Nicolás Vázquez
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2019-12-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.23
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.23
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.17.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.17.0
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.13'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+description: 
+email:
+- support@goprebo.com
+- federico@goprebo.com
+- ale@goprebo.com
+- nico@goprebo.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".coveralls.yml"
+- ".gitignore"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/faraday/mashify.rb
+- lib/faraday/raise_http_exception.rb
+- lib/ruby_instagram.rb
+- lib/ruby_instagram/api.rb
+- lib/ruby_instagram/client.rb
+- lib/ruby_instagram/client/users.rb
+- lib/ruby_instagram/configuration.rb
+- lib/ruby_instagram/connection.rb
+- lib/ruby_instagram/error.rb
+- lib/ruby_instagram/oauth.rb
+- lib/ruby_instagram/request.rb
+- lib/ruby_instagram/response.rb
+- lib/ruby_instagram/version.rb
+- ruby_instagram.gemspec
+- sample_app.rb
+- wercker.yml
+homepage: https://github.com/goprebo/ruby_instagram
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/goprebo/ruby_instagram
+  source_code_uri: https://github.com/goprebo/ruby_instagram
+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.7.6.2
+signing_key: 
+specification_version: 4
+summary: Ruby wrapper for the Instagram API
+test_files: []