1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106
|
# frozen_string_literal: true
RSpec.describe YARD::Verifier do
describe "#parse_expressions" do
it "creates #__execute method" do
v = Verifier.new("expr1")
expect(v).to respond_to(:__execute)
end
it "parses @tagname into tag('tagname')" do
obj = double(:object)
expect(obj).to receive(:tag).with('return')
Verifier.new('@return').call(obj)
end
it "parses @@tagname into object.tags('tagname')" do
obj = double(:object)
expect(obj).to receive(:tags).with('return')
Verifier.new('@@return').call(obj)
end
it "allows namespaced tag using @{} syntax" do
obj = double(:object)
expect(obj).to receive(:tag).with('yard.return')
Verifier.new('@{yard.return}').call(obj)
end
it "allows namespaced tags using @{} syntax" do
obj = double(:object)
expect(obj).to receive(:tags).with('yard.return')
Verifier.new('@@{yard.return}').call(obj)
end
it "calls methods on tag object" do
obj = double(:object)
obj2 = double(:tag)
expect(obj).to receive(:tag).with('return').and_return obj2
expect(obj2).to receive(:foo)
Verifier.new('@return.foo').call(obj)
end
it "sends any missing methods to object" do
obj = double(:object)
expect(obj).to receive(:has_tag?).with('return')
Verifier.new('has_tag?("return")').call(obj)
end
it "allows multiple expressions" do
obj = double(:object)
expect(obj).to receive(:tag).with('return').and_return(true)
expect(obj).to receive(:tag).with('param').and_return(false)
expect(Verifier.new('@return', '@param').call(obj)).to be false
end
end
describe "#o" do
it "aliases object to o" do
obj = double(:object)
expect(obj).to receive(:a).ordered
Verifier.new('o.a').call(obj)
end
end
describe "#call" do
it "doubles a nonexistent tag so that exceptions are not raised" do
obj = double(:object)
expect(obj).to receive(:tag).and_return(nil)
expect(Verifier.new('@return.text').call(obj)).to be false
end
it "does not fail if no expressions were added" do
expect { Verifier.new.call(nil) }.not_to raise_error
end
it "always ignores proxy objects and return true" do
v = Verifier.new('tag(:x)')
expect { expect(v.call(P('foo'))).to be true }.not_to raise_error
end
end
describe "#expressions" do
it "maintains a list of all unparsed expressions" do
expect(Verifier.new('@return.text', '@private').expressions).to eq ['@return.text', '@private']
end
end
describe "#expressions=" do
it "recompiles expressions when attribute is modified" do
obj = double(:object)
expect(obj).to receive(:tag).with('return')
v = Verifier.new
v.expressions = ['@return']
v.call(obj)
end
end
describe "#add_expressions" do
it "adds new expressions and recompile" do
obj = double(:object)
expect(obj).to receive(:tag).with('return')
v = Verifier.new
v.add_expressions '@return'
v.call(obj)
end
end
end
|