#!/usr/bin/env python3
"""Парсер ежедневных курсов валют Банка России -> CSV.

Только стандартная библиотека Python 3.8+. Источник: открытый XML
https://www.cbr.ru/scripts/XML_daily.asp

Запуск:
    python cbr_rates.py                       # sample_rates.csv рядом со скриптом
    python cbr_rates.py -o rates.csv          # свой файл
    python cbr_rates.py --date 20/11/2026     # курсы на дату (ДД/ММ/ГГГГ)

Колонки CSV: date, char_code, num_code, nominal, name, value, unit_rate
  value     - курс за nominal единиц в рублях
  unit_rate - курс за 1 единицу (value / nominal)
"""
import argparse
import csv
import sys
import urllib.error
import urllib.parse
import urllib.request
import xml.etree.ElementTree as ET
from pathlib import Path

URL = "https://www.cbr.ru/scripts/XML_daily.asp"
HEADERS = {"User-Agent": "Mozilla/5.0 (compatible; rates-demo/1.0)"}


def fetch_xml(date_req=None, timeout=20):
    """Скачивает XML и возвращает байты (в XML заявлена кодировка windows-1251)."""
    url = URL
    if date_req:
        url += "?" + urllib.parse.urlencode({"date_req": date_req})
    req = urllib.request.Request(url, headers=HEADERS)
    with urllib.request.urlopen(req, timeout=timeout) as resp:
        return resp.read()


def to_float(text):
    """В XML десятичный разделитель - запятая."""
    return float(text.strip().replace(",", "."))


def parse_rates(xml_bytes):
    """Возвращает (дата_курса, список строк). Дата берётся из самого XML."""
    root = ET.fromstring(xml_bytes)
    date = root.get("Date", "")
    rows = []
    for v in root.findall("Valute"):
        nominal = int(v.findtext("Nominal", "1"))
        value = to_float(v.findtext("Value", "0"))
        vunit = v.findtext("VunitRate")
        unit_rate = to_float(vunit) if vunit else value / nominal
        rows.append({
            "date": date,
            "char_code": v.findtext("CharCode", ""),
            "num_code": v.findtext("NumCode", ""),
            "nominal": nominal,
            "name": v.findtext("Name", ""),
            "value": value,
            "unit_rate": round(unit_rate, 6),
        })
    return date, rows


def write_csv(rows, path):
    fields = ["date", "char_code", "num_code", "nominal", "name", "value", "unit_rate"]
    with open(path, "w", encoding="utf-8-sig", newline="") as f:
        w = csv.DictWriter(f, fieldnames=fields)
        w.writeheader()
        w.writerows(rows)


def main(argv=None):
    p = argparse.ArgumentParser(description="Курсы валют ЦБ РФ -> CSV")
    p.add_argument("-o", "--out", default=str(Path(__file__).with_name("sample_rates.csv")))
    p.add_argument("--date", help="дата в формате ДД/ММ/ГГГГ (по умолчанию - текущие курсы)")
    args = p.parse_args(argv)
    try:
        data = fetch_xml(args.date)
        date, rows = parse_rates(data)
    except (urllib.error.URLError, TimeoutError, ET.ParseError) as e:
        print("Ошибка получения данных: %s" % e, file=sys.stderr)
        return 1
    if not rows:
        print("В ответе нет валют", file=sys.stderr)
        return 1
    write_csv(rows, args.out)
    print("Курсы на %s: %d валют -> %s" % (date, len(rows), args.out))
    return 0


if __name__ == "__main__":
    sys.exit(main())
