marlin/buildroot/share/PlatformIO/scripts/preflight-checks.py

#
# preflight-checks.py
# Check for common issues prior to compiling
#
import os,re,sys
Import("env")

def get_envs_for_board(board, envregex):
	with open(os.path.join("Marlin", "src", "pins", "pins.h"), "r") as file:
		r = re.compile(r"if\s+MB\((.+)\)")
		if board.startswith("BOARD_"):
			board = board[6:]

		for line in file:
			mbs = r.findall(line)
			if mbs and board in re.split(r",\s*", mbs[0]):
				line = file.readline()
				found_envs = re.match(r"\s*#include .+" + envregex, line)
				if found_envs:
					return re.findall(envregex + r"(\w+)", line)
	return []

def check_envs(build_env, board_envs, config):
	if build_env in board_envs:
		return True
	ext = config.get(build_env, 'extends', default=None)
	if ext:
		if isinstance(ext, str):
			return check_envs(ext, board_envs, config)
		elif isinstance(ext, list):
			for ext_env in ext:
				if check_envs(ext_env, board_envs, config):
					return True
	return False

# Sanity checks:
if 'PIOENV' not in env:
	raise SystemExit("Error: PIOENV is not defined. This script is intended to be used with PlatformIO")

if 'MARLIN_FEATURES' not in env:
	raise SystemExit("Error: this script should be used after common Marlin scripts")

if 'MOTHERBOARD' not in env['MARLIN_FEATURES']:
	raise SystemExit("Error: MOTHERBOARD is not defined in Configuration.h")

if sys.platform == 'win32':
	osregex = r"(?:env|win):"
elif sys.platform == 'darwin':
	osregex = r"(?:env|mac|uni):"
elif sys.platform == 'linux':
	osregex = r"(?:env|lin|uni):"
else:
	osregex = r"(?:env):"

build_env = env['PIOENV']
motherboard = env['MARLIN_FEATURES']['MOTHERBOARD']
board_envs = get_envs_for_board(motherboard, osregex)
config = env.GetProjectConfig()
result = check_envs(build_env, board_envs, config)

if not result:
	err = "Error: Build environment '%s' is incompatible with %s. Use one of these: %s" % \
		  (build_env, motherboard, ",".join([e[4:] for e in board_envs if re.match(r"^" + osregex, e)]))
	raise SystemExit(err)

#
# Check for Config files in two common incorrect places
#
for p in [ env['PROJECT_DIR'], os.path.join(env['PROJECT_DIR'], "config") ]:
	for f in [ "Configuration.h", "Configuration_adv.h" ]:
		if os.path.isfile(os.path.join(p, f)):
			err = "ERROR: Config files found in directory %s. Please move them into the Marlin subfolder." % p
			raise SystemExit(err)