zz_bitbucket_rest_api 0.1.8

data/lib/bitbucket_rest_api/response.rb

@@ -0,0 +1,28 @@
+# encoding: utf-8
+
+require 'faraday'
+
+module BitBucket
+  # Contains methods and attributes that act on the response returned from the
+  # request
+  class Response < Faraday::Response::Middleware
+    CONTENT_TYPE = 'Content-Type'.freeze
+
+    class << self
+      attr_accessor :parser
+    end
+
+    def self.define_parser(&block)
+      @parser = block
+    end
+
+    def response_type(env)
+      env[:response_headers][CONTENT_TYPE].to_s
+    end
+
+    def parse_response?(env)
+      env[:body].respond_to? :to_str
+    end
+
+  end # Response
+end # BitBucket

data/lib/bitbucket_rest_api/response/helpers.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+
+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,30 @@
+# encoding: utf-8
+
+require 'faraday'
+
+module BitBucket
+  class Response::Jsonize < Response
+    dependency 'multi_json'
+
+    define_parser do |body|
+      if MultiJson.respond_to?(:load)
+        MultiJson.load body
+      else
+        MultiJson.decode body
+      end
+    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,24 @@
+# encoding: utf-8
+
+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,31 @@
+# encoding: utf-8
+
+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.new(env)
+      when 401
+        raise BitBucket::Error::Unauthorized.new(env)
+      when 403
+        raise BitBucket::Error::Forbidden.new(env)
+      when 404
+        raise BitBucket::Error::NotFound.new(env)
+      when 422
+        raise BitBucket::Error::UnprocessableEntity.new(env)
+      when 500
+        raise BitBucket::Error::InternalServerError.new(env)
+      when 503
+        raise BitBucket::Error::ServiceUnavailable.new(env)
+      when 400...600
+        raise BitBucket::Error::ServiceError.new(env)
+      end
+    end
+
+  end # Response::RaiseError
+end # BitBucket

data/lib/bitbucket_rest_api/response/xmlize.rb

@@ -0,0 +1,26 @@
+# encoding: utf-8
+
+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,140 @@
+# encoding: utf-8
+
+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 self.body
+      while page_iterator.has_next?
+        yield next_page
+      end
+    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
+      self.instance_eval { @env = first_request.env } if first_request
+      self.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
+      self.instance_eval { @env = next_request.env } if next_request
+      self.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
+      self.instance_eval { @env = prev_request.env } if prev_request
+      self.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
+      self.instance_eval { @env = last_request.env } if last_request
+      self.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)
+      self.instance_eval { @env = request.env } if request
+      self.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,88 @@
+# encoding: utf-8
+
+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.to_s}")
+      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.to_s}")
+    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.to_s}/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.to_s}/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.to_s}/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.to_s}")
+      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,101 @@
+# encoding: utf-8
+
+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