Гайд · Python 3.9+
Ежемесячный отчёт о стоимости жизни
Первого числа отчёт, готовый к публикации: сколько стоит базовая корзина сегодня и в самом дешёвом магазине, что подорожало и подешевело за 30 дней по группам, и действующие тарифы НАРЭ.
- Работает на
- Python 3.9+
- Один запуск
- 5 кредитов
- В месяц
- 5 кредитов
- Настройка
- 5 мин
$ MONTHS=12 DAYS=30 python3 basket_report.pyreports/report-2026-11.md: basket 723.35 lei, 12 groups, 9 tariffs, 5 creditsКак это работает
- Берёт корзину за последние
MONTHSмесяцев из/v1/indexes/basket: итог, самый дешёвый итог, изменение за месяц и год. - Берёт подорожания и подешевления за
DAYSдней из/v1/indexes/moves, по группам товаров. - Берёт тарифы ЖКХ из
/v1/tariffs, каждый с решением НАРЭ. - Пишет
report-YYYY-MM.mdдля статьи иbasket-YYYY-MM.csvдля графика.
Сколько стоит: 2 кредита за корзину, 2 за изменения, 1 за тарифы: 5 кредитов в месяц. Укладывается в план Start.
Как запустить
export SATELIT_KEY=sat_live_...
MONTHS=12 DAYS=30 python3 basket_report.pyЧто выводит
reports/report-2026-11.md: basket 723.35 lei, 12 groups, 9 tariffs, 5 creditsПолный скрипт
#!/usr/bin/env python3
"""Cost of living report: the food basket, what got dearer or cheaper, and household tariffs, once a month.
SATELIT_KEY=sat_live_... python3 basket_report.py
Optional: MONTHS (12, the basket's span), DAYS (30, the moves' window), OUT_DIR (reports).
Writes report-YYYY-MM.md and basket-YYYY-MM.csv. Standard library only.
Put it in cron: 0 9 1 * * python3 /path/basket_report.py
"""
import csv
import json
import os
import sys
import time
import urllib.error
import urllib.parse
import urllib.request
from datetime import date
from pathlib import Path
sys.stdout.reconfigure(encoding="utf-8") # names hold ă, ș, ț whatever the console's code page
BASE = os.environ.get("SATELIT_BASE", "https://api.satelit.md/v1")
KEY = os.environ["SATELIT_KEY"]
MONTHS = int(os.environ.get("MONTHS", "12"))
DAYS = int(os.environ.get("DAYS", "30"))
OUT = Path(os.environ.get("OUT_DIR", "reports"))
credits_used = 0
attribution = ""
def api(path, **params):
global credits_used, attribution
query = urllib.parse.urlencode({"lang": "ro", **params})
req = urllib.request.Request(f"{BASE}{path}?{query}", headers={"Authorization": f"Bearer {KEY}"})
for attempt in range(3):
try:
with urllib.request.urlopen(req, timeout=20) as res:
body = json.load(res)
credits_used += body["meta"].get("credits", 0)
attribution = attribution or body["meta"].get("attribution", "")
return body["data"]
except urllib.error.HTTPError as err:
retry = err.headers.get("Retry-After")
if err.code in (429, 503) and retry and attempt < 2:
time.sleep(int(retry))
continue
raise SystemExit(f"{path}: {err.code} {err.read().decode()}")
def pct(n):
return "n/a" if n is None else f"{n:+.2f}%"
def main():
basket = api("/indexes/basket", months=MONTHS)
moves = api("/indexes/moves", days=DAYS)
tariffs = api("/tariffs")
month = date.today().strftime("%Y-%m")
OUT.mkdir(parents=True, exist_ok=True)
points = basket["points"]
first, last = points[0], points[-1]
span = (last["total"] / first["total"] - 1) * 100 if first["total"] else 0
with open(OUT / f"basket-{month}.csv", "w", newline="", encoding="utf-8") as f:
out = csv.writer(f)
out.writerow(["date", "total_lei", "cheapest_total_lei"])
out.writerows([p["date"], p["total"], p["cheapest_total"]] for p in points)
groups = sorted(moves["groups"], key=lambda g: g["change_pct"])
lines = [
f"# Cost of living in Moldova, {month}",
"",
"## Food basket",
f"- {len(basket['items'])} products, {last['date']}: **{last['total']:.2f} lei** "
f"(the cheapest shop for each: {last['cheapest_total']:.2f} lei)",
f"- Since {first['date']}: {span:+.2f}%; month on month {pct(basket['change_mom'])}, year on year {pct(basket['change_yoy'])}",
"",
f"## Prices in shops, {moves['from']} to {moves['to']}",
f"- {moves['compared']} products compared: {moves['up']} dearer, {moves['down']} cheaper, {moves['same']} unchanged, "
f"on average {moves['change_pct']:+.2f}%",
*[f"- {g['label']}: {g['change_pct']:+.2f}% ({g['up']} up, {g['down']} down)" for g in groups],
"",
"## Household tariffs",
*[f"- {t['label']} ({t['provider']}): {t['value']} {t['unit']}, since {t['valid_from']}, {t['decision']}" for t in tariffs],
"",
f"_{attribution}_",
]
report = OUT / f"report-{month}.md"
report.write_text("\n".join(lines) + "\n", "utf-8")
print(f"{report}: basket {last['total']:.2f} lei, {len(groups)} groups, {len(tariffs)} tariffs, {credits_used} credits")
if __name__ == "__main__":
main()
Используемые маршруты
Вопросы об этом гайде
Что входит в корзину?
Список в data.items: товар, количество и единица. total цена корзины в магазинах; cheapest_total та же корзина из самого дешёвого магазина по каждому товару.
С какого времени есть история?
Цены в магазинах есть с 28 октября 2026 г.. Для месяца или года без данных change_mom и change_yoy равны null, и отчёт пишет n/a.
Можно публиковать отчёт?
Да, со строкой из meta.attribution, которую скрипт ставит в конце. Тарифы взяты из публичных решений НАРЭ, указанных в отчёте.