tinybucket2 1.0.0

data/lib/tinybucket/model/project.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Model
+    class Project < Base
+      acceptable_attributes \
+        :type, :description, :links, :uuid, :created_on,
+        :key, :updated_on, :is_private, :name, :owner
+
+      # Update this project
+      #
+      # @param _params [Hash]
+      # @raise [NotImplementedError] to be implemented
+      def update(_params)
+        raise NotImplementedError
+      end
+
+      # Destroy this project
+      #
+      # @raise [NotImplementedError] to be implemented.
+      def destroy
+        raise NotImplementedError
+      end
+
+      # Get repositories
+      #
+      # @return [Tinybucket::Resource::Repos]
+      def repos
+        repos_resource
+      end
+
+      private
+
+      def owner_name
+        raise 'This project is not loaded yet.' if (owner.nil? || owner['username'].nil?)
+        owner['username']
+      end
+
+      def repos_resource
+        Tinybucket::Resource::Repos.new(owner_name, q: %(project.key="#{key}"))
+      end
+    end
+  end
+end

data/lib/tinybucket/model/pull_request.rb

@@ -0,0 +1,160 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Model
+    # PullRequest
+    #
+    # @see https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Busername%7D/%7Brepo_slug%7D/pullrequests
+    #   pullrequest Resource
+    #
+    # @!attribute [rw] state
+    #   @return [String]
+    # @!attribute [rw] description
+    #   @return [String]
+    # @!attribute [rw] links
+    #   @return [Hash]
+    # @!attribute [rw] title
+    #   @return [String]
+    # @!attribute [rw] task_count
+    #   @return [Fixnum]
+    # @!attribute [rw] comment_count
+    #   @return [Fixnum]
+    # @!attribute [rw] close_source_branch
+    #   @return [true, false]
+    # @!attribute [rw] destination
+    #   @return [Hash]
+    # @!attribute [rw] reason
+    #   @return [String]
+    # @!attribute [rw] id
+    #   @return [Fixnum]
+    # @!attribute [rw] source
+    #   @return [Hash]
+    # @!attribute [rw] created_on
+    #   @return [String]
+    # @!attribute [rw] author
+    #   @return [Hash]
+    # @!attribute [rw] updated_on
+    #   @return [String]
+    # @!attribute [rw] merge_commit
+    #   @return [Hash]
+    # @!attribute [rw] closed_by
+    #   @return [Hash]
+    # @!attribute [rw] reviewers
+    #   @return [Array]
+    # @!attribute [rw] participants
+    #   @return [Array]
+    # @!attribute [rw] uuid
+    #   @return [NillClass]
+    # @!attribute [rw] type
+    #   @return [String]
+    class PullRequest < Base
+      include Tinybucket::Model::Concerns::RepositoryKeys
+      include Tinybucket::Constants
+
+      acceptable_attributes \
+        :state, :description, :links, :title, :task_count, :comment_count,
+        :close_source_branch, :destination, :reason, :id, :source,
+        :created_on, :author, :updated_on, :merge_commit, :closed_by,
+        :reviewers, :participants, :uuid, :type
+
+      # Update this pull request.
+      #
+      # @todo to be implemented.
+      # @raise [NotImplementedError] to be implemented.
+      def update(_params)
+        raise NotImplementedError
+      end
+
+      # Decline or reject this pull request.
+      #
+      # @param options [Hash]
+      # @return [true,false]
+      def decline(options = {})
+        pull_request_api.decline(id, options)
+      end
+
+      # Give approval on this pull request.
+      #
+      # @param options [Hash]
+      # @return [true, false]
+      def approve(options = {})
+        pull_request_api.approve(id, options)
+      end
+
+      # Revoke approval on this pull request.
+      #
+      # @param options [Hash]
+      # @return [true, false]
+      def unapprove(options = {})
+        pull_request_api.unapprove(id, options)
+      end
+
+      # Get commits associated with this pull request.
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Resource::PullRequest::Commits]
+      def commits(options = {})
+        commits_resource(options)
+      end
+
+      # Get comments on this pull request.
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Resource::PullRequest::Comments]
+      def comments(options = {})
+        comments_resource(options)
+      end
+
+      # Get the specific comment on this pull request.
+      #
+      # @param comment_id [String]
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Comment]
+      def comment(comment_id, options = {})
+        comments_resource.find(comment_id, options)
+      end
+
+      # Get the diff for this pull request.
+      #
+      # @param options [Hash]
+      # @return [String] diff as raw text.
+      def diff(options = {})
+        pull_request_api.diff(id, options)
+      end
+
+      # Accept and merge this pull request.
+      #
+      # @param options [Hash]
+      # @return [true, false]
+      def merge(options = {})
+        pull_request_api.merge(id, options)
+      end
+
+      # Get activities on this pull requests.
+      #
+      def activities(_options = {})
+        raise NotImplementedError
+      end
+
+      private
+
+      def commits_resource(options = {})
+        Tinybucket::Resource::PullRequest::Commits.new(self, options)
+      end
+
+      def comments_resource(options = {})
+        Tinybucket::Resource::PullRequest::Comments.new(self, options)
+      end
+
+      def pull_request_api
+        raise ArgumentError, MISSING_REPOSITORY_KEY unless repo_keys?
+
+        create_api('PullRequests', repo_keys)
+      end
+
+      def load_model
+        pull_request_api.find(id)
+      end
+    end
+  end
+end

data/lib/tinybucket/model/repository.rb

@@ -0,0 +1,219 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Model
+    # Repository
+    #
+    # @see https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories
+    #   Repository Endpoint
+    #
+    # @!attribute [rw] scm
+    #   @return [String]
+    # @!attribute [rw] has_wiki
+    #   @return [true, false]
+    # @!attribute [rw] description
+    #   @return [String]
+    # @!attribute [rw] links
+    #   @return [Hash]
+    # @!attribute [rw] updated_on
+    #   @return [String]
+    # @!attribute [rw] fork_policy
+    #   @return [String]
+    # @!attribute [rw] created_on
+    #   @return [String]
+    # @!attribute [rw] owner
+    #   @return [Hash]
+    # @!attribute [rw] size
+    #   @return [Fixnum]
+    # @!attribute [rw] parent
+    #   @return [Hash, NillClass]
+    # @!attribute [rw] uuid
+    #   @return [String]
+    # @!attribute [rw] has_issues
+    #   @return [true, false]
+    # @!attribute [rw] is_private
+    #   @return [true, false]
+    # @!attribute [rw] full_name
+    #   @return [String]
+    # @!attribute [rw] name
+    #   @return [String]
+    # @!attribute [rw] language
+    #   @return [String]
+    # @!attribute [rw] website
+    #   @return [String]
+    # @!attribute [rw] type
+    #   @return [String]
+    # @!attribute [rw] project
+    #   @return [Hash]
+    class Repository < Base
+      include Tinybucket::Model::Concerns::RepositoryKeys
+
+      acceptable_attributes \
+        :scm, :has_wiki, :description, :links, :updated_on,
+        :fork_policy, :created_on, :owner, :size, :parent, :uuid,
+        :has_issues, :is_private, :full_name, :name, :language,
+        :website, :type, :project
+
+      def initialize(json)
+        super(json)
+
+        return unless full_name && full_name.split('/').size == 2
+        @repo_owner, @repo_slug = full_name.split('/')
+      end
+
+      # Remove this repository
+      #
+      # @todo to be implemented.
+      # @raise [NotImplementedError] to be implemented.
+      def destroy
+        raise NotImplementedError
+      end
+
+      # Get pull requests on thie repository.
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Enumerator] an enumerator to enumerate
+      #   pull requests as {Tinybucket::Model::PullRequest} instance.
+      def pull_requests(options = {})
+        pull_requests_resource(options)
+      end
+
+      # Get the specific pull request on this repository.
+      #
+      # @param pullrequest_id [String]
+      # @param options [Hash]
+      # @return [Tinybucket::Model::PullRequest]
+      def pull_request(pullrequest_id, options = {})
+        pull_requests_resource.find(pullrequest_id, options)
+      end
+
+      # Get watchers on this repository.
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Resource::Watchers]
+      def watchers(options = {})
+        watchers_resource(options)
+      end
+
+      # Get repository forks.
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Resource::Forks]
+      def forks(options = {})
+        forks_resource(options)
+      end
+
+      # Get commits on this repository.
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Resource::Commits]
+      def commits(options = {})
+        commits_resource(options)
+      end
+
+      # Get the specific commit on this repository.
+      #
+      # @param revision [String]
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Commit]
+      def commit(revision, options = {})
+        commits_resource.find(revision, options)
+      end
+
+      # Get branches on this repository
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Resource::Branches]
+      def branches(options = {})
+        branches_resource(options)
+      end
+
+      # Get the specific branch on this repository.
+      #
+      # @param branch [String]
+      # @param options [Hash]
+      # @return [Tinybucket::Model::Branches]
+      def branch(branch, options = {})
+        branches_resource.find(branch, options)
+      end
+
+      # Get the branch restriction information associated with this repository.
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Resource::BranchRestrictions]
+      def branch_restrictions(options = {})
+        branch_restrictions_resource(options)
+      end
+
+      # Get the specific branch restriction information on this repository.
+      #
+      # @param restriction_id [String]
+      # @param options [Hash]
+      # @return [Tinybucket::Model::BranchRestriction]
+      def branch_restriction(restriction_id, options = {})
+        branch_restrictions_resource.find(restriction_id, options)
+      end
+
+      # Get the diff for this repository.
+      #
+      # @param spec [String] A specification such as a branch name,
+      #   revision, or commit SHA.
+      # @param options [Hash]
+      # @return [String] diff as raw text.
+      def diff(spec, options = {})
+        diff_api.find(spec, options)
+      end
+
+      # Get the patch for the specification.
+      #
+      # @param spec [String] A specification such as a branch name,
+      #   revision, or commit SHA.
+      # @return [String] patch as raw text.
+      def patch(spec, options = {})
+        diff_api.find_patch(spec, options)
+      end
+
+      private
+
+      def branch_restrictions_resource(options = {})
+        Tinybucket::Resource::BranchRestrictions.new(self, options)
+      end
+
+      def branches_resource(options = {})
+        Tinybucket::Resource::Branches.new(self, options)
+      end
+
+      def commits_resource(options = {})
+        Tinybucket::Resource::Commits.new(self, options)
+      end
+
+      def hooks_resource(options = {})
+        Tinybucket::Resource::Hooks.new(self, options)
+      end
+
+      def pull_requests_resource(options = {})
+        Tinybucket::Resource::PullRequests.new(self, options)
+      end
+
+      def watchers_resource(options = {})
+        Tinybucket::Resource::Watchers.new(self, options)
+      end
+
+      def forks_resource(options = {})
+        Tinybucket::Resource::Forks.new(self, options)
+      end
+
+      def repo_api
+        create_api('Repo', repo_keys)
+      end
+
+      def diff_api
+        create_api('Diff', repo_keys)
+      end
+
+      def load_model
+        repo_api.find()
+      end
+    end
+  end
+end

data/lib/tinybucket/model/team.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Model
+    # Team
+    #
+    # @see https://developer.atlassian.com/bitbucket/api/2/reference/resource/teams
+    #   teams Endpoint
+    #
+    # @!attribute [rw] username
+    #   @return [String]
+    # @!attribute [rw] kind
+    #   @return [String, NillClass]
+    # @!attribute [rw] website
+    #   @return [String, NillClass]
+    # @!attribute [rw] display_name
+    #   @return [String]
+    # @!attribute [rw] uuid
+    #   @return [String]
+    # @!attribute [rw] links
+    #   @return [Hash]
+    # @!attribute [rw] created_on
+    #   @return [String]
+    # @!attribute [rw] location
+    #   @return [String, NillClass]
+    # @!attribute [rw] type
+    #   @return [String]
+    class Team < Base
+      acceptable_attributes \
+        :username, :kind, :website, :display_name, :uuid,
+        :links, :created_on, :location, :type
+
+      # Get this team's members.
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Resource::Team::Members]
+      def members(options = {})
+        Tinybucket::Resource::Team::Members.new(username, options)
+      end
+
+      # Get this team's followers.
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Resource::Team::Followers]
+      def followers(options = {})
+        Tinybucket::Resource::Team::Followers.new(username, options)
+      end
+
+      # Get users which this team is following.
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Resource::Team::Following]
+      def following(options = {})
+        Tinybucket::Resource::Team::Following.new(username, options)
+      end
+
+      # Get projects
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Resource::Team::Project]
+      def projects(options = {})
+        projects_resource(options)
+      end
+
+      # Get the project
+      #
+      # @param project_key [String]
+      # @return [Tinybucket::Model::Project]
+      def project(project_key, options = {})
+        projects_resource().find(project_key, options)
+      end
+
+      # Get this team's repositories.
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Resource::Team::Repos]
+      def repos(options = {})
+        Tinybucket::Resource::Team::Repos.new(username, options)
+      end
+
+      private
+
+      def projects_resource(options = {})
+        Tinybucket::Resource::Projects.new(username, options)
+      end
+
+      def team_api
+        create_api('Team')
+      end
+
+      def load_model
+        team_api.find(username)
+      end
+    end
+  end
+end