1→# frozen_string_literal: true 2→ 3→require "test_helper" 4→ 5→class TestParser < Minitest::Test 6→ def test_version_number 7→ refute_nil Changelog::Parser::VERSION 8→ end 9→ 10→ def test_parse_empty_changelog 11→ result = Changelog::Parser.parse("") 12→ assert_equal({}, result) 13→ end 14→ 15→ def test_parse_nil_changelog 16→ result = Changelog::Parser.parse(nil) 17→ assert_equal({}, result) 18→ end 19→end 20→ 21→class TestKeepAChangelogFormat < Minitest::Test 22→ def setup 23→ @changelog = File.read(fixture_path("keep_a_changelog.md")) 24→ @parser = Changelog::Parser.new(@changelog) 25→ end 26→ 27→ def test_detects_keep_a_changelog_format 28→ assert_equal Changelog::Parser::KEEP_A_CHANGELOG, @parser.version_pattern 29→ end 30→ 31→ def test_parses_all_versions 32→ result = @parser.parse 33→ assert_equal 4, result.size 34→ assert_includes result.keys, "Unreleased" 35→ assert_includes result.keys, "1.1.0" 36→ assert_includes result.keys, "1.0.1" 37→ assert_includes result.keys, "1.0.0" 38→ end 39→ 40→ def test_extracts_dates 41→ result = @parser.parse 42→ assert_nil result["Unreleased"][:date] 43→ assert_equal Date.new(2024, 3, 15), result["1.1.0"][:date] 44→ assert_equal Date.new(2024, 2, 1), result["1.0.1"][:date] 45→ assert_equal Date.new(2024, 1, 15), result["1.0.0"][:date] 46→ end 47→ 48→ def test_extracts_content 49→ result = @parser.parse 50→ assert_includes result["1.1.0"][:content], "User authentication system" 51→ assert_includes result["1.1.0"][:content], "Memory leak in connection pool" 52→ assert_includes result["1.0.0"][:content], "Initial release" 53→ end 54→ 55→ def test_versions_method 56→ assert_equal ["Unreleased", "1.1.0", "1.0.1", "1.0.0"], @parser.versions 57→ end 58→ 59→ def test_bracket_accessor 60→ entry = @parser["1.0.1"] 61→ assert_equal Date.new(2024, 2, 1), entry[:date] 62→ assert_includes entry[:content], "Critical bug" 63→ end 64→ 65→ def test_to_h 66→ assert_equal @parser.parse, @parser.to_h 67→ end 68→ 69→ def test_to_json 70→ json = @parser.to_json 71→ parsed = JSON.parse(json) 72→ assert_equal 4, parsed.size 73→ assert_includes parsed.keys, "1.0.0" 74→ end 75→end 76→ 77→class TestMarkdownHeaderFormat < Minitest::Test 78→ def setup 79→ @changelog = File.read(fixture_path("markdown_header.md")) 80→ @parser = Changelog::Parser.new(@changelog, format: :markdown) 81→ end 82→ 83→ def test_parses_versions_with_parenthesized_dates 84→ result = @parser.parse 85→ assert_includes result.keys, "2.0.0" 86→ assert_equal Date.new(2024, 3, 1), result["2.0.0"][:date] 87→ end 88→ 89→ def test_parses_versions_without_dates 90→ result = @parser.parse 91→ assert_includes result.keys, "1.5.0" 92→ assert_nil result["1.5.0"][:date] 93→ end 94→ 95→ def test_parses_h3_headers 96→ result = @parser.parse 97→ assert_includes result.keys, "1.4.2" 98→ end 99→ 100→ def test_extracts_content_correctly 101→ result = @parser.parse 102→ assert_includes result["2.0.0"][:content], "Breaking changes" 103→ assert_includes result["1.5.0"][:content], "caching layer" 104→ end 105→end 106→ 107→class TestUnderlineFormat < Minitest::Test 108→ def setup 109→ @changelog = File.read(fixture_path("underline.md")) 110→ @parser = Changelog::Parser.new(@changelog, format: :underline) 111→ end 112→ 113→ def test_parses_equals_underline 114→ result = @parser.parse 115→ assert_includes result.keys, "3.0.0" 116→ assert_includes result.keys, "2.0.0" 117→ end 118→ 119→ def test_parses_dash_underline 120→ result = @parser.parse 121→ assert_includes result.keys, "2.1.0" 122→ end 123→ 124→ def test_extracts_content 125→ result = @parser.parse 126→ assert_includes result["3.0.0"][:content], "Complete rewrite" 127→ assert_includes result["2.1.0"][:content], "Bug fixes" 128→ end 129→end 130→ 131→class TestCustomPattern < Minitest::Test 132→ def test_custom_regex_pattern 133→ changelog = <<~CHANGELOG 134→ Version 1.2.0 released 2024-01-01 135→ - Feature A 136→ 137→ Version 1.1.0 released 2023-12-01 138→ - Feature B 139→ CHANGELOG 140→ 141→ pattern = /^Version ([\d.]+) released (\d{4}-\d{2}-\d{2})/ 142→ parser = Changelog::Parser.new(changelog, version_pattern: pattern) 143→ result = parser.parse 144→ 145→ assert_equal 2, result.size 146→ assert_includes result.keys, "1.2.0" 147→ assert_includes result.keys, "1.1.0" 148→ assert_equal Date.new(2024, 1, 1), result["1.2.0"][:date] 149→ end 150→ 151→ def test_custom_match_group 152→ changelog = <<~CHANGELOG 153→ ## Release v1.0.0 154→ 155→ Content here 156→ 157→ ## Release v0.9.0 158→ 159→ More content 160→ CHANGELOG 161→ 162→ pattern = /^## Release v([\d.]+)/ 163→ parser = Changelog::Parser.new(changelog, version_pattern: pattern) 164→ result = parser.parse 165→ 166→ assert_equal 2, result.size 167→ assert_includes result.keys, "1.0.0" 168→ assert_includes result.keys, "0.9.0" 169→ end 170→end 171→ 172→class TestClassMethods < Minitest::Test 173→ def test_parse_class_method 174→ changelog = "## [1.0.0] - 2024-01-01\n\nContent" 175→ result = Changelog::Parser.parse(changelog) 176→ 177→ assert_equal 1, result.size 178→ assert_includes result.keys, "1.0.0" 179→ end 180→ 181→ def test_parse_file_class_method 182→ result = Changelog::Parser.parse_file(fixture_path("keep_a_changelog.md")) 183→ 184→ assert_equal 4, result.size 185→ assert_includes result.keys, "1.0.0" 186→ end 187→end 188→ 189→class TestToHtml < Minitest::Test 190→ def setup 191→ @changelog = "## [1.0.0] - 2024-01-01\n\n- Feature one\n- Feature two" 192→ @parser = Changelog::Parser.new(@changelog) 193→ end 194→ 195→ def test_to_html_raises_without_markdown_gem 196→ skip if markdown_gem_available? 197→ 198→ assert_raises(Changelog::Parser::Error) do 199→ @parser.to_html 200→ end 201→ end 202→ 203→ def test_to_html_returns_hash_structure_with_markdown_gem 204→ skip unless markdown_gem_available? 205→ 206→ result = @parser.to_html 207→ assert_instance_of Hash, result["1.0.0"] 208→ assert result["1.0.0"].key?(:date) 209→ assert result["1.0.0"].key?(:content) 210→ end 211→ 212→ def test_to_html_converts_markdown_with_markdown_gem 213→ skip unless markdown_gem_available? 214→ 215→ result = @parser.to_html 216→ assert_includes result["1.0.0"][:content], "

" 217→ end 218→ 219→ def test_to_html_preserves_date 220→ skip unless markdown_gem_available? 221→ 222→ result = @parser.to_html 223→ assert_equal Date.new(2024, 1, 1), result["1.0.0"][:date] 224→ end 225→ 226→ def markdown_gem_available? 227→ defined?(Commonmarker) || defined?(CommonMarker) || defined?(Redcarpet) || defined?(Kramdown) 228→ end 229→end 230→ 231→class TestFormatDetection < Minitest::Test 232→ def test_auto_detects_keep_a_changelog 233→ changelog = "## [1.0.0] - 2024-01-01\n\nContent" 234→ parser = Changelog::Parser.new(changelog) 235→ assert_equal Changelog::Parser::KEEP_A_CHANGELOG, parser.version_pattern 236→ end 237→ 238→ def test_auto_detects_underline_format 239→ changelog = "1.0.0\n=====\n\nContent" 240→ parser = Changelog::Parser.new(changelog) 241→ assert_equal Changelog::Parser::UNDERLINE_HEADER, parser.version_pattern 242→ end 243→ 244→ def test_falls_back_to_markdown_header 245→ changelog = "## 1.0.0\n\nContent" 246→ parser = Changelog::Parser.new(changelog) 247→ assert_equal Changelog::Parser::MARKDOWN_HEADER, parser.version_pattern 248→ end 249→end 250→ 251→class TestLineForVersion < Minitest::Test 252→ def test_finds_keep_a_changelog_version 253→ changelog = "## [1.0.0] - 2024-01-01\n\nContent" 254→ parser = Changelog::Parser.new(changelog) 255→ 256→ assert_equal 0, parser.line_for_version("1.0.0") 257→ end 258→ 259→ def test_finds_version_with_v_prefix 260→ changelog = "## v1.0.0\n\nContent" 261→ parser = Changelog::Parser.new(changelog) 262→ 263→ assert_equal 0, parser.line_for_version("v1.0.0") 264→ assert_equal 0, parser.line_for_version("1.0.0") 265→ end 266→ 267→ def test_avoids_version_substring_match 268→ changelog = <<~CHANGELOG 269→ ## [1.0.10] - 2024-02-01 270→ 271→ Content for 1.0.10 272→ 273→ ## [1.0.1] - 2024-01-01 274→ 275→ Content for 1.0.1 276→ CHANGELOG 277→ 278→ parser = Changelog::Parser.new(changelog) 279→ assert_equal 0, parser.line_for_version("1.0.10") 280→ assert_equal 4, parser.line_for_version("1.0.1") 281→ end 282→ 283→ def test_avoids_version_range_match 284→ changelog = "Supports versions 1.0.0..2.0.0\n\n## [1.0.0]\n\nContent" 285→ parser = Changelog::Parser.new(changelog) 286→ 287→ assert_equal 2, parser.line_for_version("1.0.0") 288→ end 289→ 290→ def test_finds_underlined_version 291→ changelog = "1.0.0\n=====\n\nContent" 292→ parser = Changelog::Parser.new(changelog) 293→ 294→ assert_equal 0, parser.line_for_version("1.0.0") 295→ end 296→ 297→ def test_finds_bullet_point_version 298→ changelog = "- version 1.0.0\n\nContent" 299→ parser = Changelog::Parser.new(changelog) 300→ 301→ assert_equal 0, parser.line_for_version("1.0.0") 302→ end 303→ 304→ def test_finds_colon_version 305→ changelog = "1.0.0: Initial release\n\nContent" 306→ parser = Changelog::Parser.new(changelog) 307→ 308→ assert_equal 0, parser.line_for_version("1.0.0") 309→ end 310→ 311→ def test_returns_nil_for_missing_version 312→ changelog = "## [1.0.0] - 2024-01-01\n\nContent" 313→ parser = Changelog::Parser.new(changelog) 314→ 315→ assert_nil parser.line_for_version("2.0.0") 316→ end 317→end 318→ 319→class TestBetween < Minitest::Test 320→ def setup 321→ @changelog = <<~CHANGELOG 322→ ## [3.0.0] - 2024-03-01 323→ 324→ Version 3 content 325→ 326→ ## [2.0.0] - 2024-02-01 327→ 328→ Version 2 content 329→ 330→ ## [1.0.0] - 2024-01-01 331→ 332→ Version 1 content 333→ CHANGELOG 334→ @parser = Changelog::Parser.new(@changelog) 335→ end 336→ 337→ def test_extracts_content_between_versions 338→ result = @parser.between("1.0.0", "3.0.0") 339→ 340→ assert_includes result, "Version 3 content" 341→ assert_includes result, "Version 2 content" 342→ refute_includes result, "Version 1 content" 343→ end 344→ 345→ def test_extracts_from_new_version_to_end 346→ result = @parser.between(nil, "2.0.0") 347→ 348→ assert_includes result, "Version 2 content" 349→ assert_includes result, "Version 1 content" 350→ end 351→ 352→ def test_extracts_from_start_to_old_version 353→ result = @parser.between("2.0.0", nil) 354→ 355→ assert_includes result, "Version 3 content" 356→ refute_includes result, "Version 2 content" 357→ end 358→ 359→ def test_returns_nil_when_neither_found 360→ result = @parser.between("9.0.0", "8.0.0") 361→ 362→ assert_nil result 363→ end 364→ 365→ def test_handles_ascending_changelog 366→ changelog = <<~CHANGELOG 367→ ## [1.0.0] - 2024-01-01 368→ 369→ First 370→ 371→ ## [2.0.0] - 2024-02-01 372→ 373→ Second 374→ CHANGELOG 375→ 376→ parser = Changelog::Parser.new(changelog) 377→ result = parser.between("1.0.0", "2.0.0") 378→ 379→ assert_includes result, "Second" 380→ end 381→end 382→ 383→class TestFindChangelog < Minitest::Test 384→ def test_finds_changelog_in_current_directory 385→ path = Changelog::Parser.find_changelog 386→ 387→ assert_equal "./CHANGELOG.md", path 388→ end 389→ 390→ def test_returns_nil_for_empty_directory 391→ Dir.mktmpdir do |dir| 392→ result = Changelog::Parser.find_changelog(dir) 393→ assert_nil result 394→ end 395→ end 396→ 397→ def test_finds_and_parses 398→ result = Changelog::Parser.find_and_parse 399→ 400→ assert_instance_of Hash, result 401→ assert_includes result.keys, "0.1.0" 402→ end 403→end 404→ 405→class TestEdgeCases < Minitest::Test 406→ def test_version_with_prerelease 407→ changelog = "## [1.0.0-beta.1] - 2024-01-01\n\nBeta content" 408→ result = Changelog::Parser.parse(changelog) 409→ 410→ assert_includes result.keys, "1.0.0-beta.1" 411→ end 412→ 413→ def test_version_with_build_metadata 414→ changelog = "## [1.0.0+build.123] - 2024-01-01\n\nBuild content" 415→ result = Changelog::Parser.parse(changelog) 416→ 417→ assert_includes result.keys, "1.0.0+build.123" 418→ end 419→ 420→ def test_complex_prerelease_version 421→ changelog = "## [2.0.0-x.7.z.92] - 2024-01-01\n\nComplex prerelease" 422→ result = Changelog::Parser.parse(changelog) 423→ 424→ assert_includes result.keys, "2.0.0-x.7.z.92" 425→ end 426→ 427→ def test_empty_version_content 428→ changelog = <<~CHANGELOG 429→ ## [2.0.0] - 2024-02-01 430→ 431→ ## [1.0.0] - 2024-01-01 432→ 433→ Some content 434→ CHANGELOG 435→ 436→ result = Changelog::Parser.parse(changelog) 437→ assert_equal "", result["2.0.0"][:content] 438→ assert_includes result["1.0.0"][:content], "Some content" 439→ end 440→ 441→ def test_preserves_version_order 442→ changelog = <<~CHANGELOG 443→ ## [3.0.0] - 2024-03-01 444→ ## [1.0.0] - 2024-01-01 445→ ## [2.0.0] - 2024-02-01 446→ CHANGELOG 447→ 448→ result = Changelog::Parser.parse(changelog) 449→ assert_equal ["3.0.0", "1.0.0", "2.0.0"], result.keys 450→ end 451→ 452→ def test_preserves_markdown_links 453→ changelog = <<~CHANGELOG 454→ ## [1.0.0] - 2024-01-01 455→ 456→ - Added [feature](https://example.com) 457→ - See [docs](https://docs.example.com) for details 458→ CHANGELOG 459→ 460→ result = Changelog::Parser.parse(changelog) 461→ assert_includes result["1.0.0"][:content], "[feature](https://example.com)" 462→ end 463→ 464→ def test_preserves_inline_code 465→ changelog = <<~CHANGELOG 466→ ## [1.0.0] - 2024-01-01 467→ 468→ - Fixed `bug_in_function` method 469→ CHANGELOG 470→ 471→ result = Changelog::Parser.parse(changelog) 472→ assert_includes result["1.0.0"][:content], "`bug_in_function`" 473→ end 474→ 475→ def test_ignores_link_references 476→ changelog = <<~CHANGELOG 477→ ## [1.0.0] - 2024-01-01 478→ 479→ Content here 480→ 481→ [1.0.0]: https://github.com/example/repo/releases/tag/v1.0.0 482→ CHANGELOG 483→ 484→ result = Changelog::Parser.parse(changelog) 485→ assert_equal 1, result.size 486→ assert_includes result["1.0.0"][:content], "[1.0.0]: https://github.com" 487→ end 488→ 489→ def test_handles_mixed_list_markers 490→ changelog = <<~CHANGELOG 491→ ## [1.0.0] - 2024-01-01 492→ 493→ - Dash item 494→ * Asterisk item 495→ - Another dash 496→ CHANGELOG 497→ 498→ result = Changelog::Parser.parse(changelog) 499→ assert_includes result["1.0.0"][:content], "- Dash item" 500→ assert_includes result["1.0.0"][:content], "* Asterisk item" 501→ end 502→ 503→ def test_handles_nested_lists 504→ changelog = <<~CHANGELOG 505→ ## [1.0.0] - 2024-01-01 506→ 507→ - Main item 508→ - Sub item one 509→ - Sub item two 510→ CHANGELOG 511→ 512→ result = Changelog::Parser.parse(changelog) 513→ assert_includes result["1.0.0"][:content], "- Sub item one" 514→ end 515→ 516→ def test_version_with_v_prefix 517→ changelog = "## v1.0.0\n\nContent" 518→ result = Changelog::Parser.parse(changelog, format: :markdown) 519→ 520→ assert_includes result.keys, "1.0.0" 521→ end 522→ 523→ def test_unreleased_section 524→ changelog = <<~CHANGELOG 525→ ## [Unreleased] 526→ 527→ - Work in progress 528→ 529→ ## [1.0.0] - 2024-01-01 530→ 531→ - Released feature 532→ CHANGELOG 533→ 534→ result = Changelog::Parser.parse(changelog) 535→ assert_includes result.keys, "Unreleased" 536→ assert_nil result["Unreleased"][:date] 537→ assert_includes result["Unreleased"][:content], "Work in progress" 538→ end 539→ 540→ def test_version_with_label 541→ changelog = "## [1.0.0] - 2024-01-01 - Codename Phoenix\n\nContent" 542→ result = Changelog::Parser.parse(changelog) 543→ 544→ assert_includes result.keys, "1.0.0" 545→ assert_equal Date.new(2024, 1, 1), result["1.0.0"][:date] 546→ end 547→ 548→ def test_comprehensive_fixture 549→ result = Changelog::Parser.parse_file(fixture_path("comprehensive.md")) 550→ 551→ assert_equal 8, result.size 552→ assert_includes result.keys, "Unreleased" 553→ assert_includes result.keys, "2.0.0-x.7.z.92" 554→ assert_includes result.keys, "1.5.0-beta.2" 555→ assert_includes result.keys, "1.0.0" 556→ end 557→end 558→

Summary

Summary