extends SceneTree

## 无头测试入口。
##
## 用法：
##   godot --headless --path . --script res://tests/run_tests.gd
##
## 约定：tests/test_*.gd 继承 TestCase，其中 test_ 开头的方法会被执行。
## 不依赖 autoload —— 测试直接 preload 被测类，确保可在 --script 模式下运行。

const TEST_DIR := "res://tests"
const TEST_PREFIX := "test_"
const TEST_SUFFIX := ".gd"
## 断言基类所在文件，不作为测试用例收集
const BASE_CASE_FILE := "test_case.gd"

var _passed := 0
var _failed := 0
var _skipped := 0
var _assertions := 0
var _failures: Array[String] = []
var _current := ""


var _started := false


## 注意：不能在 _initialize() 里跑测试。
## 那时 root Window 尚未真正进入场景树，HTTPRequest.request() 会返回
## ERR_UNCONFIGURED(3)，导致所有网络相关测试假失败。改在首帧 _process 中启动。
func _initialize() -> void:
	pass


func _process(_delta: float) -> bool:
	# 必须始终返回 false：只要测试里有 await（例如真实 HTTP 请求），
	# 协程就会跨帧挂起；此时若返回 true，主循环会立刻退出，
	# 测试被拦腰截断且悄无声息（同步测试因为不跨帧，一直掩盖了这个缺陷）。
	# 结束由 _run_all() 内的 quit() 负责。
	if not _started:
		_started = true
		_run_all()
	return false


func _run_all() -> void:
	var files := _discover_tests()
	if files.is_empty():
		print("未发现任何测试文件")
		quit(1)
		return

	print("")
	print("== OpenDance Studio Windows 客户端 —— 单元测试 ==")
	print("")

	for path in files:
		await _run_file(path)

	print("")
	var skip_note := ("，%d 跳过" % _skipped) if _skipped > 0 else ""
	print("== 结果：%d 通过 / %d 失败%s ==" % [_passed, _failed, skip_note])
	if _failed > 0:
		print("")
		print("失败明细：")
		for line in _failures:
			print("  ✗ %s" % line)
		print("")
		quit(1)
	else:
		print("全部通过")
		print("")
		quit(0)


func _discover_tests() -> Array[String]:
	var out: Array[String] = []
	var dir := DirAccess.open(TEST_DIR)
	if dir == null:
		push_error("无法打开 %s" % TEST_DIR)
		return out
	dir.list_dir_begin()
	var name := dir.get_next()
	while name != "":
		if not dir.current_is_dir() and name.begins_with(TEST_PREFIX) and name.ends_with(TEST_SUFFIX) and name != BASE_CASE_FILE:
			out.append("%s/%s" % [TEST_DIR, name])
		name = dir.get_next()
	dir.list_dir_end()
	out.sort()
	return out


func _run_file(path: String) -> void:
	var case_name := path.get_file().get_basename()
	_current = case_name
	print("[%s]" % case_name)

	var script: GDScript = load(path)
	# 脚本编译失败时 load() 仍返回对象，但 can_instantiate() 为 false。
	# 不做这层检查的话，整个文件会静默贡献 0 个测试而不被察觉。
	if script == null or not script.can_instantiate():
		_record(false, case_name, "测试脚本无法编译/实例化（查看导入日志中的 Parse Error）")
		return

	var instance: Object = script.new()
	if instance == null:
		_record(false, case_name, "测试脚本实例化返回 null")
		return
	# 注入断言上下文
	instance.set("_runner", self)

	var methods: Array[String] = []
	for m in instance.get_method_list():
		var mname: String = m["name"]
		if mname.begins_with("test_") and not methods.has(mname):
			methods.append(mname)
	methods.sort()

	for mname in methods:
		var before_failed := _failed
		var before_skipped := _skipped
		var before_assertions := _assertions
		# call() 对协程返回 GDScriptFunctionState，await 会等到其真正结束；
		# 对普通方法返回值则立即返回。因此同步与异步测试共用一条路径。
		await instance.call(mname)
		if _failed != before_failed or _skipped != before_skipped:
			continue
		# 关键防线：一个测试方法若一条断言都没执行，说明它静默失败了
		# （脚本编译失败、preload 失败、方法内报错提前返回等），一律计为失败，
		# 绝不允许「什么都没做」被记成通过。
		if _assertions == before_assertions:
			_record(false, case_name, "%s 未执行任何断言（疑似脚本编译/加载失败）" % mname)
		else:
			passed("%s.%s" % [case_name, mname], true)


func report_assert(ok: bool, label: String, detail: String) -> void:
	_record(ok, _current, label, detail)


## 跳过当前测试（例如依赖外部服务而该服务不可达）
func report_skip(label: String, reason: String) -> void:
	_skipped += 1
	print("  ⊘ %s — %s" % [label, reason])


func _record(ok: bool, group: String, label: String, detail: String = "") -> void:
	_assertions += 1
	if ok:
		_passed += 1
		print("  ✓ %s" % label)
	else:
		_failed += 1
		var line := "%s > %s" % [group, label]
		if detail != "":
			line += " — %s" % detail
		_failures.append(line)
		print("  ✗ %s%s" % [label, (" — " + detail) if detail != "" else ""])


func passed(label: String, silent: bool = false) -> void:
	if not silent:
		_passed += 1
		print("  ✓ %s" % label)