blob: 84ffca14e623797f16d3a3dca6ae74b79608da64 (
plain)
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
|
# frozen_string_literal: true
RSpec.describe "bundle commands" do
it "expects all commands to have a man page" do
Bundler::CLI.all_commands.each_key do |command_name|
next if command_name == "cli_help"
expect(man_page(command_name)).to exist
end
end
it "expects all commands to have all options documented" do
Bundler::CLI.all_commands.each do |command_name, command|
next if command_name == "cli_help"
man_page_content = man_page(command_name).read
command.options.each do |_, option|
aliases = option.aliases
formatted_aliases = aliases.sort.map {|name| "`#{name}`" }.join(", ") if aliases
help = if option.type == :boolean
"* #{append_aliases("`#{option.switch_name}`", formatted_aliases)}:"
elsif option.enum
formatted_aliases = "`#{option.switch_name}`" if aliases.empty? && option.lazy_default
"* #{prepend_aliases(option.enum.sort.map {|enum| "`#{option.switch_name}=#{enum}`" }.join(", "), formatted_aliases)}:"
else
names = [option.switch_name, *aliases]
value =
case option.type
when :array then "<list>"
when :numeric then "<number>"
else option.name.upcase
end
value = option.type != :numeric && option.lazy_default ? "[=#{value}]" : "=#{value}"
"* #{names.map {|name| "`#{name}#{value}`" }.join(", ")}:"
end
expect(man_page_content).to include(help)
end
end
end
private
def append_aliases(text, aliases)
return text if aliases.empty?
"#{text}, #{aliases}"
end
def prepend_aliases(text, aliases)
return text if aliases.empty?
"#{aliases}, #{text}"
end
def man_page(command_name)
source_root.join("lib/bundler/man/bundle-#{command_name}.1.ronn")
end
end
|
