open_docs.py

#!/bin/python3
# -*- encoding: utf-8 -*-
#
# open_docs.py - © 2023 @queengooborg
# Written by Queen Vinyl Da.i'gyu-Kazotetsu <https://www.queengoob.org>
# This script takes a feature identifier and opens its MDN web docs page in the specified browser (defaults to Chrome). If the feature identifier doesn't have an `mdn_url` specified, it will get the parent's instead.
#
# Requirements:
# - Python 3.10
#

import json
import sys
import os
import webbrowser

if len(sys.argv) < 2:
	print("Usage: python open_docs.py <feature> [browser]")
	sys.exit(1)

feature = sys.argv[1].split(".")
bcd_path = os.path.abspath("./node_modules/@mdn/browser-compat-data")

p = bcd_path
i = 0
while True:
	if i == len(feature):
		print("Could not find feature!")
		sys.exit(1)
	p = os.path.join(p, feature[i])
	if os.path.isfile(p+".json"):
		p += ".json"
		break
	i += 1

j = json.load(open(p, 'r'))

js = j
mdn_url = ""
for f in feature:
	js = js.get(f)
	if not js:
		print("Could not find feature!")
		sys.exit(1)
	mdn_url = js.get('__compat', {}).get("mdn_url", mdn_url)

if not mdn_url:
	print("Feature does not have an MDN URL defined!")
	sys.exit(1)

webbrowser.get(sys.argv[2] if len(sys.argv) >= 3 else 'chrome').open(mdn_url)