2014-09-02 18:07:02 +05:30
|
|
|
# Specifications for behavior common to all Mentionable implementations.
|
|
|
|
# Requires a shared context containing:
|
2015-09-11 14:41:01 +05:30
|
|
|
# - subject { "the mentionable implementation" }
|
2014-09-02 18:07:02 +05:30
|
|
|
# - let(:backref_text) { "the way that +subject+ should refer to itself in backreferences " }
|
|
|
|
# - let(:set_mentionable_text) { lambda { |txt| "block that assigns txt to the subject's mentionable_text" } }
|
|
|
|
|
2015-12-23 02:04:40 +05:30
|
|
|
shared_context 'mentionable context' do
|
2015-10-24 18:46:33 +05:30
|
|
|
let(:project) { subject.project }
|
2015-09-11 14:41:01 +05:30
|
|
|
let(:author) { subject.author }
|
2014-09-02 18:07:02 +05:30
|
|
|
|
2015-09-11 14:41:01 +05:30
|
|
|
let(:mentioned_issue) { create(:issue, project: project) }
|
2016-11-03 12:29:30 +05:30
|
|
|
let!(:mentioned_mr) { create(:merge_request, source_project: project) }
|
2015-12-23 02:04:40 +05:30
|
|
|
let(:mentioned_commit) { project.commit("HEAD~1") }
|
2014-09-02 18:07:02 +05:30
|
|
|
|
2017-08-17 22:00:37 +05:30
|
|
|
let(:ext_proj) { create(:project, :public, :repository) }
|
2015-09-11 14:41:01 +05:30
|
|
|
let(:ext_issue) { create(:issue, project: ext_proj) }
|
|
|
|
let(:ext_mr) { create(:merge_request, :simple, source_project: ext_proj) }
|
2015-12-23 02:04:40 +05:30
|
|
|
let(:ext_commit) { ext_proj.commit("HEAD~2") }
|
2015-04-26 12:48:37 +05:30
|
|
|
|
2014-09-02 18:07:02 +05:30
|
|
|
# Override to add known commits to the repository stub.
|
|
|
|
let(:extra_commits) { [] }
|
|
|
|
|
|
|
|
# A string that mentions each of the +mentioned_.*+ objects above. Mentionables should add a self-reference
|
|
|
|
# to this string and place it in their +mentionable_text+.
|
|
|
|
let(:ref_string) do
|
2015-09-11 14:41:01 +05:30
|
|
|
<<-MSG.strip_heredoc
|
|
|
|
These references are new:
|
|
|
|
Issue: #{mentioned_issue.to_reference}
|
|
|
|
Merge: #{mentioned_mr.to_reference}
|
|
|
|
Commit: #{mentioned_commit.to_reference}
|
|
|
|
|
|
|
|
This reference is a repeat and should only be mentioned once:
|
|
|
|
Repeat: #{mentioned_issue.to_reference}
|
|
|
|
|
|
|
|
These references are cross-referenced:
|
|
|
|
Issue: #{ext_issue.to_reference(project)}
|
|
|
|
Merge: #{ext_mr.to_reference(project)}
|
|
|
|
Commit: #{ext_commit.to_reference(project)}
|
|
|
|
|
|
|
|
This is a self-reference and should not be mentioned at all:
|
|
|
|
Self: #{backref_text}
|
|
|
|
MSG
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
|
|
|
|
before do
|
2015-09-11 14:41:01 +05:30
|
|
|
# Wire the project's repository to return the mentioned commit, and +nil+
|
|
|
|
# for any unrecognized commits.
|
2015-12-23 02:04:40 +05:30
|
|
|
allow_any_instance_of(::Repository).to receive(:commit).and_call_original
|
|
|
|
allow_any_instance_of(::Repository).to receive(:commit).with(mentioned_commit.short_id).and_return(mentioned_commit)
|
|
|
|
extra_commits.each do |commit|
|
|
|
|
allow_any_instance_of(::Repository).to receive(:commit).with(commit.short_id).and_return(commit)
|
|
|
|
end
|
2015-09-11 14:41:01 +05:30
|
|
|
|
2014-09-02 18:07:02 +05:30
|
|
|
set_mentionable_text.call(ref_string)
|
2016-06-02 11:05:42 +05:30
|
|
|
|
|
|
|
project.team << [author, :developer]
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
shared_examples 'a mentionable' do
|
2015-12-23 02:04:40 +05:30
|
|
|
include_context 'mentionable context'
|
2014-09-02 18:07:02 +05:30
|
|
|
|
|
|
|
it 'generates a descriptive back-reference' do
|
2015-04-26 12:48:37 +05:30
|
|
|
expect(subject.gfm_reference).to eq(backref_text)
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
|
|
|
|
it "extracts references from its reference property" do
|
|
|
|
# De-duplicate and omit itself
|
2015-10-24 18:46:33 +05:30
|
|
|
refs = subject.referenced_mentionables
|
2015-04-26 12:48:37 +05:30
|
|
|
expect(refs.size).to eq(6)
|
|
|
|
expect(refs).to include(mentioned_issue)
|
|
|
|
expect(refs).to include(mentioned_mr)
|
|
|
|
expect(refs).to include(mentioned_commit)
|
|
|
|
expect(refs).to include(ext_issue)
|
|
|
|
expect(refs).to include(ext_mr)
|
|
|
|
expect(refs).to include(ext_commit)
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
|
|
|
|
it 'creates cross-reference notes' do
|
2015-04-26 12:48:37 +05:30
|
|
|
mentioned_objects = [mentioned_issue, mentioned_mr, mentioned_commit,
|
|
|
|
ext_issue, ext_mr, ext_commit]
|
|
|
|
|
|
|
|
mentioned_objects.each do |referenced|
|
2015-09-11 14:41:01 +05:30
|
|
|
expect(SystemNoteService).to receive(:cross_reference).
|
|
|
|
with(referenced, subject.local_reference, author)
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
|
2015-10-24 18:46:33 +05:30
|
|
|
subject.create_cross_references!
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
shared_examples 'an editable mentionable' do
|
2015-12-23 02:04:40 +05:30
|
|
|
include_context 'mentionable context'
|
2014-09-02 18:07:02 +05:30
|
|
|
|
|
|
|
it_behaves_like 'a mentionable'
|
|
|
|
|
2015-09-11 14:41:01 +05:30
|
|
|
let(:new_issues) do
|
|
|
|
[create(:issue, project: project), create(:issue, project: ext_proj)]
|
|
|
|
end
|
|
|
|
|
2014-09-02 18:07:02 +05:30
|
|
|
it 'creates new cross-reference notes when the mentionable text is edited' do
|
2015-09-11 14:41:01 +05:30
|
|
|
subject.save
|
2016-11-03 12:29:30 +05:30
|
|
|
subject.create_cross_references!
|
2015-09-11 14:41:01 +05:30
|
|
|
|
|
|
|
new_text = <<-MSG.strip_heredoc
|
|
|
|
These references already existed:
|
|
|
|
|
|
|
|
Issue: #{mentioned_issue.to_reference}
|
|
|
|
|
|
|
|
Commit: #{mentioned_commit.to_reference}
|
2015-04-26 12:48:37 +05:30
|
|
|
|
2015-09-11 14:41:01 +05:30
|
|
|
---
|
|
|
|
|
|
|
|
This cross-project reference already existed:
|
|
|
|
|
|
|
|
Issue: #{ext_issue.to_reference(project)}
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
These two references are introduced in an edit:
|
|
|
|
|
|
|
|
Issue: #{new_issues[0].to_reference}
|
|
|
|
|
|
|
|
Cross: #{new_issues[1].to_reference(project)}
|
|
|
|
MSG
|
|
|
|
|
|
|
|
# These three objects were already referenced, and should not receive new
|
|
|
|
# notes
|
2015-04-26 12:48:37 +05:30
|
|
|
[mentioned_issue, mentioned_commit, ext_issue].each do |oldref|
|
2015-09-11 14:41:01 +05:30
|
|
|
expect(SystemNoteService).not_to receive(:cross_reference).
|
|
|
|
with(oldref, any_args)
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
|
2015-09-11 14:41:01 +05:30
|
|
|
# These two issues are new and should receive reference notes
|
2016-11-03 12:29:30 +05:30
|
|
|
# In the case of MergeRequests remember that cannot mention commits included in the MergeRequest
|
2015-09-11 14:41:01 +05:30
|
|
|
new_issues.each do |newref|
|
|
|
|
expect(SystemNoteService).to receive(:cross_reference).
|
|
|
|
with(newref, subject.local_reference, author)
|
2015-04-26 12:48:37 +05:30
|
|
|
end
|
2014-09-02 18:07:02 +05:30
|
|
|
|
|
|
|
set_mentionable_text.call(new_text)
|
2015-10-24 18:46:33 +05:30
|
|
|
subject.create_new_cross_references!(author)
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
end
|