build/sdk/generate_version_history/cmd.py

# Copyright 2024 The Fuchsia Authors. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.

"""Preprocesses version_history.json before including it in the IDK."""

import argparse
import datetime
import json
import pathlib

import generate_version_history


def main() -> None:
    parser = argparse.ArgumentParser(__doc__, allow_abbrev=False)
    parser.add_argument(
        "--input",
        type=pathlib.Path,
        required=True,
        help="Unprocessed version of version_history.json",
    )

    parser.add_argument(
        "--daily-commit-hash-file",
        type=pathlib.Path,
        required=True,
        help=(
            "File containing the hash of the latest commit to integration.git "
            "before today, as a hexadecimal UTF-8 string."
        ),
    )

    parser.add_argument(
        "--daily-commit-timestamp-file",
        type=pathlib.Path,
        required=True,
        help=(
            "File containing the commit timestamp of the latest commit to "
            "integration.git before today, as a decimal UNIX timestamp."
        ),
    )

    parser.add_argument(
        "--output",
        type=pathlib.Path,
        required=True,
        help="Generated version of version_history.json",
    )

    args = parser.parse_args()

    with args.input.open() as f:
        version_history = json.load(f)
    with args.daily_commit_hash_file.open() as f:
        daily_commit_hash = f.read().strip()
    with args.daily_commit_timestamp_file.open() as f:
        daily_commit_timestamp = datetime.datetime.fromtimestamp(
            int(f.read().strip()), datetime.UTC
        )

    generate_version_history.replace_special_abi_revisions(
        version_history, daily_commit_hash, daily_commit_timestamp
    )

    # TODO(https://fxbug.dev/383361369): Delete this once all clients have been
    # updated to use "phase".
    generate_version_history.add_deprecated_status_field(version_history)

    write_file_if_changed(args.output, json.dumps(version_history, indent=2))


def write_file_if_changed(path: str, contents: str) -> None:
    if path:
        if contents_changed(path, contents):
            with open(path, "w") as file:
                file.write(contents)


def contents_changed(path: str, contents: str) -> bool:
    try:
        with open(path, "r") as file:
            existing_contents = file.read()
            return existing_contents != contents
    except Exception:
        pass
    return True


if __name__ == "__main__":
    main()