"""List formatting"""

from __future__ import annotations

from typing import TYPE_CHECKING

if TYPE_CHECKING:

from collections.abc import Sequence

__all__ = ["and_list", "or_list"]

def or_list(items: Sequence[str]) -> str:

"""Given [ A, B, C ] return 'A, B, or C'."""

return format_list("or", items)

def and_list(items: Sequence[str]) -> str:

"""Given [ A, B, C ] return 'A, B, and C'."""

return format_list("and", items)

def format_list(conjunction: str, items: Sequence[str]) -> str:

"""Given [ A, B, C ] return 'A, B, (conjunction) C'"""

if not items:

msg = "Missing list items to be formatted."

raise ValueError(msg)

n = len(items)

if n == 1:

return items[0]

if n == 2:

return f"{items[0]} {conjunction} {items[1]}"

*all_but_last, last_item = items

return f"{', '.join(all_but_last)}, {conjunction} {last_item}"