vcard_csv.py

"""Convert a vCard file to CSV.

Usage: python3.14 vcard_csv.py INPUT.vcf [-f OUTPUT.csv]
Requires the ``pyvcard`` package.
"""

from __future__ import annotations

import argparse
import sys
from pathlib import Path

import pyvcard


def view(path: str | Path) -> str:
    """Return vCards from *path* in CSV format."""
    cards = pyvcard.openfile(str(path), encoding="utf-8").vcards()
    return str(pyvcard.convert(cards).csv().permanent_result())


def main(argv: list[str] | None = None) -> int:
    parser = argparse.ArgumentParser(description="Convert a vCard file to CSV.")
    parser.add_argument("file", type=Path, help="input vCard file")
    parser.add_argument("-f", "--output", type=Path, help="output CSV file")
    args = parser.parse_args(argv)
    if not args.file.is_file():
        parser.error(f"file not found: {args.file}")
    try:
        csv_text = view(args.file)
        if args.output:
            args.output.write_text(csv_text, encoding="utf-8")
        else:
            print(csv_text)
    except (OSError, ValueError) as exc:
        print(f"Error: {exc}", file=sys.stderr)
        return 1
    return 0


if __name__ == "__main__":
    raise SystemExit(main())