bitbuckets 0.2.0

data/lib/bitbucket_rest_api/response/helpers.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+require 'faraday'
+
+module BitBucket
+  class Response::Helpers < Response
+    def on_complete(env)
+      env[:body].class.class_eval <<-RUBY_EVAL, __FILE__, __LINE__ + 1
+        include BitBucket::Result
+
+        def env
+          @env
+        end
+
+      RUBY_EVAL
+      env[:body].instance_eval { @env = env }
+    end
+  end # Response::Helpers
+end # BitBucket

data/lib/bitbucket_rest_api/response/jsonize.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+require 'faraday'
+
+module BitBucket
+  class Response::Jsonize < Response
+    dependency 'multi_json'
+
+    define_parser do |body|
+      MultiJson.load(body)
+    end
+
+    def parse(body)
+      case body
+      when ''
+        nil
+      when 'true'
+        true
+      when 'false'
+        false
+      else
+        self.class.parser.call body
+      end
+    end
+  end # Response::Jsonize
+end # BitBucket

data/lib/bitbucket_rest_api/response/mashify.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+require 'faraday'
+
+module BitBucket
+  class Response::Mashify < Response
+    dependency 'hashie/mash'
+
+    define_parser do |body|
+      ::Hashie::Mash.new body
+    end
+
+    def parse(body)
+      case body
+      when Hash
+        self.class.parser.call body
+      when Array
+        body.map { |item| item.is_a?(Hash) ? self.class.parser.call(item) : item }
+      else
+        body
+      end
+    end
+  end # Response::Mashify
+end # BitBucket

data/lib/bitbucket_rest_api/response/raise_error.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+require 'faraday'
+require 'bitbucket_rest_api/error'
+
+module BitBucket
+  class Response::RaiseError < Faraday::Response::Middleware
+    def on_complete(env)
+      case env[:status].to_i
+      when 400
+        raise BitBucket::Error::BadRequest, env
+      when 401
+        raise BitBucket::Error::Unauthorized, env
+      when 403
+        raise BitBucket::Error::Forbidden, env
+      when 404
+        raise BitBucket::Error::NotFound, env
+      when 422
+        raise BitBucket::Error::UnprocessableEntity, env
+      when 500
+        raise BitBucket::Error::InternalServerError, env
+      when 503
+        raise BitBucket::Error::ServiceUnavailable, env
+      when 400...600
+        raise BitBucket::Error::ServiceError, env
+      end
+    end
+  end # Response::RaiseError
+end # BitBucket

data/lib/bitbucket_rest_api/response/xmlize.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+require 'faraday'
+
+module BitBucket
+  class Response::Xmlize < Response
+    dependency 'nokogiri'
+
+    define_parser do |body|
+      ::Nokogiri::XML body
+    end
+
+    def parse(body)
+      case body
+      when ''
+        nil
+      when 'true'
+        true
+      when 'false'
+        false
+      else
+        self.class.parser.call body
+      end
+    end
+  end # Response::Xmlize
+end # BitBucket

data/lib/bitbucket_rest_api/result.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+module BitBucket
+  module Result
+    include BitBucket::Constants
+
+    # TODO: Add result counts method to check total items looking at result links
+
+    def ratelimit_limit
+      loaded? ? @env[:response_headers][RATELIMIT_LIMIT] : nil
+    end
+
+    def ratelimit_remaining
+      loaded? ? @env[:response_headers][RATELIMIT_REMAINING] : nil
+    end
+
+    def cache_control
+      loaded? ? @env[:response_headers][CACHE_CONTROL] : nil
+    end
+
+    def content_type
+      loaded? ? @env[:response_headers][CONTENT_TYPE] : nil
+    end
+
+    def content_length
+      loaded? ? @env[:response_headers][CONTENT_LENGTH] : nil
+    end
+
+    def etag
+      loaded? ? @env[:response_headers][ETAG] : nil
+    end
+
+    def date
+      loaded? ? @env[:response_headers][DATE] : nil
+    end
+
+    def location
+      loaded? ? @env[:response_headers][LOCATION] : nil
+    end
+
+    def server
+      loaded? ? @env[:response_headers][SERVER] : nil
+    end
+
+    def status
+      loaded? ? @env[:status] : nil
+    end
+
+    def success?
+      (200..299).include? status
+    end
+
+    # Returns raw body
+    def body
+      loaded? ? @env[:body] : nil
+    end
+
+    def loaded?
+      !!@env
+    end
+
+    # Return page links
+    def links
+      @@links = BitBucket::PageLinks.new(@env[:response_headers])
+    end
+
+    # Iterator like each for response pages. If there are no pages to
+    # iterate over this method will return nothing.
+    def each_page
+      yield body
+      yield next_page while page_iterator.has_next?
+    end
+
+    # Retrives the result of the first page. Returns <tt>nil</tt> if there is
+    # no first page - either because you are already on the first page
+    # or there are no pages at all in the result.
+    def first_page
+      first_request = page_iterator.first
+      instance_eval { @env = first_request.env } if first_request
+      body
+    end
+
+    # Retrives the result of the next page. Returns <tt>nil</tt> if there is
+    # no next page or no pages at all.
+    def next_page
+      next_request = page_iterator.next
+      instance_eval { @env = next_request.env } if next_request
+      body
+    end
+
+    # Retrives the result of the previous page. Returns <tt>nil</tt> if there is
+    # no previous page or no pages at all.
+    def prev_page
+      prev_request = page_iterator.prev
+      instance_eval { @env = prev_request.env } if prev_request
+      body
+    end
+    alias previous_page prev_page
+
+    # Retrives the result of the last page. Returns <tt>nil</tt> if there is
+    # no last page - either because you are already on the last page,
+    # there is only one page or there are no pages at all in the result.
+    def last_page
+      last_request = page_iterator.last
+      instance_eval { @env = last_request.env } if last_request
+      body
+    end
+
+    # Retrives a specific result for a page given page number.
+    # The <tt>page_number</tt> parameter is not validate, hitting a page
+    # that does not exist will return BitBucket API error. Consequently, if
+    # there is only one page, this method returns nil
+    def page(page_number)
+      request = page_iterator.get_page(page_number)
+      instance_eval { @env = request.env } if request
+      body
+    end
+
+    # Returns <tt>true</tt> if there is another page in the result set,
+    # otherwise <tt>false</tt>
+    def has_next_page?
+      page_iterator.has_next?
+    end
+
+    # Repopulates objects for new values
+    def reset
+      nil
+    end
+
+    private
+
+    # Internally used page iterator
+    def page_iterator # :nodoc:
+      @@page_iterator = BitBucket::PageIterator.new(@env)
+    end
+  end # Result
+end # BitBucket

data/lib/bitbucket_rest_api/teams.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+module BitBucket
+  class Teams < API
+    extend AutoloadHelper
+
+    def initialize(options = {})
+      super(options)
+    end
+
+    # List teams for the authenticated user where the user has the provided role
+    # Roles are :admin, :contributor, :member
+    #
+    # = Examples
+    #   bitbucket = BitBucket.new :oauth_token => '...', :oauth_secret => '...'
+    #   bitbucket.teams.list(:admin)
+    #   bitbucket.teams.list('member')
+    #   bitbucket.teams.list(:contributor) { |team| ... }
+    def list(user_role)
+      response = get_request("/2.0/teams/?role=#{user_role}")
+      return response['values'] unless block_given?
+
+      response['values'].each { |el| yield el }
+    end
+
+    alias all list
+
+    # Return the profile for the provided team
+    #
+    # = Example
+    #   bitbucket = BitBucket.new :oauth_token => '...', :oauth_secret => '...'
+    #   bitbucket.teams.profile(:team_name_here)
+    def profile(team_name)
+      get_request("/2.0/teams/#{team_name}")
+    end
+
+    # List members of the provided team
+    #
+    # = Examples
+    #   bitbucket = BitBucket.new :oauth_token => '...', :oauth_secret => '...'
+    #   bitbucket.teams.members(:team_name_here)
+    #   bitbucket.teams.members(:team_name_here) { |member| ... }
+    def members(team_name)
+      response = get_request("/2.0/teams/#{team_name}/members")
+      return response['values'] unless block_given?
+
+      response['values'].each { |el| yield el }
+    end
+
+    # List followers of the provided team
+    #
+    # = Examples
+    #   bitbucket = BitBucket.new :oauth_token => '...', :oauth_secret => '...'
+    #   bitbucket.teams.followers(:team_name_here)
+    #   bitbucket.teams.followers(:team_name_here) { |follower| ... }
+    def followers(team_name)
+      response = get_request("/2.0/teams/#{team_name}/followers")
+      return response['values'] unless block_given?
+
+      response['values'].each { |el| yield el }
+    end
+
+    # List accounts following the provided team
+    #
+    # = Examples
+    #   bitbucket = BitBucket.new :oauth_token => '...', :oauth_secret => '...'
+    #   bitbucket.teams.following(:team_name_here)
+    #   bitbucket.teams.following(:team_name_here) { |followee| ... }
+    def following(team_name)
+      response = get_request("/2.0/teams/#{team_name}/following")
+      return response['values'] unless block_given?
+
+      response['values'].each { |el| yield el }
+    end
+
+    # List repos for provided team
+    # Private repos will only be returned if the user is authorized to view them
+    #
+    # = Examples
+    #   bitbucket = BitBucket.new :oauth_token => '...', :oauth_secret => '...'
+    #   bitbucket.teams.repos(:team_name_here)
+    #   bitbucket.teams.repos(:team_name_here) { |repo| ... }
+    def repos(team_name)
+      response = get_request("/2.0/repositories/#{team_name}")
+      return response['values'] unless block_given?
+
+      response['values'].each { |el| yield el }
+    end
+
+    alias repositories repos
+  end # Team
+end # BitBucket

data/lib/bitbucket_rest_api/user.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+module BitBucket
+  class User < API
+    DEFAULT_USER_OPTIONS = {
+      'first_name' => '',
+      'last_name' => '',
+      'avatar' => ''
+      # TODO: can this filed be modified?
+      # "resource_uri"    => ""
+    }.freeze
+
+    # Creates new User API
+    def initialize(options = {})
+      super(options)
+    end
+
+    # Gets the basic information associated with an account and
+    # a list of all of the repositories owned by the user.
+    # See https://confluence.atlassian.com/display/BITBUCKET/user+Endpoint#userEndpoint-GETauserprofile
+    #
+    # = Examples
+    #  bitbucket = BitBucket.new
+    #  bitbucket.user_api.profile
+    #
+    def profile
+      get_request('/1.0/user')
+    end
+
+    # Update a user
+
+    # = Parameters
+    # * <tt>:first_name</tt>    Optional string
+    # * <tt>:last_name</tt>     Optional string
+    # * <tt>:avatar</tt>        Optional string
+    # * <tt>:resource_uri</tt>  Optional string
+    #
+    # = Examples
+    #
+    #  bitbucket = BitBucket.new
+    #  bitbucket.user_api.update :first_name => 'first-name', :last_name => 'last-name'
+    #
+
+    def update(params = {})
+      normalize! params
+      filter! DEFAULT_USER_OPTIONS, params
+
+      put_request('/1.0/user', DEFAULT_USER_OPTIONS.merge(params))
+    end
+
+    # GET a list of user privileges
+    def privileges
+      get_request('/1.0/user/privileges')
+    end
+
+    # GET a list of repositories an account follows
+    # Gets the details of the repositories that the individual or team account follows.
+    # This call returns the full data about the repositories including
+    # if the repository is a fork of another repository.
+    # An account always "follows" its own repositories.
+    def follows
+      get_request('/1.0/user/follows')
+    end
+
+    # GET a list of repositories visible to an account
+    # Gets the details of the repositories that the user owns
+    # or has at least read access to.
+    # Use this if you're looking for a full list of all of the repositories associated with a user.
+    def repositories
+      get_request('/1.0/user/repositories')
+    end
+
+    alias repos repositories
+
+    # GET a list of repositories the account is following
+    # Gets a list of the repositories the account follows.
+    # This is the same list that appears on the Following tab on your account dashboard.
+    def overview
+      get_request('/1.0/user/repositories/overview')
+    end
+
+    # GET the list of repositories on the dashboard
+    # Gets the repositories list from the account's dashboard.
+    def dashboard
+      get_request('/1.0/user/repositories/dashboard')
+    end
+  end # User
+end # BitBucket

data/lib/bitbucket_rest_api/users.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+module BitBucket
+  class Users < API
+    extend AutoloadHelper
+
+    # Load all the modules after initializing Repos to avoid superclass mismatch
+    autoload_all 'bitbucket_rest_api/users',
+                 Account: 'account'
+
+    # Creates new Users API
+    def initialize(options = {})
+      super(options)
+    end
+
+    # Access to Users::Account API
+    def account
+      @account ||= ApiFactory.new 'Users::Account'
+    end
+  end # Users
+end # BitBucket