nodejs_versions.py

import datetime
from typing import TypedDict

import requests

todays_date = datetime.datetime.now(datetime.UTC).date().isoformat()


class NodeRelease(TypedDict):
 version: str
 date: str
 files: list[str]


def fetch_node_releases() -> list[NodeRelease]:
 """Fetch official node releases"""
 url = "https://nodejs.org/dist/index.json"
 res = requests.get(url, timeout=10.0)
 res.raise_for_status()
 data: list[NodeRelease] = res.json()
 return data


def fetch_node_unofficial_releases() -> list[NodeRelease]:
 url = "https://unofficial-builds.nodejs.org/download/release/index.json"
 res = requests.get(url, timeout=10.0)
 res.raise_for_status()
 data: list[NodeRelease] = res.json()
 return data


class ReleaseScheduleItem(TypedDict):
 start: str
 lts: str
 maintenance: str
 end: str
 codename: str


def fetch_nodejs_release_schedule() -> dict[str, ReleaseScheduleItem]:
 """Download list of official releases, skipping unreleased and unsupported versions"""
 res = requests.get("https://raw.githubusercontent.com/nodejs/Release/master/schedule.json", timeout=10.0)
 res.raise_for_status()
 release_schedule: dict[str, ReleaseScheduleItem] = res.json()
 return release_schedule