tinybucket2 1.0.0

data/lib/tinybucket/api/helper/issues_helper.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Api
+    module Helper
+      module IssuesHelper
+        include ::Tinybucket::Api::Helper::ApiHelper
+
+        private
+
+        def path_to_list
+          build_path(base_path)
+        end
+
+        def path_to_find(issue)
+          build_path(base_path,
+                     [issue, 'issue'])
+        end
+
+        def base_path
+          build_path('/repositories',
+                     [repo_owner, 'repo_owner'],
+                     [repo_slug, 'repo_slug'],
+                     'refs', 'issues')
+        end
+      end
+    end
+  end
+end

data/lib/tinybucket/api/helper/projects_helper.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Api
+    module Helper
+      module ProjectsHelper
+        include ::Tinybucket::Api::Helper::ApiHelper
+
+        private
+
+        def path_to_list(owner)
+          build_path(base_path(owner), '/')
+        end
+
+        def path_to_find(owner, project_key)
+          build_path(base_path(owner),
+                     [project_key, 'project_key'])
+        end
+
+        def base_path(owner)
+          build_path('/teams',
+                     [owner, 'owner'],
+                     'projects')
+        end
+      end
+    end
+  end
+end

data/lib/tinybucket/api/helper/pull_requests_helper.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Api
+    module Helper
+      module PullRequestsHelper
+        include ::Tinybucket::Api::Helper::ApiHelper
+
+        private
+
+        def path_to_list
+          base_path
+        end
+
+        def path_to_find(pr_id)
+          build_path(base_path,
+                     [pr_id, 'pullrequest_id'])
+        end
+
+        def path_to_commits(pr_id)
+          build_path(base_path,
+                     [pr_id, 'pullrequest_id'],
+                     'commits')
+        end
+
+        def path_to_approve(pr_id)
+          build_path(base_path,
+                     [pr_id, 'pullrequest_id'],
+                     'approve')
+        end
+
+        def path_to_diff(pr_id)
+          build_path(path_to_find(pr_id),
+                     'diff')
+        end
+
+        def path_to_decline(pr_id)
+          build_path(base_path,
+                     [pr_id, 'pullrequest_id'],
+                     'decline')
+        end
+
+        def path_to_merge(pr_id)
+          build_path(base_path,
+                     [pr_id, 'pullrequest_id'],
+                     'merge')
+        end
+
+        def base_path
+          build_path('/repositories',
+                     [repo_owner, 'repo_owner'],
+                     [repo_slug,  'repo_slug'],
+                     'pullrequests')
+        end
+      end
+    end
+  end
+end

data/lib/tinybucket/api/helper/repo_helper.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Api
+    module Helper
+      module RepoHelper
+        include ::Tinybucket::Api::Helper::ApiHelper
+
+        private
+
+        def path_to_find
+          base_path
+        end
+
+        def path_to_watchers
+          build_path(base_path, '/watchers')
+        end
+
+        def path_to_forks
+          build_path(base_path, '/forks')
+        end
+
+        def base_path
+          build_path('/repositories',
+                     [repo_owner, 'repo_owner'],
+                     [repo_slug, 'repo_slug'])
+        end
+      end
+    end
+  end
+end

data/lib/tinybucket/api/helper/repos_helper.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Api
+    module Helper
+      module ReposHelper
+        include ::Tinybucket::Api::Helper::ApiHelper
+
+        private
+
+        def path_to_list(options)
+          owner = options[:owner]
+          return base_path if owner.blank?
+          build_path(base_path, [owner, 'owner'])
+        end
+
+        def base_path
+          '/repositories'
+        end
+      end
+    end
+  end
+end

data/lib/tinybucket/api/helper/team_helper.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Api
+    module Helper
+      module TeamHelper
+        include ::Tinybucket::Api::Helper::ApiHelper
+
+        private
+
+        def path_to_list
+          base_path
+        end
+
+        def path_to_find(name)
+          team_path(name)
+        end
+
+        def path_to_members(name)
+          build_path(team_path(name), 'members')
+        end
+
+        def path_to_followers(name)
+          build_path(team_path(name), 'followers')
+        end
+
+        def path_to_following(name)
+          build_path(team_path(name), 'following')
+        end
+
+        def path_to_repos(name)
+          build_path(team_path(name), 'repositories')
+        end
+
+        def base_path
+          build_path('/teams')
+        end
+
+        def team_path(name)
+          build_path(base_path, [name, 'teamname'])
+        end
+      end
+    end
+  end
+end

data/lib/tinybucket/api/helper/user_helper.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Api
+    module Helper
+      module UserHelper
+        include ::Tinybucket::Api::Helper::ApiHelper
+
+        private
+
+        def path_to_find
+          base_path
+        end
+
+        def path_to_followers
+          build_path(base_path, 'followers')
+        end
+
+        def path_to_following
+          build_path(base_path, 'following')
+        end
+
+        def path_to_repos
+          build_path('/repositories', [username, 'username'])
+        end
+
+        def base_path
+          build_path('/users', [username, 'username'])
+        end
+      end
+    end
+  end
+end

data/lib/tinybucket/api/issues_api.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Api
+    # Issues Api client
+    #
+    # @!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 repo_slug}.
+    class IssuesApi < BaseApi
+      include Tinybucket::Api::Helper::IssuesHelper
+
+      attr_accessor :repo_owner, :repo_slug
+
+      # Send 'GET a Issues list for a repository' request
+      #
+      # @see https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Busername%7D/%7Brepo_slug%7D/refs/Issues#get
+      #   GET a Issues list for a repository
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Page]
+      def list(options = {})
+        get_path(
+          path_to_list,
+          options,
+          get_parser(:collection, Tinybucket::Model::Issue)
+        )
+      end
+
+      # Send 'GET an individual Issue' request
+      #
+      # @see https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Busername%7D/%7Brepo_slug%7D/refs/Issues/%7Bname%7D#get
+      #   GET an individual Issue
+      #
+      # @param name [String] The Issue name
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Issue]
+      def find(name, options = {})
+        get_path(
+          path_to_find(name),
+          options,
+          get_parser(:object, Tinybucket::Model::Issue)
+        )
+      end
+    end
+  end
+end

data/lib/tinybucket/api/projects_api.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Api
+    class ProjectsApi < BaseApi
+      include Tinybucket::Api::Helper::ProjectsHelper
+      attr_accessor :owner
+
+      def list(options = {})
+        get_path(
+          path_to_list(owner),
+          options,
+          get_parser(:collection, Tinybucket::Model::Project)
+        )
+      end
+
+      def find(project_key, options = {})
+        get_path(
+          path_to_find(owner, project_key),
+          options,
+          get_parser(:object, Tinybucket::Model::Project)
+        )
+      end
+    end
+  end
+end

data/lib/tinybucket/api/pull_requests_api.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Api
+    # PullRequests Api client
+    #
+    # @see https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Busername%7D/%7Brepo_slug%7D/pullrequests
+    #   pullrequests 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 PullRequestsApi < BaseApi
+      include Tinybucket::Api::Helper::PullRequestsHelper
+
+      attr_accessor :repo_owner, :repo_slug
+
+      # Send 'GET a list of open pull requests' request
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Page]
+      def list(options = {})
+        get_path(
+          path_to_list,
+          options,
+          get_parser(:collection, Tinybucket::Model::PullRequest)
+        )
+      end
+
+      # Send 'GET a specific pull request' request
+      #
+      # @param pr_id [String] The pull request identifier
+      # @param options [Hash]
+      # @return [Tinybucket::Model::PullRequest]
+      def find(pr_id, options = {})
+        get_path(
+          path_to_find(pr_id),
+          options,
+          get_parser(:object, Tinybucket::Model::PullRequest)
+        )
+      end
+
+      # Send 'GET the commits for a pull request' request
+      #
+      # @param pr_id [String] The pull request identifier
+      # @param options [Hash]
+      # @return [Tinybucket::Model::PullRequest]
+      def commits(pr_id, options = {})
+        get_path(
+          path_to_commits(pr_id),
+          options,
+          get_parser(:collection, Tinybucket::Model::Commit)
+        )
+      end
+
+      # Send 'POST a pull request approval' request
+      #
+      # @note This method return true if this pull request already approved.
+      #
+      # @param pr_id [String] The pull request identifier
+      # @param options [Hash]
+      # @return [true, false]
+      def approve(pr_id, options = {})
+        result = post_path(path_to_approve(pr_id), options)
+        (result['approved'] == true)
+      rescue Tinybucket::Error::Conflict => e
+        logger.debug 'Already approved: ' + e.inspect
+        true
+      end
+
+      # Send 'DELETE a pull request approval' request
+      #
+      # @note This method return true if this pull request is not approved yet.
+      #
+      # @param pr_id [String] The pull request identifier
+      # @param options [Hash]
+      # @return [true]
+      def unapprove(pr_id, options = {})
+        delete_path(path_to_approve(pr_id), options)
+        true
+      rescue Tinybucket::Error::NotFound => e
+        logger.debug 'Already unapproved: ' + e.inspect
+        true
+      end
+
+      # Send 'Decline or reject a pull request' request
+      #
+      # @param pr_id [String] The pull request identifier
+      # @param options [Hash]
+      # @return [true, false]
+      def decline(pr_id, options = {})
+        result = post_path(path_to_decline(pr_id), options)
+        (result['state'] == 'DECLINED')
+      end
+
+      # Send 'Accept and merge a pull request' request
+      #
+      # @param pr_id [String] The pull request identifier
+      # @param options [Hash]
+      # @return [true, false]
+      def merge(pr_id, options = {})
+        result = post_path(path_to_merge(pr_id), options)
+        (result['state'] == 'MERGED')
+      end
+
+      # Send 'GET the diff for a pull request' request
+      #
+      # @param pr_id [String] The pull request identifier
+      # @param options [Hash]
+      # @return [String] diff as raw text.
+      def diff(pr_id, options = {})
+        get_path(path_to_diff(pr_id), options)
+      end
+    end
+  end
+end