# frozen_string_literal: true require 'spec_helper' RSpec.describe Gitlab::GithubImport::Client, feature_category: :importers do subject(:client) { described_class.new('foo', parallel: parallel) } let(:parallel) { true } describe '#parallel?' do context 'when the client is running in parallel mode' do it { expect(client).to be_parallel } end context 'when the client is running in sequential mode' do let(:parallel) { false } it { expect(client).not_to be_parallel } end end describe '#user' do it 'returns the details for the given username' do expect(client.octokit).to receive(:user).with('foo') expect(client).to receive(:with_rate_limit).and_yield client.user('foo') end end describe '#pull_request_reviews' do it 'returns the pull request reviews' do expect(client) .to receive(:each_object) .with(:pull_request_reviews, 'foo/bar', 999) client.pull_request_reviews('foo/bar', 999) end end describe '#pull_request_review_requests' do it 'returns the pull request review requests' do expect(client.octokit).to receive(:pull_request_review_requests).with('foo/bar', 999) expect(client).to receive(:with_rate_limit).and_yield client.pull_request_review_requests('foo/bar', 999) end end describe '#repos' do it 'returns the user\'s repositories as a hash' do stub_request(:get, 'https://api.github.com/rate_limit') .to_return(status: 200, headers: { 'X-RateLimit-Limit' => 5000, 'X-RateLimit-Remaining' => 5000 }) stub_request(:get, 'https://api.github.com/user/repos?page=1&page_length=10&per_page=100') .to_return(status: 200, body: [{ id: 1 }, { id: 2 }].to_json, headers: { 'Content-Type' => 'application/json' }) repos = client.repos({ page: 1, page_length: 10 }) expect(repos).to match_array([{ id: 1 }, { id: 2 }]) end end describe '#repository' do it 'returns the details of a repository' do expect(client.octokit).to receive(:repo).with('foo/bar') expect(client).to receive(:with_rate_limit).and_yield client.repository('foo/bar') end it 'returns repository data as a hash' do stub_request(:get, 'https://api.github.com/rate_limit') .to_return(status: 200, headers: { 'X-RateLimit-Limit' => 5000, 'X-RateLimit-Remaining' => 5000 }) stub_request(:get, 'https://api.github.com/repos/foo/bar') .to_return(status: 200, body: { id: 1 }.to_json, headers: { 'Content-Type' => 'application/json' }) repository = client.repository('foo/bar') expect(repository).to eq({ id: 1 }) end end describe '#pull_request' do it 'returns the details of a pull_request' do expect(client.octokit).to receive(:pull_request).with('foo/bar', 999) expect(client).to receive(:with_rate_limit).and_yield client.pull_request('foo/bar', 999) end end describe '#labels' do it 'returns the labels' do expect(client) .to receive(:each_object) .with(:labels, 'foo/bar') client.labels('foo/bar') end end describe '#milestones' do it 'returns the milestones' do expect(client) .to receive(:each_object) .with(:milestones, 'foo/bar') client.milestones('foo/bar') end end describe '#releases' do it 'returns the releases' do expect(client) .to receive(:each_object) .with(:releases, 'foo/bar') client.releases('foo/bar') end end describe '#branches' do it 'returns the branches' do expect(client) .to receive(:each_object) .with(:branches, 'foo/bar') client.branches('foo/bar') end end describe '#branch_protection' do it 'returns the protection details for the given branch' do expect(client.octokit) .to receive(:branch_protection).with('org/repo', 'bar') expect(client).to receive(:with_rate_limit).and_yield branch_protection = client.branch_protection('org/repo', 'bar') expect(branch_protection).to be_a(Hash) end end describe '#each_object' do it 'converts each object into a hash' do stub_request(:get, 'https://api.github.com/rate_limit') .to_return(status: 200, headers: { 'X-RateLimit-Limit' => 5000, 'X-RateLimit-Remaining' => 5000 }) stub_request(:get, 'https://api.github.com/repos/foo/bar/releases?per_page=100') .to_return(status: 200, body: [{ id: 1 }].to_json, headers: { 'Content-Type' => 'application/json' }) client.each_object(:releases, 'foo/bar') do |release| expect(release).to eq({ id: 1 }) end end end describe '#each_page' do let(:object1) { double(:object1) } let(:object2) { double(:object2) } before do allow(client) .to receive(:with_rate_limit) .and_yield allow(client.octokit) .to receive(:public_send) .and_return([object1]) response = double(:response, data: [object2], rels: { next: nil }) next_page = double(:next_page, get: response) allow(client.octokit) .to receive(:last_response) .and_return(double(:last_response, rels: { next: next_page })) end context 'without a block' do it 'returns an Enumerator' do expect(client.each_page(:foo)).to be_an_instance_of(Enumerator) end it 'the returned Enumerator returns Page objects' do enum = client.each_page(:foo) page1 = enum.next page2 = enum.next expect(page1).to be_an_instance_of(described_class::Page) expect(page2).to be_an_instance_of(described_class::Page) expect(page1.objects).to eq([object1]) expect(page1.number).to eq(1) expect(page2.objects).to eq([object2]) expect(page2.number).to eq(2) end end context 'with a block' do it 'yields every retrieved page to the supplied block' do pages = [] client.each_page(:foo) { |page| pages << page } expect(pages[0]).to be_an_instance_of(described_class::Page) expect(pages[1]).to be_an_instance_of(described_class::Page) expect(pages[0].objects).to eq([object1]) expect(pages[0].number).to eq(1) expect(pages[1].objects).to eq([object2]) expect(pages[1].number).to eq(2) end it 'starts at the given page' do pages = [] client.each_page(:foo, page: 2) { |page| pages << page } expect(pages[0].number).to eq(2) expect(pages[1].number).to eq(3) end end end describe '#with_rate_limit' do it 'yields the supplied block when enough requests remain' do expect(client).to receive(:requests_remaining?).and_return(true) expect { |b| client.with_rate_limit(&b) }.to yield_control end it 'waits before yielding if not enough requests remain' do expect(client).to receive(:requests_remaining?).and_return(false) expect(client).to receive(:raise_or_wait_for_rate_limit) expect { |b| client.with_rate_limit(&b) }.to yield_control end it 'waits and retries the operation if all requests were consumed in the supplied block' do retries = 0 expect(client).to receive(:requests_remaining?).and_return(true) expect(client).to receive(:raise_or_wait_for_rate_limit) client.with_rate_limit do if retries == 0 retries += 1 raise(Octokit::TooManyRequests) end end expect(retries).to eq(1) end it 'increments the request count counter' do expect(client.request_count_counter) .to receive(:increment) .and_call_original expect(client).to receive(:requests_remaining?).and_return(true) client.with_rate_limit {} end it 'ignores rate limiting when disabled' do expect(client) .to receive(:rate_limiting_enabled?) .and_return(false) expect(client) .not_to receive(:requests_remaining?) expect(client.with_rate_limit { 10 }).to eq(10) end context 'when Faraday error received from octokit', :aggregate_failures do let(:error_class) { described_class::CLIENT_CONNECTION_ERROR } let(:info_params) { { 'error.class': error_class } } let(:block_to_rate_limit) { -> { client.pull_request('foo/bar', 999) } } context 'when rate_limiting_enabled is true' do it 'retries on error and succeeds' do allow_retry expect(client).to receive(:requests_remaining?).twice.and_return(true) expect(Gitlab::Import::Logger).to receive(:info).with(hash_including(info_params)).once expect(client.with_rate_limit(&block_to_rate_limit)).to eq({}) end it 'retries and does not succeed' do allow(client).to receive(:requests_remaining?).and_return(true) allow(client.octokit).to receive(:pull_request).and_raise(error_class, 'execution expired') expect { client.with_rate_limit(&block_to_rate_limit) }.to raise_error(error_class, 'execution expired') end end context 'when rate_limiting_enabled is false' do before do allow(client).to receive(:rate_limiting_enabled?).and_return(false) end it 'retries on error and succeeds' do allow_retry expect(Gitlab::Import::Logger).to receive(:info).with(hash_including(info_params)).once expect(client.with_rate_limit(&block_to_rate_limit)).to eq({}) end it 'retries and does not succeed' do allow(client.octokit).to receive(:pull_request).and_raise(error_class, 'execution expired') expect { client.with_rate_limit(&block_to_rate_limit) }.to raise_error(error_class, 'execution expired') end end end end describe '#requests_remaining?' do context 'when default requests limit is set' do before do allow(client).to receive(:requests_limit).and_return(5000) end it 'returns true if enough requests remain' do expect(client).to receive(:remaining_requests).and_return(9000) expect(client.requests_remaining?).to eq(true) end it 'returns false if not enough requests remain' do expect(client).to receive(:remaining_requests).and_return(1) expect(client.requests_remaining?).to eq(false) end end context 'when search requests limit is set' do before do allow(client).to receive(:requests_limit).and_return(described_class::SEARCH_MAX_REQUESTS_PER_MINUTE) end it 'returns true if enough requests remain' do expect(client).to receive(:remaining_requests).and_return(described_class::SEARCH_RATE_LIMIT_THRESHOLD + 1) expect(client.requests_remaining?).to eq(true) end it 'returns false if not enough requests remain' do expect(client).to receive(:remaining_requests).and_return(described_class::SEARCH_RATE_LIMIT_THRESHOLD - 1) expect(client.requests_remaining?).to eq(false) end end end describe '#raise_or_wait_for_rate_limit' do context 'when running in parallel mode' do it 'raises RateLimitError' do expect { client.raise_or_wait_for_rate_limit } .to raise_error(Gitlab::GithubImport::RateLimitError) end end context 'when running in sequential mode' do let(:parallel) { false } it 'sleeps' do expect(client).to receive(:rate_limit_resets_in).and_return(1) expect(client).to receive(:sleep).with(1) client.raise_or_wait_for_rate_limit end it 'increments the rate limit counter' do expect(client) .to receive(:rate_limit_resets_in) .and_return(1) expect(client) .to receive(:sleep) .with(1) expect(client.rate_limit_counter) .to receive(:increment) .and_call_original client.raise_or_wait_for_rate_limit end end end describe '#remaining_requests' do it 'returns the number of remaining requests' do rate_limit = double(remaining: 1) expect(client.octokit).to receive(:rate_limit).and_return(rate_limit) expect(client.remaining_requests).to eq(1) end end describe '#requests_limit' do it 'returns requests limit' do rate_limit = double(limit: 1) expect(client.octokit).to receive(:rate_limit).and_return(rate_limit) expect(client.requests_limit).to eq(1) end end describe '#rate_limit_resets_in' do it 'returns the number of seconds after which the rate limit is reset' do rate_limit = double(resets_in: 1) expect(client.octokit).to receive(:rate_limit).and_return(rate_limit) expect(client.rate_limit_resets_in).to eq(6) end end describe '#api_endpoint' do context 'without a custom endpoint configured in Omniauth' do it 'returns the default API endpoint' do expect(client) .to receive(:custom_api_endpoint) .and_return(nil) expect(client.api_endpoint).to eq('https://api.github.com') end end context 'with a custom endpoint configured in Omniauth' do it 'returns the custom endpoint' do endpoint = 'https://github.kittens.com' expect(client) .to receive(:custom_api_endpoint) .and_return(endpoint) expect(client.api_endpoint).to eq(endpoint) end end end describe '#web_endpoint' do context 'without a custom endpoint configured in Omniauth' do it 'returns the default web endpoint' do expect(client) .to receive(:custom_api_endpoint) .and_return(nil) expect(client.web_endpoint).to eq('https://github.com') end end context 'with a custom endpoint configured in Omniauth' do it 'returns the custom endpoint' do endpoint = 'https://github.kittens.com' expect(client) .to receive(:custom_api_endpoint) .and_return(endpoint) expect(client.web_endpoint).to eq(endpoint) end end end describe '#custom_api_endpoint' do context 'without a custom endpoint' do it 'returns nil' do expect(client) .to receive(:github_omniauth_provider) .and_return({}) expect(client.custom_api_endpoint).to be_nil end end context 'with a custom endpoint' do it 'returns the API endpoint' do endpoint = 'https://github.kittens.com' expect(client) .to receive(:github_omniauth_provider) .and_return({ 'args' => { 'client_options' => { 'site' => endpoint } } }) expect(client.custom_api_endpoint).to eq(endpoint) end end end describe '#default_api_endpoint' do it 'returns the default API endpoint' do client = described_class.new('foo') expect(client.default_api_endpoint).to eq('https://api.github.com') end end describe '#verify_ssl' do context 'without a custom configuration' do it 'returns true' do expect(client) .to receive(:github_omniauth_provider) .and_return({}) expect(client.verify_ssl).to eq(true) end end context 'with a custom configuration' do it 'returns the configured value' do expect(client.verify_ssl).to eq(false) end end end describe '#github_omniauth_provider' do context 'without a configured provider' do it 'returns an empty Hash' do expect(Gitlab.config.omniauth) .to receive(:providers) .and_return([]) expect(client.github_omniauth_provider).to eq({}) end end context 'with a configured provider' do it 'returns the provider details as a Hash' do hash = client.github_omniauth_provider expect(hash['name']).to eq('github') expect(hash['url']).to eq('https://github.com/') end end end describe '#rate_limiting_enabled?' do it 'returns true when using GitHub.com' do expect(client.rate_limiting_enabled?).to eq(true) end it 'returns false for GitHub enterprise installations' do expect(client) .to receive(:api_endpoint) .and_return('https://github.kittens.com/') expect(client.rate_limiting_enabled?).to eq(false) end end describe 'search' do let(:user) { { login: 'user' } } let(:org1) { { login: 'org1' } } let(:org2) { { login: 'org2' } } let(:repo1) { { full_name: 'repo1' } } let(:repo2) { { full_name: 'repo2' } } before do allow(client) .to receive(:each_object) .with(:repos, nil, { affiliation: 'collaborator' }) .and_return([repo1, repo2].to_enum) allow(client) .to receive(:each_object) .with(:organizations) .and_return([org1, org2].to_enum) allow(client.octokit).to receive(:user).and_return(user) end describe '#search_repos_by_name_graphql' do let(:expected_query) { 'test in:name is:public,private user:user repo:repo1 repo:repo2 org:org1 org:org2' } let(:expected_graphql_params) { "type: REPOSITORY, query: \"#{expected_query}\"" } let(:expected_graphql) do <<-TEXT { search(#{expected_graphql_params}) { nodes { __typename ... on Repository { id: databaseId name full_name: nameWithOwner owner { login } } } pageInfo { startCursor endCursor hasNextPage hasPreviousPage } } } TEXT end it 'searches for repositories based on name' do expect(client.octokit).to receive(:post).with( '/graphql', { query: expected_graphql }.to_json ) client.search_repos_by_name_graphql('test') end context 'when relation type option present' do context 'when relation type is owned' do let(:expected_query) { 'test in:name is:public,private user:user' } it 'searches for repositories within the organization based on name' do expect(client.octokit).to receive(:post).with( '/graphql', { query: expected_graphql }.to_json ) client.search_repos_by_name_graphql('test', relation_type: 'owned') end end context 'when relation type is organization' do let(:expected_query) { 'test in:name is:public,private org:test-login' } it 'searches for repositories within the organization based on name' do expect(client.octokit).to receive(:post).with( '/graphql', { query: expected_graphql }.to_json ) client.search_repos_by_name_graphql( 'test', relation_type: 'organization', organization_login: 'test-login' ) end end context 'when relation type is collaborated' do let(:expected_query) { 'test in:name is:public,private repo:repo1 repo:repo2' } it 'searches for collaborated repositories based on name' do expect(client.octokit).to receive(:post).with( '/graphql', { query: expected_graphql }.to_json ) client.search_repos_by_name_graphql('test', relation_type: 'collaborated') end end end context 'when pagination options present' do context 'with "first" option' do let(:expected_graphql_params) do "type: REPOSITORY, query: \"#{expected_query}\", first: 25" end it 'searches for repositories via expected query' do expect(client.octokit).to receive(:post).with( '/graphql', { query: expected_graphql }.to_json ) client.search_repos_by_name_graphql('test', { first: 25 }) end end context 'with "after" option' do let(:expected_graphql_params) do "type: REPOSITORY, query: \"#{expected_query}\", after: \"Y3Vyc29yOjE=\"" end it 'searches for repositories via expected query' do expect(client.octokit).to receive(:post).with( '/graphql', { query: expected_graphql }.to_json ) client.search_repos_by_name_graphql('test', { after: 'Y3Vyc29yOjE=' }) end end end context 'when Faraday error received from octokit', :aggregate_failures do let(:error_class) { described_class::CLIENT_CONNECTION_ERROR } let(:info_params) { { 'error.class': error_class } } it 'retries on error and succeeds' do allow_retry(:post) expect(Gitlab::Import::Logger).to receive(:info).with(hash_including(info_params)).once expect(client.search_repos_by_name_graphql('test')).to eq({}) end it 'retries and does not succeed' do allow(client.octokit) .to receive(:post) .with('/graphql', { query: expected_graphql }.to_json) .and_raise(error_class, 'execution expired') expect { client.search_repos_by_name_graphql('test') }.to raise_error(error_class, 'execution expired') end end end describe '#search_repos_by_name' do let(:expected_query) { 'test in:name is:public,private user:user repo:repo1 repo:repo2 org:org1 org:org2' } it 'searches for repositories based on name' do expect(client.octokit).to receive(:search_repositories).with(expected_query, {}) client.search_repos_by_name('test') end context 'when pagination options present' do it 'searches for repositories via expected query' do expect(client.octokit).to receive(:search_repositories).with( expected_query, { page: 2, per_page: 25 } ) client.search_repos_by_name('test', { page: 2, per_page: 25 }) end end context 'when Faraday error received from octokit', :aggregate_failures do let(:error_class) { described_class::CLIENT_CONNECTION_ERROR } let(:info_params) { { 'error.class': error_class } } it 'retries on error and succeeds' do allow_retry(:search_repositories) expect(Gitlab::Import::Logger).to receive(:info).with(hash_including(info_params)).once expect(client.search_repos_by_name('test')).to eq({}) end it 'retries and does not succeed' do allow(client.octokit) .to receive(:search_repositories) .with(expected_query, {}) .and_raise(error_class, 'execution expired') expect { client.search_repos_by_name('test') }.to raise_error(error_class, 'execution expired') end end end end def allow_retry(method = :pull_request) call_count = 0 allow(client.octokit).to receive(method) do call_count += 1 call_count > 1 ? {} : raise(described_class::CLIENT_CONNECTION_ERROR, 'execution expired') end end end