feat: support a verbose heading for the changelog

CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to this project will be documented in this file, in reverse chronological order by release.
 
+## 2.9.0 - TBD
+
+### Added
+
+- [#80](https://github.com/phly/keep-a-changelog/pull/80) adds support for more verbose changelog headings. The heading no longer must be exactly `# Changelog`. Rather, it can be `# My Project's Changelog` or `# The changelog for all the things`. The word "changelog" must still be somewhere in the heading.
+
+### Changed
+
+- Nothing.
+
+### Deprecated
+
+- Nothing.
+
+### Removed
+
+- Nothing.
+
+### Fixed
+
+- Nothing.
+
 ## 2.8.1 - 2020-09-01
 
 ### Added

src/Bump/ChangelogBump.php

@@ -107,7 +107,7 @@ public function updateChangelog(string $version)
         $changelog = sprintf(self::TEMPLATE, $version);
         $contents  = file_get_contents($this->changelogFile);
         $contents  = preg_replace(
-            "/^(\# Changelog\n\n.*?)(\n\n\#\# )/s",
+            "/^(\# [^\n]*Changelog[^\n]*\n\n.*?)(\n\n\#\# )/si",
             '$1' . $changelog . '## ',
             $contents
         );

test/Bump/ChangelogBumpTest.php

@@ -219,4 +219,124 @@ public function testFindLatestVersionThrowsExceptionIfNoChangelogEntriesFound():
 
         $bumper->findLatestVersion();
     }
+
+    public function testUpdateChangelogPrependsNewEntryWhenChangelogHasExpandedHeading(): void
+    {
+        $expected = <<<'EOC'
+# my/project's ChAnGeLoG of Notable Changes
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## 1.0.0 - TBD
+
+### Added
+
+- Nothing.
+
+### Changed
+
+- Nothing.
+
+### Deprecated
+
+- Nothing.
+
+### Removed
+
+- Nothing.
+
+### Fixed
+
+- Nothing.
+
+## 0.2.0 - TBD
+
+### Added
+
+- Nothing.
+
+### Changed
+
+- Nothing.
+
+### Deprecated
+
+- Nothing.
+
+### Removed
+
+- Nothing.
+
+### Fixed
+
+- Nothing.
+
+## 0.1.1 - TBD
+
+### Added
+
+- Nothing.
+
+### Changed
+
+- Nothing.
+
+### Deprecated
+
+- Nothing.
+
+### Removed
+
+- Nothing.
+
+### Fixed
+
+- Nothing.
+
+## 0.1.0 - 2020-08-31
+
+### Added
+
+- Nothing.
+
+### Changed
+
+- Nothing.
+
+### Deprecated
+
+- Nothing.
+
+### Removed
+
+- Nothing.
+
+### Fixed
+
+- Nothing.
+
+EOC;
+
+        $tempFile = tempnam(sys_get_temp_dir(), 'KAC');
+        file_put_contents(
+            $tempFile,
+            file_get_contents(__DIR__ . '/../_files/CHANGELOG-WITH-EXPANDED-HEADING.md')
+        );
+        $bumper = new ChangelogBump($tempFile);
+
+        $currentVersion = $bumper->findLatestVersion();
+        $currentVersion = $bumper->bumpPatchVersion($currentVersion);
+        $bumper->updateChangelog($currentVersion);
+
+        $currentVersion = $bumper->bumpMinorVersion($currentVersion);
+        $bumper->updateChangelog($currentVersion);
+
+        $currentVersion = $bumper->bumpMajorVersion($currentVersion);
+        $bumper->updateChangelog($currentVersion);
+
+        $this->assertEquals($expected, file_get_contents($tempFile));
+    }
 }

test/_files/CHANGELOG-WITH-EXPANDED-HEADING.md

@@ -0,0 +1,28 @@
+# my/project's ChAnGeLoG of Notable Changes
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## 0.1.0 - 2020-08-31
+
+### Added
+
+- Nothing.
+
+### Changed
+
+- Nothing.
+
+### Deprecated
+
+- Nothing.
+
+### Removed
+
+- Nothing.
+
+### Fixed
+
+- Nothing.