tinybucket2 1.0.0

data/lib/tinybucket/api/repo_api.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Api
+    # Repo Api client
+    #
+    # @see https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories
+    #   repository Resource
+    #
+    # @!attribute [rw] repo_owner
+    #   @return [String] repository owner name.
+    # @!attribute [rw] repo_slug
+    #   @return [String] {https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Busername%7D/%7Brepo_slug%7D repository slug}.
+    class RepoApi < BaseApi
+      include Tinybucket::Api::Helper::RepoHelper
+
+      attr_accessor :repo_owner, :repo_slug
+
+      # Send 'GET a repository' request
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Repository]
+      def find(options = {})
+        get_path(
+          path_to_find,
+          options,
+          get_parser(:object, Tinybucket::Model::Repository)
+        )
+      end
+
+      # Send 'GET a list of watchers' request
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Page]
+      def watchers(options = {})
+        get_path(
+          path_to_watchers,
+          options,
+          get_parser(:collection, Tinybucket::Model::Profile)
+        )
+      end
+
+      # Send 'GET a list of forks' request
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Page]
+      def forks(options = {})
+        get_path(
+          path_to_forks,
+          options,
+          get_parser(:collection, Tinybucket::Model::Repository)
+        )
+      end
+    end
+  end
+end

data/lib/tinybucket/api/repos_api.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Api
+    # Repos Api client
+    class ReposApi < BaseApi
+      include Tinybucket::Api::Helper::ReposHelper
+
+      # Send 'GET a list of repositories for an account' request
+      #
+      # @see https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories
+      #   GET a list of repositories for an account
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Page]
+      def list(options = {})
+        opts = options.clone
+        opts.delete(:owner)
+
+        get_path(
+          path_to_list(options),
+          opts,
+          get_parser(:collection, Tinybucket::Model::Repository)
+        )
+      end
+    end
+  end
+end

data/lib/tinybucket/api/team_api.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Api
+    # Team Api client
+    #
+    # @see https://developer.atlassian.com/bitbucket/api/2/reference/resource/teams
+    #   teams Endpoint
+    class TeamApi < BaseApi
+      include Tinybucket::Api::Helper::TeamHelper
+
+      # Send 'GET teams' request
+      #
+      # @param role_name [String] role name
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Page]
+      def list(role_name, options = {})
+        get_path(
+          path_to_list,
+          { role: role_name }.merge(options),
+          get_parser(:collection, Tinybucket::Model::Team)
+        )
+      end
+
+      # Send 'GET the team profile' request
+      #
+      # @param name [String] The team's name
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Team]
+      def find(name, options = {})
+        get_path(
+          path_to_find(name),
+          options,
+          get_parser(:object, Tinybucket::Model::Team)
+        )
+      end
+
+      # Send 'GET the team members' request
+      #
+      # @param name [String] The team's name
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Page]
+      def members(name, options = {})
+        get_path(
+          path_to_members(name),
+          options,
+          get_parser(:collection, Tinybucket::Model::Team)
+        )
+      end
+
+      # Send 'GET the list of followers' request
+      #
+      # @param name [String] The team's name
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Page]
+      def followers(name, options = {})
+        get_path(
+          path_to_followers(name),
+          options,
+          get_parser(:collection, Tinybucket::Model::Team)
+        )
+      end
+
+      # Send 'GET a lisf of accounts the team is following' request
+      #
+      # @param name [String] The team's name
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Page]
+      def following(name, options = {})
+        get_path(
+          path_to_following(name),
+          options,
+          get_parser(:collection, Tinybucket::Model::Team)
+        )
+      end
+
+      # Send 'GET the team's repositories' request
+      #
+      # @param name [String] The team's name
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Page]
+      def repos(name, options = {})
+        get_path(
+          path_to_repos(name),
+          options,
+          get_parser(:collection, Tinybucket::Model::Repository)
+        )
+      end
+    end
+  end
+end

data/lib/tinybucket/api/user_api.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Api
+    # User Api client
+    #
+    # @see https://developer.atlassian.com/bitbucket/api/2/reference/resource/users/%7Busername%7D
+    #   users Endpoint
+    #
+    # @!attribute [rw] username
+    #   @return [String]
+    class UserApi < BaseApi
+      include Tinybucket::Api::Helper::UserHelper
+
+      attr_accessor :username
+
+      # Send 'GET the user profile' request
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Profile]
+      def profile(options = {})
+        get_path(
+          path_to_find,
+          options,
+          get_parser(:object, Tinybucket::Model::Profile)
+        )
+      end
+
+      # Send 'GET the list of followers' request
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Page]
+      def followers(options = {})
+        get_path(
+          path_to_followers,
+          options,
+          get_parser(:collection, Tinybucket::Model::Profile)
+        )
+      end
+
+      # Send 'GET a list of accounts the user is following' request
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Page]
+      def following(options = {})
+        get_path(
+          path_to_following,
+          options,
+          get_parser(:collection, Tinybucket::Model::Profile)
+        )
+      end
+
+      # Send 'GET the user's repositories' request
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Page]
+      def repos(options = {})
+        get_path(
+          path_to_repos,
+          options,
+          get_parser(:collection, Tinybucket::Model::Repository)
+        )
+      end
+    end
+  end
+end

data/lib/tinybucket/api_factory.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  class ApiFactory
+    class << self
+      def create_instance(klass_name)
+        klass =
+          begin
+            name = "#{klass_name}Api".intern
+            Tinybucket::Api.const_get name
+          rescue => e
+            # TODO: log exception
+            Tinybucket.logger.error e
+            raise ArgumentError, 'must provide klass to be instantiated'
+          end
+
+        klass.new
+      end
+    end
+  end
+end

data/lib/tinybucket/client.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  class Client
+    include ::Tinybucket::Model::Concerns::Enumerable
+
+    # Get Repositories
+    #
+    # when you want to get repositories of the owner, call with owner, options.
+    # ex) repos('owner', options) or repos('owner')
+    #
+    # when you want to get public repositories of the owner, call with options.
+    # ex) repos(options) or repos
+    #
+    # @overload repos(owner, options)
+    #   get the repositories of the owner.
+    #   @param  owner   [String, Symbol] string or symbol to describe the owner.
+    #   @option options [Hash] a hash with options
+    # @overload repos(options)
+    #   get public repositories.
+    #   @option options [Hash] a hash with options
+    # @return [Tinybucket::Resource::Repos] repository resource
+    def repos(*args)
+      case args.size
+      when 0
+        public_repos
+      when 1
+        case args.first
+        when Hash           then public_repos(args.first)
+        when String, Symbol then owners_repos(args.first)
+        else                     raise ArgumentError
+        end
+      when 2
+        case args.first
+        when String, Symbol then owners_repos(args[0], args[1])
+        else                     raise ArgumentError
+        end
+      else
+        raise ArgumentError
+      end
+    end
+
+    # Get the repository
+    #
+    # @param owner [String] repository owner name.
+    # @param repo_slug [String] {https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Busername%7D/%7Brepo_slug%7D repository slug}.
+    # @return [Tinybucket::Model::Repository]
+    def repo(owner, repo_slug)
+      Tinybucket::Model::Repository.new({}).tap do |m|
+        m.repo_owner = owner
+        m.repo_slug = repo_slug
+      end
+    end
+
+    # Get teams
+    #
+    # @param role_name [String] role name (one of "admin", "contributor", or "member")
+    # @param options
+    # @return [Tinybucket::Resource::Teams]
+    def teams(role_name, options = {})
+      Tinybucket::Resource::Teams.new(role_name, options)
+    end
+
+    # Get the team
+    #
+    # @param teamname [String] the team name.
+    # @return [Tinybucket::Model::Team]
+    def team(teamname)
+      Tinybucket::Model::Team.new({}).tap do |m|
+        m.username = teamname
+      end
+    end
+
+    # Get the user profile
+    #
+    # @param username [String] the user name.
+    # @return [Tinybucket::Model::Profile]
+    def user(username)
+      Tinybucket::Model::Profile.new({}).tap do |m|
+        m.username = username
+      end
+    end
+
+    private
+
+    # Get public repositories
+    #
+    # @param options [Hash]
+    # @return [Tinybucket::Resource::Repos]
+    def public_repos(options = {})
+      raise ArgumentError unless options.is_a?(Hash)
+
+      Tinybucket::Resource::Repos.new(nil, options)
+    end
+
+    # Get Owner's repositories
+    #
+    # @param owner [String]
+    # @param options [Hash]
+    # @return [Tinybucket::Resource::Repos]
+    def owners_repos(owner, options = {})
+      raise ArgumentError unless options.is_a?(Hash)
+
+      Tinybucket::Resource::Repos.new(owner, options)
+    end
+  end
+end

data/lib/tinybucket/config.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  class Config
+    include ActiveSupport::Configurable
+    config_accessor :logger, :oauth_token, :oauth_secret, \
+                    :cache_store_options, :access_token, \
+                    :client_id, :client_secret, :user_agent
+  end
+end

data/lib/tinybucket/connection.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Connection
+    DEFAULT_USER_AGENT = 'Tinybucket Ruby Bitbucket REST client'.freeze
+
+    def clear_cache
+      @connection = nil
+    end
+
+    def caching?
+      !@connection.nil?
+    end
+
+    def connection(parser = nil, options = {})
+      conn_options = default_options(options)
+      clear_cache
+
+      # TODO: cache connection for each (options, parser) pairs.
+      Faraday.new(
+        conn_options.merge(builder: stack(parser, options))
+      )
+    end
+
+    private
+
+    def default_options(_options)
+      {
+        headers: {
+          USER_AGENT: Tinybucket.config.user_agent || DEFAULT_USER_AGENT
+        },
+        ssl: { verify: false },
+        url: 'https://api.bitbucket.org/2.0'.freeze
+      }
+    end
+
+    def default_middleware(_options)
+      proc do |conn|
+        configure_response_cache(conn)
+
+        conn.request :multipart
+        conn.request :url_encoded
+
+        configure_auth(conn)
+
+        conn.response :json, content_type: /\bjson$/
+        conn.use Tinybucket::Response::Handler
+        conn.use :instrumentation
+
+        conn.adapter Faraday.default_adapter
+      end
+    end
+
+    def configure_auth(conn)
+      if Tinybucket.config.access_token
+        conn.request :oauth2, Tinybucket.config.access_token
+      else
+        oauth_secrets = {
+          consumer_key:    Tinybucket.config.oauth_token,
+          consumer_secret: Tinybucket.config.oauth_secret
+        }
+
+        conn.request :oauth, oauth_secrets
+        conn.response :follow_oauth_redirects, oauth_secrets
+      end
+    end
+
+    def configure_response_cache(conn)
+      return unless Tinybucket.config.cache_store_options
+
+      conn.use :http_cache, Tinybucket.config.cache_store_options
+    end
+
+    def stack(parser, options = {}, &block)
+      Faraday::RackBuilder.new(&block) and return if block_given?
+
+      # TODO: cache stack for each (options, parser) pairs
+      Faraday::RackBuilder.new do |conn|
+        conn.use parser.type,  parser_options: parser.options if parser.present?
+        default_middleware(options).call(conn)
+      end
+    end
+  end
+end