mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
df7dac9174
RDoc 4.1.0 contains a number of enhancements including a new default style and accessibility support. You can see the changelog here: https://github.com/rdoc/rdoc/blob/v4.1.0.preview.1/History.rdoc * test/rdoc: ditto. git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@42971 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
315 lines
8.5 KiB
Ruby
315 lines
8.5 KiB
Ruby
require 'rdoc/test_case'
|
|
|
|
class TestRDocParserChangeLog < RDoc::TestCase
|
|
|
|
def setup
|
|
super
|
|
|
|
@tempfile = Tempfile.new 'ChangeLog'
|
|
@top_level = @store.add_file @tempfile.path
|
|
@options = RDoc::Options.new
|
|
@stats = RDoc::Stats.new @store, 0
|
|
end
|
|
|
|
def teardown
|
|
@tempfile.close
|
|
end
|
|
|
|
def test_class_can_parse
|
|
parser = RDoc::Parser::ChangeLog
|
|
|
|
temp_dir do
|
|
FileUtils.touch 'ChangeLog'
|
|
assert_equal parser, parser.can_parse('ChangeLog')
|
|
|
|
assert_equal parser, parser.can_parse(@tempfile.path)
|
|
|
|
FileUtils.touch 'ChangeLog.rb'
|
|
assert_equal RDoc::Parser::Ruby, parser.can_parse('ChangeLog.rb')
|
|
end
|
|
end
|
|
|
|
def test_continue_entry_body
|
|
parser = util_parser
|
|
|
|
entry_body = ['a']
|
|
|
|
parser.continue_entry_body entry_body, 'b'
|
|
|
|
assert_equal ['a b'], entry_body
|
|
end
|
|
|
|
def test_continue_entry_body_empty
|
|
parser = util_parser
|
|
|
|
entry_body = []
|
|
|
|
parser.continue_entry_body entry_body, ''
|
|
|
|
assert_empty entry_body
|
|
end
|
|
|
|
def test_continue_entry_body_function
|
|
parser = util_parser
|
|
|
|
entry_body = ['file: (func1)']
|
|
|
|
parser.continue_entry_body entry_body, '(func2): blah'
|
|
|
|
assert_equal ['file: (func1, func2): blah'], entry_body
|
|
end
|
|
|
|
def test_create_document
|
|
parser = util_parser
|
|
|
|
groups = {
|
|
'2012-12-04' => [
|
|
['Tue Dec 4 08:33:46 2012 Eric Hodel <drbrain@segment7.net>',
|
|
%w[a:one b:two]],
|
|
['Tue Dec 4 08:32:10 2012 Eric Hodel <drbrain@segment7.net>',
|
|
%w[c:three d:four]]],
|
|
'2012-12-03' => [
|
|
['Mon Dec 3 20:28:02 2012 Koichi Sasada <ko1@atdot.net>',
|
|
%w[e:five f:six]]],
|
|
}
|
|
|
|
expected =
|
|
doc(
|
|
head(1, File.basename(@tempfile.path)),
|
|
blank_line,
|
|
head(2, '2012-12-04'),
|
|
blank_line,
|
|
head(3, 'Tue Dec 4 08:33:46 2012 Eric Hodel <drbrain@segment7.net>'),
|
|
blank_line,
|
|
list(:NOTE, item('a', para('one')), item('b', para('two'))),
|
|
head(3, 'Tue Dec 4 08:32:10 2012 Eric Hodel <drbrain@segment7.net>'),
|
|
blank_line,
|
|
list(:NOTE, item('c', para('three')), item('d', para('four'))),
|
|
head(2, '2012-12-03'),
|
|
blank_line,
|
|
head(3, 'Mon Dec 3 20:28:02 2012 Koichi Sasada <ko1@atdot.net>'),
|
|
blank_line,
|
|
list(:NOTE, item('e', para('five')), item('f', para('six'))))
|
|
|
|
expected.file = @top_level
|
|
|
|
document = parser.create_document(groups)
|
|
|
|
assert_equal expected, document
|
|
|
|
assert_equal 2, document.omit_headings_below
|
|
|
|
headings = document.parts.select do |part|
|
|
RDoc::Markup::Heading === part and part.level == 2
|
|
end
|
|
|
|
refute headings.all? { |heading| heading.text.frozen? }
|
|
end
|
|
|
|
def test_create_entries
|
|
parser = util_parser
|
|
|
|
entries = [
|
|
['Tue Dec 1 02:03:04 2012 Eric Hodel <drbrain@segment7.net>',
|
|
%w[a:one b:two]],
|
|
['Tue Dec 5 06:07:08 2012 Eric Hodel <drbrain@segment7.net>',
|
|
%w[c:three d:four]],
|
|
]
|
|
|
|
expected = [
|
|
head(3, 'Tue Dec 1 02:03:04 2012 Eric Hodel <drbrain@segment7.net>'),
|
|
blank_line,
|
|
list(:NOTE, item('a', para('one')), item('b', para('two'))),
|
|
head(3, 'Tue Dec 5 06:07:08 2012 Eric Hodel <drbrain@segment7.net>'),
|
|
blank_line,
|
|
list(:NOTE, item('c', para('three')), item('d', para('four'))),
|
|
]
|
|
|
|
entries = parser.create_entries(entries)
|
|
assert_equal expected, entries
|
|
end
|
|
|
|
def test_create_entries_colons
|
|
parser = util_parser
|
|
|
|
entries = [
|
|
['Wed Dec 5 12:17:11 2012 Naohisa Goto <ngotogenome@gmail.com>',
|
|
['func.rb (DL::Function#bind): log stuff [ruby-core:50562]']],
|
|
]
|
|
|
|
expected = [
|
|
head(3,
|
|
'Wed Dec 5 12:17:11 2012 Naohisa Goto <ngotogenome@gmail.com>'),
|
|
blank_line,
|
|
list(:NOTE,
|
|
item('func.rb (DL::Function#bind)',
|
|
para('log stuff [ruby-core:50562]')))]
|
|
|
|
assert_equal expected, parser.create_entries(entries)
|
|
end
|
|
|
|
def test_create_items
|
|
parser = util_parser
|
|
|
|
items = [
|
|
'README.EXT: Converted to RDoc format',
|
|
'README.EXT.ja: ditto',
|
|
]
|
|
|
|
expected =
|
|
list(:NOTE,
|
|
item('README.EXT',
|
|
para('Converted to RDoc format')),
|
|
item('README.EXT.ja',
|
|
para('ditto')))
|
|
|
|
assert_equal expected, parser.create_items(items)
|
|
end
|
|
|
|
def test_group_entries
|
|
parser = util_parser
|
|
|
|
entries = [
|
|
[ 'Tue Dec 4 08:33:46 2012 Eric Hodel <drbrain@segment7.net>',
|
|
%w[one two]],
|
|
[ 'Tue Dec 4 08:32:10 2012 Eric Hodel <drbrain@segment7.net>',
|
|
%w[three four]],
|
|
[ 'Mon Dec 3 20:28:02 2012 Koichi Sasada <ko1@atdot.net>',
|
|
%w[five six]],
|
|
[ '2008-01-30 H.J. Lu <hongjiu.lu@intel.com>',
|
|
%w[seven eight]]]
|
|
|
|
expected = {
|
|
'2012-12-04' => [
|
|
['Tue Dec 4 08:33:46 2012 Eric Hodel <drbrain@segment7.net>',
|
|
%w[one two]],
|
|
['Tue Dec 4 08:32:10 2012 Eric Hodel <drbrain@segment7.net>',
|
|
%w[three four]]],
|
|
'2012-12-03' => [
|
|
['Mon Dec 3 20:28:02 2012 Koichi Sasada <ko1@atdot.net>',
|
|
%w[five six]]],
|
|
'2008-01-30' => [
|
|
['2008-01-30 H.J. Lu <hongjiu.lu@intel.com>',
|
|
%w[seven eight]]],
|
|
}
|
|
|
|
assert_equal expected, parser.group_entries(entries)
|
|
end
|
|
|
|
def test_parse_entries
|
|
parser = util_parser <<-ChangeLog
|
|
Tue Dec 4 08:33:46 2012 Eric Hodel <drbrain@segment7.net>
|
|
|
|
* README.EXT: Converted to RDoc format
|
|
* README.EXT.ja: ditto
|
|
|
|
Mon Dec 3 20:28:02 2012 Koichi Sasada <ko1@atdot.net>
|
|
|
|
* compile.c (iseq_specialized_instruction):
|
|
change condition of using `opt_send_simple'.
|
|
More method invocations can be simple.
|
|
|
|
Other note that will be ignored
|
|
|
|
ChangeLog
|
|
|
|
expected = [
|
|
[ 'Tue Dec 4 08:33:46 2012 Eric Hodel <drbrain@segment7.net>',
|
|
[ 'README.EXT: Converted to RDoc format',
|
|
'README.EXT.ja: ditto']],
|
|
[ 'Mon Dec 3 20:28:02 2012 Koichi Sasada <ko1@atdot.net>',
|
|
[ 'compile.c (iseq_specialized_instruction): change condition of ' +
|
|
'using `opt_send_simple\'. More method invocations can be simple.']]]
|
|
|
|
assert_equal expected, parser.parse_entries
|
|
end
|
|
|
|
def test_parse_entries_bad_time
|
|
parser = util_parser <<-ChangeLog
|
|
2008-01-30 H.J. Lu <hongjiu.lu@intel.com>
|
|
|
|
PR libffi/34612
|
|
* src/x86/sysv.S (ffi_closure_SYSV): Pop 4 byte from stack when
|
|
returning struct.
|
|
|
|
ChangeLog
|
|
|
|
expected = [
|
|
[ '2008-01-30 H.J. Lu <hongjiu.lu@intel.com>',
|
|
[ 'src/x86/sysv.S (ffi_closure_SYSV): Pop 4 byte from stack when ' +
|
|
'returning struct.']]
|
|
]
|
|
|
|
assert_equal expected, parser.parse_entries
|
|
end
|
|
|
|
def test_parse_entries_gnu
|
|
parser = util_parser <<-ChangeLog
|
|
1998-08-17 Richard Stallman <rms@gnu.org>
|
|
|
|
* register.el (insert-register): Return nil.
|
|
(jump-to-register): Likewise.
|
|
|
|
* sort.el (sort-subr): Return nil.
|
|
|
|
* keyboard.c (menu_bar_items, tool_bar_items)
|
|
(Fexecute_extended_command): Deal with 'keymap' property.
|
|
ChangeLog
|
|
|
|
expected = [
|
|
[ '1998-08-17 Richard Stallman <rms@gnu.org>',
|
|
[ 'register.el (insert-register): Return nil.',
|
|
'(jump-to-register): Likewise.',
|
|
'sort.el (sort-subr): Return nil.',
|
|
'keyboard.c (menu_bar_items, tool_bar_items, ' +
|
|
'Fexecute_extended_command): Deal with \'keymap\' property.']]]
|
|
|
|
assert_equal expected, parser.parse_entries
|
|
end
|
|
|
|
def test_scan
|
|
parser = util_parser <<-ChangeLog
|
|
Tue Dec 4 08:32:10 2012 Eric Hodel <drbrain@segment7.net>
|
|
|
|
* lib/rdoc/ri/driver.rb: Fixed ri page display for files with
|
|
extensions.
|
|
* test/rdoc/test_rdoc_ri_driver.rb: Test for above
|
|
|
|
Mon Dec 3 20:37:22 2012 Koichi Sasada <ko1@atdot.net>
|
|
|
|
* vm_exec.c: check VM_COLLECT_USAGE_DETAILS.
|
|
|
|
ChangeLog
|
|
|
|
parser.scan
|
|
|
|
expected = doc(
|
|
head(1, File.basename(@tempfile.path)),
|
|
blank_line,
|
|
head(2, '2012-12-04'),
|
|
blank_line,
|
|
head(3, 'Tue Dec 4 08:32:10 2012 Eric Hodel <drbrain@segment7.net>'),
|
|
blank_line,
|
|
list(:NOTE,
|
|
item('lib/rdoc/ri/driver.rb', para('Fixed ri page display for ' +
|
|
'files with extensions.')),
|
|
item('test/rdoc/test_rdoc_ri_driver.rb', para('Test for above'))),
|
|
head(2, '2012-12-03'),
|
|
blank_line,
|
|
head(3, 'Mon Dec 3 20:37:22 2012 Koichi Sasada <ko1@atdot.net>'),
|
|
blank_line,
|
|
list(:NOTE,
|
|
item('vm_exec.c', para('check VM_COLLECT_USAGE_DETAILS.'))))
|
|
|
|
expected.file = @top_level
|
|
|
|
assert_equal expected, @top_level.comment
|
|
end
|
|
|
|
def util_parser content = ''
|
|
RDoc::Parser::ChangeLog.new \
|
|
@top_level, @tempfile.path, content, @options, @stats
|
|
end
|
|
|
|
end
|
|
|