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
|
module RSpec
module Core
# @private
module MetadataHashBuilder
# @private
module Common
def build_metadata_hash_from(args)
metadata = args.last.is_a?(Hash) ? args.pop : {}
if RSpec.configuration.treat_symbols_as_metadata_keys_with_true_values?
add_symbols_to_hash(metadata, args)
else
warn_about_symbol_usage(args)
end
metadata
end
private
def add_symbols_to_hash(hash, args)
while args.last.is_a?(Symbol)
hash[args.pop] = true
end
end
def warn_about_symbol_usage(args)
symbols = args.select { |a| a.is_a?(Symbol) }
return if symbols.empty?
Kernel.warn symbol_metadata_warning(symbols)
end
end
# @private
module WithConfigWarning
include Common
private
def symbol_metadata_warning(symbols)
<<-NOTICE
*****************************************************************
WARNING: You have passed symbols (#{symbols.inspect}) as metadata
arguments to a configuration option.
In RSpec 3, these symbols will be treated as metadata keys with
a value of `true`. To get this behavior now (and prevent this
warning), you can set a configuration option:
RSpec.configure do |c|
c.treat_symbols_as_metadata_keys_with_true_values = true
end
Note that this config setting should go before your other config
settings so that they can use symbols as metadata.
*****************************************************************
NOTICE
end
end
# @private
module WithDeprecationWarning
include Common
private
def symbol_metadata_warning(symbols)
<<-NOTICE
*****************************************************************
DEPRECATION WARNING: you are using deprecated behaviour that will
be removed from RSpec 3.
You have passed symbols (#{symbols.inspect}) as additional
arguments for a doc string.
In RSpec 3, these symbols will be treated as metadata keys with
a value of `true`. To get this behavior now (and prevent this
warning), you can set a configuration option:
RSpec.configure do |c|
c.treat_symbols_as_metadata_keys_with_true_values = true
end
Alternately, if your intention is to use the symbol as part of the
doc string (i.e. to specify a method name), you can change it to
a string such as "#method_name" to remove this warning.
*****************************************************************
NOTICE
end
end
end
end
end
|
