diff --git a/scripts/convert_modules.py b/scripts/convert_modules.py index 728f256..09e824b 100644 --- a/scripts/convert_modules.py +++ b/scripts/convert_modules.py @@ -37,10 +37,14 @@ PYW = os.path.join(REPO, 'vendor', 'aalc', '.venv', 'Scripts', 'pythonw.exe') SERVER_PORT = 8765 # --- 坐标(1600x900 基准; lc_ui 会换算到真实客户区) --- +# 合成面板有三个页签, 从左到右: Modules / Use Lunacy / Use Boxes +# Modules (619,283) 免费合成, 本项目只走这条 +# Use Lunacy(797,283) ⛔ 花狂气, 绝对不许点 +# Use Boxes (957,283) 用体力箱, 本项目不用 —— 不定义常量: 定义了却没人用 +# 会让人以为某条路径处理了它, 死代码比没有更糟 MODULE_ICON = (390, 805) # 主界面底栏, 绿胶囊图标(点开合成面板) TAB_MODULES = (619, 283) # 免费合成页签 USE_LUNACY_TAB = (797, 283) # ⛔ 绝对不许点 -TAB_USE_BOXES = (957, 283) # 用体力箱, 本项目不用 BTN_MAX = (1019, 413) # »: 取当前能合成的最大数量 BTN_CONFIRM = (943, 671) # 确认合成 BTN_CANCEL = (656, 670) # 取消 / 关闭面板 diff --git a/tests/test_convert_modules.py b/tests/test_convert_modules.py index 52c9f80..dcadbdd 100644 --- a/tests/test_convert_modules.py +++ b/tests/test_convert_modules.py @@ -514,6 +514,47 @@ class NoRealReportPollutionTest(unittest.TestCase): + ', '.join(offenders)) +class NoDeadConstantsTest(unittest.TestCase): + """顶层的全大写常量必须真的被用到。 + + 删过一个 TAB_USE_BOXES(界面上的第三个页签, 本项目不用) —— 它从来没被引用过。 + 留着它的坏处不是占地方, 而是**会让人以为某条代码路径处理了它**。 + 死代码比没有更糟, 这条测试把口子堵上。 + + 统计范围包含测试文件: 有些常量(比如 USE_LUNACY_TAB)只被测试引用, 那是有意的 + —— 它的存在就是为了让"绝不许点"这件事有个可断言的锚点。 + """ + + def test_every_module_level_constant_is_referenced(self): + import ast + root = Path(__file__).resolve().parents[1] + src = (root / 'scripts' / 'convert_modules.py').read_text(encoding='utf-8') + tree = ast.parse(src) + + names = [] + for node in tree.body: + if isinstance(node, ast.Assign): + for t in node.targets: + if isinstance(t, ast.Name) and t.id.isupper(): + names.append(t.id) + + others = ((root / 'scripts' / 'convert_modules.py').read_text(encoding='utf-8'), + (root / 'tests' / 'test_convert_modules.py').read_text(encoding='utf-8')) + dead = [] + for n in names: + uses = 0 + for text in others: + for line in text.splitlines(): + s = line.strip() + if s.startswith(n + ' =') or s.startswith(n + '='): + continue # 定义行本身不算 + if n in line: + uses += 1 + if uses == 0: + dead.append(n) + self.assertFalse(dead, '这些常量从没被引用过, 请删掉或说明理由: ' + ', '.join(dead)) + + class ForbiddenCoordinateTest(QuietLogMixin, unittest.TestCase): """Use Lunacy 页签的坐标只能用于"确认没点到它", 不能出现在任何点击路径上。 @@ -549,10 +590,14 @@ class ForbiddenCoordinateTest(QuietLogMixin, unittest.TestCase): self.assertFalse(offenders, 'click() 用到了 Use Lunacy 页签坐标: ' + ', '.join(offenders)) def test_the_constant_still_exists_and_is_where_we_think(self): - """万一布局变了, 这条会提醒重新量坐标, 而不是让上面那条静静地失效。""" + """万一布局变了, 这条会提醒重新量坐标, 而不是让上面那条静静地失效。 + + 只锁"我们会点的那个"和"绝不能点的那个"。Use Boxes 的坐标只写在源码注释里 + —— 本项目不用它, 所以不定义常量(定义了却没人用, 会让人以为某条路径处理了它)。 + """ self.assertEqual(cm.USE_LUNACY_TAB, (797, 283)) self.assertLess(cm.TAB_MODULES[0], cm.USE_LUNACY_TAB[0]) # Modules 在左 - self.assertLess(cm.USE_LUNACY_TAB[0], cm.TAB_USE_BOXES[0]) # Use Boxes 在右 + self.assertAlmostEqual(cm.TAB_MODULES[1], cm.USE_LUNACY_TAB[1], delta=5) if __name__ == '__main__':