Merge pull request #75 from bitbucket-rest-api/components

Implemented Components endpoint

Author: dmgarland

lib/bitbucket_rest_api/repos.rb

@@ -17,6 +17,7 @@ class Repos < API
                  :Webhooks    => 'webhooks',
                  :PullRequest => 'pull_request',
                  :DefaultReviewers => 'default_reviewers'
+                 :Components => 'components'
 
     DEFAULT_REPO_OPTIONS = {
         "website"         => "",
@@ -88,6 +89,10 @@ def default_reviewers
       @default_reviewers ||= ApiFactory.new 'Repos::DefaultReviewers'
     end
 
+    def components
+      @components ||= ApiFactory.new 'Repos::Components'
+    end
+
     # List branches
     #
     # = Examples

lib/bitbucket_rest_api/repos/components.rb

@@ -0,0 +1,36 @@
+# encoding: utf-8
+
+module BitBucket
+  class Repos::Components < API
+
+    # List components
+    #
+    # = Examples
+    #  bitbucket = BitBucket.new
+    #  bitbucket.repos.components.list 'user-name', 'repo-name'
+    #  bitbucket.repos.components.list 'user-name', 'repo-name' { |component| ... }
+    #
+    def list(user_name, repo_name, params={})
+      update_and_validate_user_repo_params(user_name, repo_name)
+      normalize! params
+
+      response = get_request("/2.0/repositories/#{user}/#{repo.downcase}/components", params)
+      return response['values'] unless block_given?
+      response['values'].each { |el| yield el }
+    end
+    alias :all :list
+
+    # Get a component by it's ID
+    #
+    # = Examples
+    #  bitbucket = BitBucket.new
+    #  bitbucket.repos.components.get 'user-name', 'repo-name', 1
+    #
+    def get(user_name, repo_name, component_id, params={})
+      update_and_validate_user_repo_params(user_name, repo_name)
+      normalize! params
+
+      get_request("/2.0/repositories/#{user}/#{repo.downcase}/components/#{component_id}", params)
+    end
+  end
+end

spec/bitbucket_rest_api/repos/components_spec.rb

@@ -0,0 +1,42 @@
+require 'spec_helper'
+
+describe BitBucket::Repos::Components do
+  subject { described_class.new }
+  describe '#list' do
+    before do
+      expect(subject).to receive(:request).with(
+        :get,
+        '/2.0/repositories/mock_user/mock_repo/components',
+        {},
+        {}
+      ).and_return({'values' => ['component1', 'component2', 'component3']})
+    end
+
+    context 'without a block' do
+      it 'makes a GET request for all components defined in the issue tracker' do
+        subject.list('mock_user', 'mock_repo')
+      end
+    end
+
+    context 'with a block' do
+      it 'makes a GET request for all components defined in the issue tracker' do
+        subject.list('mock_user', 'mock_repo') { |component| component }
+      end
+    end
+  end
+
+  describe '#get' do
+    before do
+      expect(subject).to receive(:request).with(
+        :get,
+        '/2.0/repositories/mock_user/mock_repo/components/1',
+        {},
+        {}
+      )
+    end
+
+    it 'makes a GET request for all components defined in the issue tracker' do
+      subject.get('mock_user', 'mock_repo', 1)
+    end
+  end
+end