tinybucket2 1.0.0

data/lib/tinybucket/constants.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Constants
+    MISSING_REPOSITORY_KEY = 'This method call require repository keys.'.freeze
+  end
+end

data/lib/tinybucket/enumerator.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  class Enumerator < ::Enumerator
+    # Constructor
+    #
+    # This method create a enumerator to enumerate each items of iterator.
+    #
+    # @note This method return Lazy Enumerator if run on ruby 2.0.0 later.
+    #
+    # @param iterator [Tinybucket::Iterator] iterator instance.
+    # @param block [Proc] a proc object to handle each item.
+    def initialize(iterator, block)
+      @iterator = iterator
+      @block = block
+
+      super() do |y|
+        loop do
+          v = @iterator.next
+          m = @block ? @block.call(v) : v
+          y.yield(m)
+        end
+      end
+
+      lazy if lazy_enumerable?
+    end
+
+    # Get collection size.
+    #
+    # @see Tinybucket::Iterator#size
+    #
+    # @return [Fixnum, NillClass] collection size.
+    def size
+      @iterator.size
+    end
+
+    private
+
+    def lazy_enumerable?
+      ruby_major_version >= 2
+    end
+
+    def ruby_major_version
+      RUBY_VERSION.split('.')[0].to_i
+    end
+  end
+end

data/lib/tinybucket/error.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Error
+    extend ActiveSupport::Autoload
+
+    autoload :BaseError
+    autoload :ServiceError
+    autoload :Conflict
+    autoload :NotFound
+  end
+end

data/lib/tinybucket/error/base_error.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Error
+    class BaseError < StandardError
+      attr_reader :response_message, :response_headers
+
+      def initialize(message)
+        super message
+        @response_message = message
+      end
+    end
+  end
+end

data/lib/tinybucket/error/conflict.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Error
+    class Conflict < ServiceError
+    end
+  end
+end

data/lib/tinybucket/error/not_found.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Error
+    class NotFound < ServiceError
+    end
+  end
+end

data/lib/tinybucket/error/service_error.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Error
+    class ServiceError < BaseError
+      attr_accessor :http_headers
+      attr_reader :http_method, :request_url, :status_code, :response_body
+
+      def initialize(env)
+        super generate_message(env)
+        @http_headers = env[:response_headers]
+      end
+
+      private
+
+      def generate_message(env)
+        @http_method = env[:method].to_s.upcase
+        @request_url = env[:url].to_s
+        @status_code = env[:status]
+        @response_body = env[:body]
+
+        "#{@http_method} #{@request_url} #{@status_code} #{@response_body}"
+      end
+    end
+  end
+end

data/lib/tinybucket/iterator.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  # Iterator
+  #
+  # This iterator iterate items by sending request ot Bitbucket Cloud REST API.
+  class Iterator
+    # Constructor
+    #
+    # @param api_client [Tinybucket::Api::Base] an instance of Api Client class.
+    # @param method [Symbol] method name to invoke api_client method.
+    # @param args [Array<Object>] arguments to pass method call of
+    #   api_client as arguments.
+    def initialize(api_client, method, *args)
+      @client = api_client
+      @method = method
+      @args = args
+
+      @attrs = {}
+      @values = []
+      @pos = nil
+    end
+
+    def next
+      next_value
+    end
+
+    # Get collection size.
+    #
+    # @note This method return {https://developer.atlassian.com/bitbucket/api/2/reference/meta/pagination
+    #   size attribute of object collection wrapper}.
+    #   So this method may return nil.
+    #
+    # @see https://developer.atlassian.com/bitbucket/api/2/reference/meta/pagination
+    #   Paging through object collections
+    #
+    # @return [Fixnum, NillClas] collection size.
+    def size
+      load_next if next?
+      @attrs[:size]
+    end
+
+    private
+
+    def next_value
+      load_next if next?
+
+      @values.fetch(@pos).tap { @pos += 1 }
+    rescue IndexError
+      raise StopIteration
+    end
+
+    def next?
+      @pos.nil? || (@values.size == @pos && @attrs[:next])
+    end
+
+    def load_next
+      @pos = 0 if @pos.nil?
+
+      page = @client.send(@method, *next_params)
+
+      @attrs = page.attrs
+      @values.concat(page.items)
+    end
+
+    def next_params
+      params =
+        if @attrs.empty?
+          {}
+        else
+          query = URI.parse(@attrs[:next]).query
+          Hash[*query.split(/&|=/).map { |v| CGI.unescape(v) }]
+        end
+
+      @args[-1].merge!(params)
+      @args
+    end
+  end
+end

data/lib/tinybucket/model.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Model
+    extend ActiveSupport::Autoload
+
+    [
+      :Base,
+      :Branch,
+      :BranchRestriction,
+      :BuildStatus,
+      :Comment,
+      :Commit,
+      :ErrorResponse,
+      :Page,
+      :Profile,
+      :Project,
+      :PullRequest,
+      :Repository,
+      :Team
+    ].each do |klass_name|
+      autoload klass_name
+    end
+  end
+end

data/lib/tinybucket/model/base.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Model
+    class Base
+      include ::ActiveModel::Serializers::JSON
+      include Concerns::AcceptableAttributes
+      include Concerns::Enumerable
+      include Concerns::Reloadable
+      include Concerns::ApiCallable
+
+      def self.concern_included?(concern_name)
+        mod_name = "Tinybucket::Model::Concerns::#{concern_name}".constantize
+        ancestors.include?(mod_name)
+      end
+
+      def initialize(json)
+        self.attributes = json
+        @_loaded = !json.empty?
+      end
+
+      def attributes=(hash)
+        hash.each_pair do |key, value|
+          if acceptable_attribute?(key)
+            send("#{key}=".intern, value)
+          else
+            logger.warn("Ignored '#{key}' attribute (value: #{value}). [#{self.class}]")
+          end
+        end
+      end
+
+      def attributes
+        acceptable_attributes.map do |key|
+          { key => send(key.intern) }
+        end.reduce(&:merge)
+      end
+
+      protected
+
+      def logger
+        Tinybucket.logger
+      end
+    end
+  end
+end

data/lib/tinybucket/model/branch.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Model
+    # Branch
+    #
+    # @see https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Busername%7D/%7Brepo_slug%7D/refs/branches
+    #   Branch Resource
+    #
+    # @!attribute [rw] links
+    #   @return [Hash]
+    # @!attribute [rw] type
+    #   @return [String]
+    # @!attribute [rw] name
+    #   @return [String]
+    # @!attribute [rw] repository
+    #   @return [Hash]
+    # @!attribute [rw] target
+    #   @return [Hash]
+    class Branch < Base
+      include Tinybucket::Model::Concerns::RepositoryKeys
+
+      acceptable_attributes :links, :type, :name, :repository, :target
+
+      # Returns the commits available for the specific branch
+      #
+      # @param options [Hash]
+      # @return [Tinybucket::Resource::Commits]
+      def commits(options = {})
+        commits_resource.branch(name, options)
+      end
+
+      private
+
+      def commits_resource(options = {})
+        Tinybucket::Resource::Commits.new(self, options)
+      end
+
+      def branches_api
+        create_api('Branches', repo_keys)
+      end
+
+      def load_model
+        branches_api.find(name, {})
+      end
+    end
+  end
+end

data/lib/tinybucket/model/branch_restriction.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Model
+    # BranchRestriction
+    #
+    # @see https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Busername%7D/%7Brepo_slug%7D/branch-restrictions
+    #   branch-restrictions Resource
+    #
+    # @!attribute [rw] groups
+    #   @return [Array]
+    # @!attribute [rw] id
+    #   @return [Fixnum]
+    # @!attribute [rw] kind
+    #   @return [String]
+    # @!attribute [rw] links
+    #   @return [Hash]
+    # @!attribute [rw] pattern
+    #   @return [String]
+    # @!attribute [rw] users
+    #   @return [Array]
+    # @!attribute [rw] uuid
+    #   @return [NillClass]
+    class BranchRestriction < Base
+      include Tinybucket::Model::Concerns::RepositoryKeys
+
+      acceptable_attributes :groups, :id, :kind, :links, :pattern, :users, :uuid
+
+      # Update this branch restriction
+      #
+      # @todo to be implemented
+      # @raise [NotImplementedError] to be implemented.
+      def update(_params)
+        raise NotImplementedError
+      end
+
+      # Delete this branch restriction
+      #
+      # @todo to be implemented
+      # @raise [NotImplementedError] to be implemented.
+      def destroy
+        raise NotImplementedError
+      end
+    end
+  end
+end

data/lib/tinybucket/model/build_status.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Model
+    # Build Status
+    #
+    # @see https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Busername%7D/%7Brepo_slug%7D/commit/%7Bnode%7D/statuses/build
+    #   statuses/build Resource
+    #
+    # @!attribute [rw] state
+    #   @return [String]
+    # @!attribute [rw] type
+    #   @return [String]
+    # @!attribute [rw] key
+    #   @return [String]
+    # @!attribute [rw] name
+    #   @return [String]
+    # @!attribute [rw] url
+    #   @return [String]
+    # @!attribute [rw] description
+    #   @return [String]
+    # @!attribute [rw] links
+    #   @return [Hash]
+    class BuildStatus < Base
+      include Tinybucket::Model::Concerns::RepositoryKeys
+      include Tinybucket::Model::Concerns::Reloadable
+
+      acceptable_attributes \
+        :state, :type, :key, :name, :url, :description, :links, \
+        :created_on, :updated_on
+
+      attr_accessor :revision
+
+      # Update build status
+      #
+      # @param options [Hash]
+      # @option options [String] :state
+      # @return [Tinybucket::Model::BuildStatus]
+      def update(options)
+        build_status_api.put(revision, key, options).tap do |m|
+          m.repo_keys = repo_keys
+          m.revision = revision
+        end
+      end
+
+      private
+
+      def build_status_api
+        create_api('BuildStatus', repo_keys)
+      end
+
+      def load_model
+        build_status_api.find(revision, key)
+      end
+    end
+  end
+end

data/lib/tinybucket/model/comment.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module Tinybucket
+  module Model
+    # Comment
+    #
+    # @see https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Busername%7D/%7Brepo_slug%7D/commit/%7Bsha%7D/comments
+    #   Comment Resource
+    #
+    # @!attribute [rw] links
+    #   @return [Hash]
+    # @!attribute [rw] id
+    #   @return [Fixnum]
+    # @!attribute [rw] parent
+    #   @return [Hash]
+    # @!attribute [rw] filename
+    #   @return [String]
+    # @!attribute [rw] content
+    #   @return [Hash]
+    # @!attribute [rw] user
+    #   @return [Hash]
+    # @!attribute [rw] inline
+    #   @return [Hash]
+    # @!attribute [rw] created_on
+    #   @return [String]
+    # @!attribute [rw] updated_on
+    #   @return [String]
+    # @!attribute [rw] uuid
+    #   @return [NillClass]
+    class Comment < Base
+      include Tinybucket::Model::Concerns::RepositoryKeys
+
+      acceptable_attributes \
+        :links, :id, :parent, :filename, :content, :user, :inline, \
+        :created_on, :updated_on, :uuid
+
+      # @!attribute [rw] commented_to
+      #   @return [Tinybucket::Model::PullRequest, Tinybucket::Model::Commit]
+      attr_accessor :commented_to
+
+      private
+
+      def commit_api
+        create_api('Comments', repo_keys)
+      end
+
+      def pull_request_api
+        create_api('PullRequests', repo_keys)
+      end
+
+      def load_model
+        api =
+          case commented_to
+          when Tinybucket::Model::Commit
+            commit_api
+          when Tinybucket::Model::PullRequest
+            pull_request_api
+          else
+            raise ArgumentError, 'commented_to was invalid'
+          end
+
+        api.commented_to = commented_ato
+        api.find(id, {})
+      end
+    end
+  end
+end