Class VersionWriter

dev-tools/scripts/changes2logchange.py:686–883

Handles version enumeration, comparison, and release-date.txt writing.

class VersionWriter:
    """Handles version enumeration, comparison, and release-date.txt writing."""

    def __init__(self, changes_file_path: str, changelog_dir: str):
        self.changes_file_path = changes_file_path
        self.changelog_dir = Path(changelog_dir)
        self.parser = ChangesParser(changes_file_path)

        # Fetch release dates from Apache projects JSON
        version_dates_raw, _ = ReleaseDate.fetch_release_dates_and_latest()

        # Normalize version keys for consistent lookup (e.g., "3.1" -> "3.1.0")
        self.version_dates = {}
        for version, date in version_dates_raw.items():
            normalized = self._normalize_version(version)
            # Keep the first occurrence (most canonical form)
            if normalized not in self.version_dates:
                self.version_dates[normalized] = date

    def run(self):
        """Execute version comparison and release-date.txt writing."""
        print("Parsing CHANGES.txt for versions...")
        self.parser.parse()

        # Extract versions from CHANGES.txt
        changes_versions = set(vs.version for vs in self.parser.versions)
        print(f"Found {len(changes_versions)} versions in CHANGES.txt")

        # Get existing version folders
        existing_folders = self.get_existing_version_folders()
        print(f"Found {len(existing_folders)} existing version folders in changelog/")

        # Get versions from solr.json (which is what ReleaseDate fetches)
        solr_json_versions = set(self.version_dates.keys())
        print(f"Found {len(solr_json_versions)} versions in solr.json\n")

        # Build normalized version mappings for matching (supports semver like 3.1 == 3.1.0)
        changes_normalized = {self._normalize_version(v): v for v in changes_versions}
        existing_normalized = {self._normalize_version(v): v for v in existing_folders}
        solr_normalized = {self._normalize_version(v): v for v in solr_json_versions}

        # Combine all normalized versions
        all_normalized = sorted(set(changes_normalized.keys()) | set(solr_normalized.keys()) | set(existing_normalized.keys()),
                               key=self._version_sort_key)

        # Print comparison report
        self._print_comparison_report(all_normalized, changes_normalized, solr_normalized, existing_normalized)

        # Write release-date.txt for existing folders
        self._write_release_dates(existing_normalized)

    def get_existing_version_folders(self) -> set:
        """Get all existing vX.Y.Z folders in changelog/."""
        if not self.changelog_dir.exists():
            return set()

        folders = set()
        for item in self.changelog_dir.iterdir():