ycdemo / fastapi / scripts/ prepare_release.py

"""Prepare a release by updating the package version and release notes."""

import re
from datetime import date
from pathlib import Path
from typing import Annotated, Literal

import typer

VERSION_PATTERN = re.compile(r'(?m)^__version__ = "(\d+\.\d+\.\d+)"
		
		
		
		
	

)
VERSION_HEADING_PATTERN = re.compile(r"(?m)^## (\d+\.\d+\.\d+)(?: \([^)]+\))?$")
RELEASE_NOTES_HEADER = """---
hide:
  - navigation
---

# Release Notes

"""
LATEST_CHANGES_HEADER = "## Latest Changes"
BumpType = Literal["major", "minor", "patch"]

app = typer.Typer()


def parse_version(version: str) -> tuple[int, int, int]:
    match = re.fullmatch(r"\d+\.\d+\.\d+", version)
    if not match:
        raise ValueError(f"Invalid version: {version!r}. Expected format: X.Y.Z")
    major, minor, patch = version.split(".")
    return int(major), int(minor), int(patch)


def get_current_version(content: str, version_file: Path) -> str:
    matches = list(VERSION_PATTERN.finditer(content))
    if len(matches) != 1:
        raise RuntimeError(
            f"Expected exactly one __version__ assignment in {version_file}, "
            f"found {len(matches)}"
        )
    return matches[0].group(1)


def bump_version(version: str, bump: BumpType) -> str:
    major, minor, patch = parse_version(version)
    if bump == "major":
        return f"{major + 1}.0.0"
    if bump == "minor":
        return f"{major}.{minor + 1}.0"
    return f"{major}.{minor}.{patch + 1}"


def update_version_file(content: str, version: str, version_file: Path) -> str:
    current_version = get_current_version(content, version_file)
    if parse_version(version) <= parse_version(current_version):
        raise RuntimeError(
            f"New version {version} must be greater than current version {current_version}"
        )
    return VERSION_PATTERN.sub(f'__version__ = "{version}"', content, count=1)


def update_release_notes(
    content: str, version: str, release_date: date, release_notes_file: Path
) -> str:
    if not content.startswith(RELEASE_NOTES_HEADER):
        raise RuntimeError(
            f"{release_notes_file} must start with {RELEASE_NOTES_HEADER!r}"
        )
    if re.search(rf"^## {re.escape(version)}(?: \([^)]+\))?$", content, re.M):
        raise RuntimeError(f"Release notes already contain a section for {version}")

    latest_header = f"{RELEASE_NOTES_HEADER}{LATEST_CHANGES_HEADER}\n"
    if not content.startswith(latest_header):
        raise RuntimeError(f"{release_notes_file} must start with {latest_header!r}")

    release_header = f"## {version} ({release_date.isoformat()})"
    return content.replace(
        latest_header,
        f"{RELEASE_NOTES_HEADER}{LATEST_CHANGES_HEADER}\n\n{release_header}\n",
        1,
    )


def get_release_notes_body(content: str, version: str, release_notes_file: Path) -> str:
    version_heading = re.compile(rf"(?m)^## {re.escape(version)}(?: \([^)]+\))?$")
    match = version_heading.search(content)
    if not match:
        raise RuntimeError(
            f"Could not find release notes section for {version} in {release_notes_file}"
        )

    next_match = VERSION_HEADING_PATTERN.search(content, match.end())
    end = next_match.start() if next_match else len(content)
    body = content[match.end() : end].strip()
    if not body:
        raise RuntimeError(
            f"Release notes section for {version} in {release_notes_file} is empty"
        )
    return f"{body}\n"


@app.command()
def prepare(
    bump: Annotated[
        BumpType,
        typer.Argument(
            envvar="PREPARE_RELEASE_BUMP",
            help="The release bump to make: major, minor, or patch.",
        ),
    ],
    version_file: Annotated[
        Path,
        typer.Option(
            envvar="PREPARE_RELEASE_VERSION_FILE",
            exists=True,
            file_okay=True,
            dir_okay=False,
            readable=True,
            writable=True,
            help="Path to the Python file containing the __version__ assignment.",
        ),
    ],
    release_notes_file: Annotated[
        Path,
        typer.Option(
            envvar="PREPARE_RELEASE_RELEASE_NOTES_FILE",
            exists=True,
            file_okay=True,
            dir_okay=False,
            readable=True,
            writable=True,
            help="Path to the release notes Markdown file.",
        ),
    ],
    release_date: Annotated[
        str,
        typer.Option(
            "--date",
            envvar="PREPARE_RELEASE_DATE",
            help="Release date in YYYY-MM-DD format. Defaults to today.",
        ),
    ] = date.today().isoformat(),
) -> None:
    parsed_release_date = date.fromisoformat(release_date or date.today().isoformat())

    version_file_content = version_file.read_text()
    release_notes_content = release_notes_file.read_text()
    version = bump_version(
        get_current_version(version_file_content, version_file), bump
    )

    version_file.write_text(
        update_version_file(version_file_content, version, version_file)
    )
    release_notes_file.write_text(
        update_release_notes(
            release_notes_content, version, parsed_release_date, release_notes_file
        )
    )

    typer.echo(f"Prepared release {version} ({parsed_release_date.isoformat()})")


@app.command()
def current_version(
    version_file: Annotated[
        Path,
        typer.Option(
            envvar="PREPARE_RELEASE_VERSION_FILE",
            exists=True,
            file_okay=True,
            dir_okay=False,
            readable=True,
            help="Path to the Python file containing the __version__ assignment.",
        ),
    ],
) -> None:
    typer.echo(get_current_version(version_file.read_text(), version_file))


@app.command()
def release_notes(
    version_file: Annotated[
        Path,
        typer.Option(
            envvar="PREPARE_RELEASE_VERSION_FILE",
            exists=True,
            file_okay=True,
            dir_okay=False,
            readable=True,
            help="Path to the Python file containing the __version__ assignment.",
        ),
    ],
    release_notes_file: Annotated[
        Path,
        typer.Option(
            envvar="PREPARE_RELEASE_RELEASE_NOTES_FILE",
            exists=True,
            file_okay=True,
            dir_okay=False,
            readable=True,
            help="Path to the release notes Markdown file.",
        ),
    ],
) -> None:
    version = get_current_version(version_file.read_text(), version_file)
    typer.echo(
        get_release_notes_body(
            release_notes_file.read_text(), version, release_notes_file
        ),
        nl=False,
    )


if __name__ == "__main__":
    app()
)\nVERSION_HEADING_PATTERN = re.compile(r\"(?m)^## (\\d+\\.\\d+\\.\\d+)(?: \\([^)]+\\))?$\")\nRELEASE_NOTES_HEADER = \"\"\"---\nhide:\n - navigation\n---\n\n# Release Notes\n\n\"\"\"\nLATEST_CHANGES_HEADER = \"## Latest Changes\"\nBumpType = Literal[\"major\", \"minor\", \"patch\"]\n\napp = typer.Typer()\n\n\ndef parse_version(version: str) -> tuple[int, int, int]:\n match = re.fullmatch(r\"\\d+\\.\\d+\\.\\d+\", version)\n if not match:\n raise ValueError(f\"Invalid version: {version!r}. Expected format: X.Y.Z\")\n major, minor, patch = version.split(\".\")\n return int(major), int(minor), int(patch)\n\n\ndef get_current_version(content: str, version_file: Path) -> str:\n matches = list(VERSION_PATTERN.finditer(content))\n if len(matches) != 1:\n raise RuntimeError(\n f\"Expected exactly one __version__ assignment in {version_file}, \"\n f\"found {len(matches)}\"\n )\n return matches[0].group(1)\n\n\ndef bump_version(version: str, bump: BumpType) -> str:\n major, minor, patch = parse_version(version)\n if bump == \"major\":\n return f\"{major + 1}.0.0\"\n if bump == \"minor\":\n return f\"{major}.{minor + 1}.0\"\n return f\"{major}.{minor}.{patch + 1}\"\n\n\ndef update_version_file(content: str, version: str, version_file: Path) -> str:\n current_version = get_current_version(content, version_file)\n if parse_version(version) \u003c= parse_version(current_version):\n raise RuntimeError(\n f\"New version {version} must be greater than current version {current_version}\"\n )\n return VERSION_PATTERN.sub(f'__version__ = \"{version}\"', content, count=1)\n\n\ndef update_release_notes(\n content: str, version: str, release_date: date, release_notes_file: Path\n) -> str:\n if not content.startswith(RELEASE_NOTES_HEADER):\n raise RuntimeError(\n f\"{release_notes_file} must start with {RELEASE_NOTES_HEADER!r}\"\n )\n if re.search(rf\"^## {re.escape(version)}(?: \\([^)]+\\))?$\", content, re.M):\n raise RuntimeError(f\"Release notes already contain a section for {version}\")\n\n latest_header = f\"{RELEASE_NOTES_HEADER}{LATEST_CHANGES_HEADER}\\n\"\n if not content.startswith(latest_header):\n raise RuntimeError(f\"{release_notes_file} must start with {latest_header!r}\")\n\n release_header = f\"## {version} ({release_date.isoformat()})\"\n return content.replace(\n latest_header,\n f\"{RELEASE_NOTES_HEADER}{LATEST_CHANGES_HEADER}\\n\\n{release_header}\\n\",\n 1,\n )\n\n\ndef get_release_notes_body(content: str, version: str, release_notes_file: Path) -> str:\n version_heading = re.compile(rf\"(?m)^## {re.escape(version)}(?: \\([^)]+\\))?$\")\n match = version_heading.search(content)\n if not match:\n raise RuntimeError(\n f\"Could not find release notes section for {version} in {release_notes_file}\"\n )\n\n next_match = VERSION_HEADING_PATTERN.search(content, match.end())\n end = next_match.start() if next_match else len(content)\n body = content[match.end() : end].strip()\n if not body:\n raise RuntimeError(\n f\"Release notes section for {version} in {release_notes_file} is empty\"\n )\n return f\"{body}\\n\"\n\n\n@app.command()\ndef prepare(\n bump: Annotated[\n BumpType,\n typer.Argument(\n envvar=\"PREPARE_RELEASE_BUMP\",\n help=\"The release bump to make: major, minor, or patch.\",\n ),\n ],\n version_file: Annotated[\n Path,\n typer.Option(\n envvar=\"PREPARE_RELEASE_VERSION_FILE\",\n exists=True,\n file_okay=True,\n dir_okay=False,\n readable=True,\n writable=True,\n help=\"Path to the Python file containing the __version__ assignment.\",\n ),\n ],\n release_notes_file: Annotated[\n Path,\n typer.Option(\n envvar=\"PREPARE_RELEASE_RELEASE_NOTES_FILE\",\n exists=True,\n file_okay=True,\n dir_okay=False,\n readable=True,\n writable=True,\n help=\"Path to the release notes Markdown file.\",\n ),\n ],\n release_date: Annotated[\n str,\n typer.Option(\n \"--date\",\n envvar=\"PREPARE_RELEASE_DATE\",\n help=\"Release date in YYYY-MM-DD format. Defaults to today.\",\n ),\n ] = date.today().isoformat(),\n) -> None:\n parsed_release_date = date.fromisoformat(release_date or date.today().isoformat())\n\n version_file_content = version_file.read_text()\n release_notes_content = release_notes_file.read_text()\n version = bump_version(\n get_current_version(version_file_content, version_file), bump\n )\n\n version_file.write_text(\n update_version_file(version_file_content, version, version_file)\n )\n release_notes_file.write_text(\n update_release_notes(\n release_notes_content, version, parsed_release_date, release_notes_file\n )\n )\n\n typer.echo(f\"Prepared release {version} ({parsed_release_date.isoformat()})\")\n\n\n@app.command()\ndef current_version(\n version_file: Annotated[\n Path,\n typer.Option(\n envvar=\"PREPARE_RELEASE_VERSION_FILE\",\n exists=True,\n file_okay=True,\n dir_okay=False,\n readable=True,\n help=\"Path to the Python file containing the __version__ assignment.\",\n ),\n ],\n) -> None:\n typer.echo(get_current_version(version_file.read_text(), version_file))\n\n\n@app.command()\ndef release_notes(\n version_file: Annotated[\n Path,\n typer.Option(\n envvar=\"PREPARE_RELEASE_VERSION_FILE\",\n exists=True,\n file_okay=True,\n dir_okay=False,\n readable=True,\n help=\"Path to the Python file containing the __version__ assignment.\",\n ),\n ],\n release_notes_file: Annotated[\n Path,\n typer.Option(\n envvar=\"PREPARE_RELEASE_RELEASE_NOTES_FILE\",\n exists=True,\n file_okay=True,\n dir_okay=False,\n readable=True,\n help=\"Path to the release notes Markdown file.\",\n ),\n ],\n) -> None:\n version = get_current_version(version_file.read_text(), version_file)\n typer.echo(\n get_release_notes_body(\n release_notes_file.read_text(), version, release_notes_file\n ),\n nl=False,\n )\n\n\nif __name__ == \"__main__\":\n app()\n","preview":null,"history":null,"version":"5a1ce90e17fc453462c0ad689f08cf579813bca6"},"/_session?shell=1":null}