fix(template-add,help-add): закрыть находки ревью по коду языка и странице

help-add терял текст справки. Отказ смотрит только на Help.xml, а страница может пережить его (удалённый дескриптор, частичная выгрузка, справка, сделанная руками): тогда запись шла безусловно и стирала содержимое с кодом 0 и рапортом [OK]. Теперь существующая страница сохраняется, создаётся только дескриптор — та же защита, что уже стоит в template-add. Прежняя оценка «в help-add потери данных нет» была неверной: она опиралась на чтение кода, а не на замер. Код языка: регулярка пропускала имена устройств Windows. При -Lang nul py-порт молча писал <Page>nul</Page> и пустой каталог с кодом 0 (страница уходила в NUL), а PS падал исключением — то есть порты ещё и расходились. Якоря \A…\z вместо ^…$: последние в обоих языках допускают перевод строки в конце. Проверка вынесена в Test-LangCode / is_valid_lang и внесена в реестр check-inline-drift: inline-блок гард не видел, а копий у него две. Плюс мелочи оттуда же: мёртвый дизъюнкт в $pageExists убран; полумигрированное дерево (дескриптор есть, старый Ext/Template.html остался рядом) теперь получает предупреждение, а не молчание; существование страницы в py сверяется без учёта регистра — иначе на Linux -Lang RU писал бы вторую страницу мимо дескриптора. Четыре кейса на каждый сценарий. Существующие эталоны не сдвинулись. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-24 11:15:53 +03:00 · 2026-09-22 18:50:58 +03:00
parent c619da4a0a
commit dc470a3803
20 changed files with 359 additions and 31 deletions
@@ -0,0 +1,20 @@
+{
+  "name": "Зарезервированное имя устройства как код языка отвергается",
+  "preRun": [
+    {
+      "script": "epf-init/scripts/init",
+      "args": {
+        "-Name": "МояОбработка",
+        "-SrcDir": "{workDir}"
+      }
+    }
+  ],
+  "params": {
+    "objectName": "МояОбработка"
+  },
+  "args_extra": [
+    "-Lang",
+    "con"
+  ],
+  "expectError": "Недопустимый код языка"
+}
@@ -0,0 +1,41 @@
+{
+  "name": "Страница справки без дескриптора: содержимое не затирается",
+  "preRun": [
+    {
+      "script": "epf-init/scripts/init",
+      "args": {
+        "-Name": "МояОбработка",
+        "-SrcDir": "{workDir}"
+      }
+    },
+    {
+      "script": "help-add/scripts/add-help",
+      "args": {
+        "-ObjectName": "МояОбработка",
+        "-SrcDir": "{workDir}"
+      }
+    },
+    {
+      "deletePath": "МояОбработка/Ext/Help.xml"
+    },
+    {
+      "writeFile": {
+        "path": "МояОбработка/Ext/Help/ru.html",
+        "content": "ЖИВОЙ_ТЕКСТ_СПРАВКИ"
+      }
+    }
+  ],
+  "params": {
+    "objectName": "МояОбработка"
+  },
+  "expect": {
+    "stdoutContains": [
+      "[WARN]",
+      "содержимое сохранено"
+    ],
+    "fileContains": {
+      "file": "МояОбработка/Ext/Help/ru.html",
+      "text": "ЖИВОЙ_ТЕКСТ_СПРАВКИ"
+    }
+  }
+}
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+	<ExternalDataProcessor uuid="UUID-001">
+		<InternalInfo>
+			<xr:ContainedObject>
+				<xr:ClassId>UUID-002</xr:ClassId>
+				<xr:ObjectId>UUID-003</xr:ObjectId>
+			</xr:ContainedObject>
+			<xr:GeneratedType name="ExternalDataProcessorObject.МояОбработка" category="Object">
+				<xr:TypeId>UUID-004</xr:TypeId>
+				<xr:ValueId>UUID-005</xr:ValueId>
+			</xr:GeneratedType>
+		</InternalInfo>
+		<Properties>
+			<Name>МояОбработка</Name>
+			<Synonym>
+				<v8:item>
+					<v8:lang>ru</v8:lang>
+					<v8:content>МояОбработка</v8:content>
+				</v8:item>
+			</Synonym>
+			<Comment/>
+			<DefaultForm/>
+			<AuxiliaryForm/>
+		</Properties>
+		<ChildObjects/>
+	</ExternalDataProcessor>
+</MetaDataObject>
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Help xmlns="http://v8.1c.ru/8.3/xcf/extrnprops" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+	<Page>ru</Page>
+</Help>
@@ -0,0 +1 @@
+ЖИВОЙ_ТЕКСТ_СПРАВКИ
@@ -0,0 +1,11 @@
+#Область ОписаниеПеременных
+
+#КонецОбласти
+
+#Область ПрограммныйИнтерфейс
+
+#КонецОбласти
+
+#Область СлужебныеПроцедурыИФункции
+
+#КонецОбласти
@@ -0,0 +1,22 @@
+{
+  "name": "Зарезервированное имя устройства как код языка отвергается",
+  "preRun": [
+    {
+      "script": "epf-init/scripts/init",
+      "args": {
+        "-Name": "МояОбработка",
+        "-SrcDir": "{workDir}"
+      }
+    }
+  ],
+  "params": {
+    "objectName": "МояОбработка",
+    "templateName": "МакетHTML",
+    "templateType": "HTML"
+  },
+  "args_extra": [
+    "-Lang",
+    "nul"
+  ],
+  "expectError": "Недопустимый код языка"
+}
@@ -0,0 +1,42 @@
+{
+  "name": "Дескриптор есть, старый Template.html остался рядом: предупреждение",
+  "preRun": [
+    {
+      "script": "epf-init/scripts/init",
+      "args": {
+        "-Name": "МояОбработка",
+        "-SrcDir": "{workDir}"
+      }
+    },
+    {
+      "script": "template-add/scripts/add-template",
+      "args": {
+        "-ObjectName": "МояОбработка",
+        "-TemplateName": "МакетHTML",
+        "-TemplateType": "HTML",
+        "-SrcDir": "{workDir}"
+      }
+    },
+    {
+      "writeFile": {
+        "path": "МояОбработка/Templates/МакетHTML/Ext/Template.html",
+        "content": "ЗАБЫТЫЙ_ФАЙЛ"
+      }
+    }
+  ],
+  "params": {
+    "objectName": "МояОбработка",
+    "templateName": "МакетHTML",
+    "templateType": "HTML"
+  },
+  "args_extra": [
+    "-Lang",
+    "en"
+  ],
+  "expect": {
+    "stdoutContains": [
+      "[WARN]",
+      "Рядом лежит старый"
+    ]
+  }
+}
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+	<ExternalDataProcessor uuid="UUID-001">
+		<InternalInfo>
+			<xr:ContainedObject>
+				<xr:ClassId>UUID-002</xr:ClassId>
+				<xr:ObjectId>UUID-003</xr:ObjectId>
+			</xr:ContainedObject>
+			<xr:GeneratedType name="ExternalDataProcessorObject.МояОбработка" category="Object">
+				<xr:TypeId>UUID-004</xr:TypeId>
+				<xr:ValueId>UUID-005</xr:ValueId>
+			</xr:GeneratedType>
+		</InternalInfo>
+		<Properties>
+			<Name>МояОбработка</Name>
+			<Synonym>
+				<v8:item>
+					<v8:lang>ru</v8:lang>
+					<v8:content>МояОбработка</v8:content>
+				</v8:item>
+			</Synonym>
+			<Comment/>
+			<DefaultForm/>
+			<AuxiliaryForm/>
+		</Properties>
+		<ChildObjects>
+			<Template>МакетHTML</Template>
+		</ChildObjects>
+	</ExternalDataProcessor>
+</MetaDataObject>
@@ -0,0 +1,11 @@
+#Область ОписаниеПеременных
+
+#КонецОбласти
+
+#Область ПрограммныйИнтерфейс
+
+#КонецОбласти
+
+#Область СлужебныеПроцедурыИФункции
+
+#КонецОбласти
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<MetaDataObject xmlns="http://v8.1c.ru/8.3/MDClasses" xmlns:app="http://v8.1c.ru/8.2/managed-application/core" xmlns:cfg="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:cmi="http://v8.1c.ru/8.2/managed-application/cmi" xmlns:ent="http://v8.1c.ru/8.1/data/enterprise" xmlns:lf="http://v8.1c.ru/8.2/managed-application/logform" xmlns:style="http://v8.1c.ru/8.1/data/ui/style" xmlns:sys="http://v8.1c.ru/8.1/data/ui/fonts/system" xmlns:v8="http://v8.1c.ru/8.1/data/core" xmlns:v8ui="http://v8.1c.ru/8.1/data/ui" xmlns:web="http://v8.1c.ru/8.1/data/ui/colors/web" xmlns:win="http://v8.1c.ru/8.1/data/ui/colors/windows" xmlns:xen="http://v8.1c.ru/8.3/xcf/enums" xmlns:xpr="http://v8.1c.ru/8.3/xcf/predef" xmlns:xr="http://v8.1c.ru/8.3/xcf/readable" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+	<Template uuid="UUID-001">
+		<Properties>
+			<Name>МакетHTML</Name>
+			<Synonym>
+				<v8:item>
+					<v8:lang>ru</v8:lang>
+					<v8:content>МакетHTML</v8:content>
+				</v8:item>
+			</Synonym>
+			<Comment/>
+			<TemplateType>HTMLDocument</TemplateType>
+		</Properties>
+	</Template>
+</MetaDataObject>
@@ -0,0 +1 @@
+ЗАБЫТЫЙ_ФАЙЛ
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Help xmlns="http://v8.1c.ru/8.3/xcf/extrnprops" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.17">
+	<Page>en</Page>
+	<Page>ru</Page>
+</Help>
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta></head><body>
+</body></html>
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta></head><body>
+</body></html>
@@ -184,6 +184,15 @@ const FAMILIES = [
        consumersPy: ['cfe-borrow'] },
    ],
  },
+  // ─── Код языка страницы ──────────────────────────────────────────────────
+  // Формат «дескриптор + страница» общий у справки объекта и HTML-макета, поэтому проверка
+  // кода языка обязана быть одна и та же: он идёт и в текст XML, и в имя файла.
+  {
+    name: 'is_valid_lang', py: 'is_valid_lang', ps1: 'Test-LangCode',
+    variants: [
+      { id: 'base', authority: 'template-add', consumers: ['help-add'] },
+    ],
+  },
  {
    name: 'write_utf8_bom', py: 'write_utf8_bom', ps1: null,
    variants: [