bitbuckets 0.2.0

data/spec/bitbucket_rest_api/repos/keys_spec.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+require 'spec_helper'
+
+describe BitBucket::Repos::Keys do
+  let(:deploy_keys) { described_class.new }
+  describe '.list' do
+    before do
+      expect(deploy_keys).to receive(:request).with(
+        :get,
+        '/1.0/repositories/mock_username/mock_repo/deploy-keys/',
+        {},
+        {}
+      ).and_return(%w[key1 key2 key3])
+    end
+
+    context 'without a block' do
+      it 'should make a GET request for the deploy keys belonging to the given repo' do
+        deploy_keys.list('mock_username', 'mock_repo')
+      end
+    end
+
+    context 'with a block' do
+      it 'should make a GET request for the deploy keys belonging to the given repo' do
+        deploy_keys.list('mock_username', 'mock_repo') { |key| key }
+      end
+    end
+  end
+
+  describe '.create' do
+    before do
+      expect(deploy_keys).to receive(:request).with(
+        :post,
+        '/1.0/repositories/mock_username/mock_repo/deploy-keys/',
+        { 'key' => 'mock_ssh_key', 'label' => 'mock_label' },
+        headers: { 'Content-Type' => 'application/json' }
+      )
+    end
+
+    it 'should make a POST request for the deploy keys belonging to the given repo' do
+      deploy_keys.create('mock_username', 'mock_repo', key: 'mock_ssh_key', label: 'mock_label')
+    end
+  end
+
+  describe '.edit' do
+    before do
+      expect(deploy_keys).to receive(:request).with(
+        :put,
+        '/1.0/repositories/mock_username/mock_repo/deploy-keys/1',
+        { 'key' => 'mock_ssh_key', 'label' => 'mock_label' },
+        {}
+      )
+    end
+
+    it 'should make a PUT request for the deploy keys belonging to the given repo' do
+      deploy_keys.edit('mock_username', 'mock_repo', 1, key: 'mock_ssh_key', label: 'mock_label')
+    end
+  end
+
+  describe '.delete' do
+    before do
+      expect(deploy_keys).to receive(:request).with(
+        :delete,
+        '/1.0/repositories/mock_username/mock_repo/deploy-keys/mock_id',
+        { 'key' => 'mock_ssh_key', 'label' => 'mock_label' },
+        {}
+      )
+    end
+
+    it 'should make a DELETE request for the deploy keys belonging to the given repo' do
+      deploy_keys.delete('mock_username', 'mock_repo', 'mock_id', key: 'mock_ssh_key', label: 'mock_label')
+    end
+  end
+end

data/spec/bitbucket_rest_api/repos/pull_request_spec.rb

@@ -0,0 +1,283 @@
+# frozen_string_literal: true
+require 'spec_helper'
+
+describe BitBucket::Repos::PullRequest do
+  subject { described_class.new }
+  describe '#list' do
+    before do
+      expect(subject).to receive(:request).with(
+        :get,
+        '/2.0/repositories/mock_user/mock_repo/pullrequests',
+        {},
+        {}
+      ).and_return(%w[pr1 pr2 pr3])
+    end
+
+    context 'without a block' do
+      it 'makes a GET request for all pull requests belonging to the repo' do
+        subject.list('mock_user', 'mock_repo')
+      end
+    end
+
+    context 'with a block' do
+      it 'makes a GET request for all pull requests belonging to the repo' do
+        subject.list('mock_user', 'mock_repo') { |pr| pr }
+      end
+    end
+  end
+
+  describe '#participants' do
+    before do
+      expect(subject).to receive(:request).with(
+        :get,
+        '/1.0/repositories/mock_user/mock_repo/pullrequests/mock_pull_request_id/participants',
+        {},
+        {}
+      ).and_return(%w[participant1 participant2 participant3])
+    end
+
+    context 'without a block' do
+      it 'makes a GET request for all participants belonging to the repo' do
+        subject.participants('mock_user', 'mock_repo', 'mock_pull_request_id')
+      end
+    end
+
+    context 'with a block' do
+      it 'makes a GET request for all participants belonging to the repo' do
+        subject.participants('mock_user', 'mock_repo', 'mock_pull_request_id') { |p| p }
+      end
+    end
+  end
+
+  describe '#get' do
+    before do
+      expect(subject).to receive(:request).with(
+        :get,
+        '/2.0/repositories/mock_user/mock_repo/pullrequests/mock_pull_request_id',
+        {}
+      )
+    end
+
+    it 'makes a GET request for the pull request belonging to the repo' do
+      subject.get('mock_user', 'mock_repo', 'mock_pull_request_id')
+    end
+  end
+
+  describe '#create' do
+    before do
+      @params = {
+        title: 'mock_pr_title',
+        description: 'mock_pull_request_description',
+        source: {
+          branch: {
+            name: 'mock_source_branch_name'
+          },
+          repository: {
+            full_name: 'mock_owner/mock_repo'
+          }
+        },
+        destination: {
+          branch: {
+            name: 'mock_destination_branch_name'
+          },
+          commit: {
+            hash: 'mock_uuid'
+          }
+        },
+        close_source_branch: true
+      }
+    end
+
+    it 'makes a POST request to create a new pull request' do
+      expect(subject).to receive(:request).with(
+        :post,
+        '/2.0/repositories/mock_user/mock_repo/pullrequests',
+        @params
+      )
+
+      subject.create('mock_user', 'mock_repo', @params)
+    end
+
+    it 'validates presence of required params' do
+      expect do
+        subject.create(
+          'mock_user',
+          'mock_repo',
+          title: '',
+          description: 'mock_pull_request_description',
+          source: {
+            branch: {
+              name: 'mock_source_branch_name'
+            },
+            repository: {
+              full_name: 'mock_owner/mock_repo'
+            }
+          },
+          destination: {
+            branch: {
+              name: 'mock_destination_branch_name'
+            },
+            commit: {
+              hash: 'mock_uuid'
+            }
+          },
+          close_source_branch: true
+        )
+      end.to raise_error
+    end
+  end
+
+  describe '.put' do
+    before do
+      expect(subject).to receive(:request).with(
+        :put,
+        '/2.0/repositories/mock_user/mock_repo/pullrequests/mock_id',
+        {}
+      )
+    end
+
+    it 'makes a PUT request for the given pull request' do
+      subject.update('mock_user', 'mock_repo', 'mock_id')
+    end
+  end
+
+  describe '.commits' do
+    before do
+      expect(subject).to receive(:request).with(
+        :get,
+        '/2.0/repositories/mock_user/mock_repo/pullrequests/mock_id/commits',
+        {}
+      )
+    end
+
+    it 'makes a GET request for the commits' do
+      subject.commits('mock_user', 'mock_repo', 'mock_id')
+    end
+  end
+
+  describe '.commits' do
+    before do
+      expect(subject).to receive(:request).with(
+        :post,
+        '/2.0/repositories/mock_user/mock_repo/pullrequests/mock_id/approve',
+        {}
+      )
+    end
+
+    it 'makes a POST request' do
+      subject.approve('mock_user', 'mock_repo', 'mock_id')
+    end
+  end
+
+  describe '.delete_approval' do
+    before do
+      expect(subject).to receive(:request).with(
+        :delete,
+        '/2.0/repositories/mock_user/mock_repo/pullrequests/mock_id/approve',
+        {}
+      )
+    end
+
+    it 'makes a DELTE request' do
+      subject.delete_approval('mock_user', 'mock_repo', 'mock_id')
+    end
+  end
+
+  describe '.diff' do
+    before do
+      expect(subject).to receive(:request).with(
+        :get,
+        '/2.0/repositories/mock_user/mock_repo/pullrequests/mock_id/diff',
+        {}
+      )
+    end
+
+    it 'makes a GET request for the diff of the pull request' do
+      subject.diff('mock_user', 'mock_repo', 'mock_id')
+    end
+  end
+
+  describe '.all_activity' do
+    before do
+      expect(subject).to receive(:request).with(
+        :get,
+        '/2.0/repositories/mock_user/mock_repo/pullrequests/activity',
+        {}
+      )
+    end
+
+    it 'makes a GET request' do
+      subject.all_activity('mock_user', 'mock_repo')
+    end
+  end
+
+  describe '.activity' do
+    before do
+      expect(subject).to receive(:request).with(
+        :get,
+        '/2.0/repositories/mock_user/mock_repo/pullrequests/mock_id/activity',
+        {}
+      )
+    end
+
+    it 'makes a GET request' do
+      subject.activity('mock_user', 'mock_repo', 'mock_id')
+    end
+  end
+
+  describe '.accept_and_merge' do
+    before do
+      expect(subject).to receive(:request).with(
+        :post,
+        '/2.0/repositories/mock_user/mock_repo/pullrequests/mock_id/merge',
+        {}
+      )
+    end
+
+    it 'makes a POST request' do
+      subject.merge('mock_user', 'mock_repo', 'mock_id')
+    end
+  end
+
+  describe '.decline' do
+    before do
+      expect(subject).to receive(:request).with(
+        :post,
+        '/2.0/repositories/mock_user/mock_repo/pullrequests/mock_id/decline',
+        {}
+      )
+    end
+
+    it 'makes a POST request' do
+      subject.decline('mock_user', 'mock_repo', 'mock_id')
+    end
+  end
+
+  describe '.comments' do
+    before do
+      expect(subject).to receive(:request).with(
+        :get,
+        '/2.0/repositories/mock_user/mock_repo/pullrequests/mock_id/comments',
+        {}
+      )
+    end
+
+    it 'makes a GET request' do
+      subject.comments('mock_user', 'mock_repo', 'mock_id')
+    end
+  end
+
+  describe '.comment' do
+    before do
+      expect(subject).to receive(:request).with(
+        :get,
+        '/2.0/repositories/mock_user/mock_repo/pullrequests/mock_id/comments/comment_id',
+        {}
+      )
+    end
+
+    it 'makes a GET request' do
+      subject.comment('mock_user', 'mock_repo', 'mock_id', 'comment_id')
+    end
+  end
+end

data/spec/bitbucket_rest_api/repos/sources_spec.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+require 'spec_helper'
+
+describe BitBucket::Repos::Sources do
+  let(:subject) { BitBucket::Repos::Sources.new }
+
+  describe '#list' do
+    context 'when some parameters are missing' do
+      it 'raises an error' do
+        expect do
+          subject.list(
+            'mock_username',
+            'mock_repo'
+          )
+        end.to raise_error(ArgumentError)
+      end
+    end
+
+    context 'when path parameter is empty' do
+      before do
+        expect(subject).to receive(:request).with(
+          :get,
+          '/1.0/repositories/mock_username/mock_repo/src/moch_sha/',
+          {},
+          {}
+        )
+      end
+
+      it 'sends a GET request for a list of all source files' do
+        subject.list('mock_username', 'mock_repo', 'moch_sha', '')
+      end
+    end
+
+    context 'when path parameter is defined' do
+      before do
+        expect(subject).to receive(:request).with(
+          :get,
+          '/1.0/repositories/mock_username/mock_repo/src/moch_sha/app/controller',
+          {},
+          {}
+        )
+      end
+
+      it 'send a GET request for a list of the source files under the specified path' do
+        subject.list('mock_username', 'mock_repo', 'moch_sha', 'app/controller')
+      end
+    end
+  end
+
+  describe '#get' do
+    context 'when some parameters are missing' do
+      it 'raises an error' do
+        expect do
+          subject.get(
+            'mock_username',
+            'mock_repo',
+            'moch_sha'
+          )
+        end.to raise_error(ArgumentError)
+      end
+    end
+
+    context 'when path parameter is defined' do
+      before do
+        expect(subject).to receive(:request).with(
+          :get,
+          '/1.0/repositories/mock_username/mock_repo/raw/moch_sha/app/assets/images/logo.jpg',
+          {},
+          {}
+        )
+      end
+
+      it "send a GET request for a source file's size and contents" do
+        subject.get('mock_username', 'mock_repo', 'moch_sha', 'app/assets/images/logo.jpg')
+      end
+    end
+  end
+end

data/spec/bitbucket_rest_api/repos/webhooks_spec.rb

@@ -0,0 +1,245 @@
+# frozen_string_literal: true
+require 'spec_helper'
+
+describe BitBucket::Repos::Webhooks, wip: true do
+  subject { described_class.new }
+  let(:post_put_params) do
+    {
+      'description' => 'mock_description',
+      'url' => 'mock_url',
+      'active' => true,
+      'events' => ['repo:push']
+    }
+  end
+
+  let(:missing_key_params) do
+    {
+      'description' => 'mock_description',
+      'active' => true,
+      'events' => ['repo:push']
+    }
+  end
+
+  let(:blank_value_params) do
+    {
+      'description' => '',
+      'url' => 'mock_url',
+      'active' => true,
+      'events' => ['repo:push']
+    }
+  end
+
+  let(:bad_event_params) do
+    {
+      'description' => 'mock_description',
+      'url' => 'mock_url',
+      'active' => true,
+      'events' => ['bad:event']
+    }
+  end
+
+  let(:missing_events_params) do
+    {
+      'description' => 'mock_description',
+      'url' => 'mock_url',
+      'active' => true,
+      'events' => []
+    }
+  end
+
+  describe '#create' do
+    context 'when required fields are missing from params' do
+      context 'when a required key is missing' do
+        it 'raises an instance of BitBucket::Error::RequiredParams' do
+          expect do
+            subject.create(
+              'mock_username',
+              'mock_repo',
+              missing_key_params
+            )
+          end.to raise_error(BitBucket::Error::RequiredParams)
+        end
+      end
+
+      context 'when values of required keys are blank' do
+        it 'raises an instance of BitBucket::Error::RequiredParams' do
+          expect do
+            subject.create(
+              'mock_username',
+              'mock_repo',
+              blank_value_params
+            )
+          end.to raise_error(
+            BitBucket::Error::BlankValue,
+            "The value for: 'description', cannot be blank :("
+          )
+        end
+      end
+    end
+
+    it 'validates the given events' do
+      allow(subject).to(receive(:request))
+
+      expect do
+        subject.create(
+          'mock_username',
+          'mock_repo',
+          bad_event_params
+        )
+      end.to raise_error(
+        BitBucket::Error::BadEvents,
+        "The event: 'bad:event', does not exist :("
+      )
+    end
+
+    it 'checks that at least one event is given' do
+      allow(subject).to(receive(:request))
+
+      expect do
+        subject.create(
+          'mock_username',
+          'mock_repo',
+          missing_events_params
+        )
+      end.to raise_error(
+        BitBucket::Error::NoEvents,
+        'At least one event is required, none given :('
+      )
+    end
+
+    it 'makes a POST request to create a specific webhook' do
+      expect(subject).to receive(:request).with(
+        :post,
+        '/2.0/repositories/mock_username/mock_repo/hooks',
+        post_put_params,
+        headers: { 'Content-Type' => 'application/json' }
+      )
+
+      subject.create(
+        'mock_username',
+        'mock_repo',
+        post_put_params
+      )
+    end
+  end
+
+  describe '#list' do
+    it 'makes a GET request for all the webhooks beloning to the given repo' do
+      expect(subject).to receive(:request).with(
+        :get,
+        '/2.0/repositories/mock_username/mock_repo/hooks',
+        {},
+        {}
+      )
+
+      subject.list('mock_username', 'mock_repo')
+    end
+  end
+
+  describe '#get' do
+    it 'makes a GET request for a specific webook' do
+      expect(subject).to receive(:request).with(
+        :get,
+        '/2.0/repositories/mock_username/mock_repo/hooks/mock_uuid',
+        {},
+        {}
+      )
+
+      subject.get('mock_username', 'mock_repo', 'mock_uuid')
+    end
+  end
+
+  describe '#edit' do
+    context 'when required fields are missing from params' do
+      context 'when a required key is missing' do
+        it 'raises an instance of BitBucket::Error::RequiredParams' do
+          expect do
+            subject.edit(
+              'mock_username',
+              'mock_repo',
+              'mock_uuid',
+              missing_key_params
+            )
+          end.to raise_error(BitBucket::Error::RequiredParams)
+        end
+      end
+
+      context 'when values of required keys are blank' do
+        it 'raises an instance of BitBucket::Error::RequiredParams' do
+          expect do
+            subject.edit(
+              'mock_username',
+              'mock_repo',
+              'mock_uuid',
+              blank_value_params
+            )
+          end.to raise_error(
+            BitBucket::Error::BlankValue,
+            "The value for: 'description', cannot be blank :("
+          )
+        end
+      end
+    end
+
+    it 'validates the existence of the given events' do
+      allow(subject).to(receive(:request))
+
+      expect do
+        subject.edit(
+          'mock_username',
+          'mock_repo',
+          'mock_uuid',
+          bad_event_params
+        )
+      end.to raise_error(
+        BitBucket::Error::BadEvents,
+        "The event: 'bad:event', does not exist :("
+      )
+    end
+
+    it 'validates that at least one event is given' do
+      allow(subject).to(receive(:request))
+
+      expect do
+        subject.edit(
+          'mock_username',
+          'mock_repo',
+          'mock_uuid',
+          missing_events_params
+        )
+      end.to raise_error(
+        BitBucket::Error::NoEvents,
+        'At least one event is required, none given :('
+      )
+    end
+
+    it 'makes a PUT request for the given webhook' do
+      expect(subject).to receive(:request).with(
+        :put,
+        '/2.0/repositories/mock_username/mock_repo/hooks/mock_uuid',
+        post_put_params,
+        headers: { 'Content-Type' => 'application/json' }
+      )
+
+      subject.edit(
+        'mock_username',
+        'mock_repo',
+        'mock_uuid',
+        post_put_params
+      )
+    end
+  end
+
+  describe '#delete' do
+    it 'sends a DELETE request for the given webhook' do
+      expect(subject).to receive(:request).with(
+        :delete,
+        '/2.0/repositories/mock_username/mock_repo/hooks/mock_uuid',
+        {},
+        {}
+      )
+
+      subject.delete('mock_username', 'mock_repo', 'mock_uuid')
+    end
+  end
+end