Auto-build: codeassistant (powershell) from 5472e03

This commit is contained in:
github-actions[bot]
2026-07-26 14:29:12 +00:00
commit 427b01228c
321 changed files with 157107 additions and 0 deletions
@@ -0,0 +1,541 @@
# xdto-edit v1.0 — Point edits of a 1C XDTO package (Python port)
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
import argparse
import json
import os
import re
import shutil
import subprocess
import sys
import tempfile
import uuid
from lxml import etree
sys.stdout.reconfigure(encoding="utf-8")
sys.stderr.reconfigure(encoding="utf-8")
XDTO_NS = "http://v8.1c.ru/8.1/xdto"
XS_NS = "http://www.w3.org/2001/XMLSchema"
MD_NS = "http://v8.1c.ru/8.3/MDClasses"
V8_NS = "http://v8.1c.ru/8.1/data/core"
OPS = ["add-property", "replace-property", "remove-property", "add-type", "remove-type",
"add-enum", "add-import", "rename", "set-synonym", "set-comment", "set-namespace"]
parser = argparse.ArgumentParser(allow_abbrev=False)
parser.add_argument("-PackagePath", "-Path", required=True)
parser.add_argument("-Operation", required=True, choices=OPS)
parser.add_argument("-Target", default="")
parser.add_argument("-Value", default="")
parser.add_argument("-NoValidate", action="store_true")
args = parser.parse_args()
def die(msg):
print(msg, file=sys.stderr)
sys.exit(1)
def local(el):
return etree.QName(el).localname
def _parse_xml(source, from_string=False):
"""Разбор с узким отступлением для не-URI пространств имён.
Платформа допускает в targetNamespace произвольную строку, .NET такое принимает,
а libxml2 отвергает. Откатываемся на восстанавливающий разбор ТОЛЬКО на этой ошибке.
"""
try:
return (etree.fromstring(source) if from_string else etree.parse(source))
except etree.XMLSyntaxError as e:
if "is not a valid URI" not in str(e):
raise
p = etree.XMLParser(recover=True)
return (etree.fromstring(source, p) if from_string else etree.parse(source, p))
# ── support guard ────────────────────────────────────────────
# См. docs/1c-support-state-spec.md.
def find_v8_project(start_dir):
d = os.path.abspath(start_dir)
for _ in range(20):
pj = os.path.join(d, ".v8-project.json")
if os.path.exists(pj):
return pj
parent = os.path.dirname(d)
if parent == d:
break
d = parent
return None
def get_edit_mode(cfg_dir):
try:
pj = find_v8_project(cfg_dir)
if pj:
with open(pj, encoding="utf-8-sig") as f:
return str(json.load(f).get("editingAllowedCheck") or "deny")
except Exception: # noqa: BLE001
pass
return "deny"
def is_external_object_root(xml_path):
try:
for el in _parse_xml(xml_path).getroot():
if isinstance(el.tag, str):
return local(el) in ("ExternalDataProcessor", "ExternalReport")
except Exception: # noqa: BLE001
pass
return False
def assert_edit_allowed(target_path):
d = os.path.abspath(target_path)
for _ in range(20):
try:
for f in os.listdir(d):
if f.endswith(".xml") and is_external_object_root(os.path.join(d, f)):
return
except OSError:
pass
if os.path.exists(os.path.join(d, "Configuration.xml")):
if os.path.exists(os.path.join(d, "Ext", "ParentConfigurations.bin")):
mode = get_edit_mode(d)
if mode == "off":
return
msg = ("Конфигурация находится на поддержке (Ext/ParentConfigurations.bin). "
"Правка может быть запрещена.")
if mode == "warn":
print("WARNING: " + msg, file=sys.stderr)
return
die(msg + " Снимите с поддержки (/support-edit) или задайте "
"editingAllowedCheck в .v8-project.json.")
return
parent = os.path.dirname(d)
if parent == d:
break
d = parent
# ── resolve package ──────────────────────────────────────────
package_path = os.path.abspath(args.PackagePath)
pkg_dir = None
if os.path.isdir(package_path):
if os.path.exists(os.path.join(package_path, "Ext", "Package.bin")):
pkg_dir = package_path
elif os.path.isfile(package_path) and os.path.basename(package_path) == "Package.bin":
pkg_dir = os.path.dirname(os.path.dirname(package_path))
elif package_path.endswith(".xml"):
stem = os.path.join(os.path.dirname(package_path),
os.path.splitext(os.path.basename(package_path))[0])
if os.path.exists(os.path.join(stem, "Ext", "Package.bin")):
pkg_dir = stem
if not pkg_dir:
die(f"Не найден пакет XDTO по пути: {package_path}")
pkg_name = os.path.basename(pkg_dir.rstrip("\\/"))
xdto_root = os.path.dirname(pkg_dir)
config_root = os.path.dirname(xdto_root)
bin_file = os.path.join(pkg_dir, "Ext", "Package.bin")
md_file = os.path.join(xdto_root, pkg_name + ".xml")
config_xml = os.path.join(config_root, "Configuration.xml")
# -Value "@путь" — содержимое берётся из файла. Передавать XSD-фрагмент инлайном
# ненадёжно: вложенные кавычки схлопываются на границе процессов, и вместо понятной
# ошибки получается сырой сбой разбора XML.
if args.Value.startswith("@"):
value_file = args.Value[1:]
if not os.path.isabs(value_file):
value_file = os.path.join(os.getcwd(), value_file)
if not os.path.isfile(value_file):
die("Файл значения не найден: " + value_file)
with open(value_file, encoding="utf-8-sig") as f:
args.Value = f.read().strip()
assert_edit_allowed(pkg_dir)
SKILLS = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
DECOMPILE = os.path.join(SKILLS, "xdto-decompile", "scripts", "xdto-decompile.py")
COMPILE = os.path.join(SKILLS, "xdto-compile", "scripts", "xdto-compile.py")
VALIDATE = os.path.join(SKILLS, "xdto-validate", "scripts", "xdto-validate.py")
# Исключение из автономности навыков, сделанное осознанно: конвертер XSD <-> модель
# нельзя скопировать буквально (xdto-compile — скрипт со сквозным потоком, не библиотека),
# а вторая его реализация разошлась бы с первой. Обещание «правка не меняет ни байта
# в нетронутом» держится именно на том, что код тот же самый.
# Проверяем комплектность заранее, чтобы не падать на середине правки.
def assert_siblings_present(operation):
needed = {}
if operation not in ("rename", "set-synonym", "set-comment"):
needed["xdto-decompile"] = DECOMPILE
needed["xdto-compile"] = COMPILE
missing = [k for k, v in needed.items() if not os.path.exists(v)]
if missing:
die("Навык неработоспособен: рядом нет " + ", ".join(missing) + ".\n"
+ f'Операция "{operation}" выполняется через '
+ ("них" if len(missing) > 1 else "него") + ".\n"
+ "Ожидаются в каталоге навыков: " + SKILLS)
def invoke_sibling(script, argv, what):
if not os.path.exists(script):
die(f"Не найден навык {what} по пути: {script}")
r = subprocess.run([sys.executable, script, *argv], capture_output=True, text=True, encoding="utf-8")
if r.returncode != 0:
die(f"{what} завершился с ошибкой:\n{(r.stderr or '') + (r.stdout or '')}")
return r.stdout
def save_xml(doc, path):
raw = etree.tostring(doc, xml_declaration=True, encoding="UTF-8")
with open(path, "wb") as f:
f.write(b"\xef\xbb\xbf" + raw)
# ── metadata object edits ────────────────────────────────────
def edit_metadata(field, new_value):
doc = _parse_xml(md_file)
props = doc.find(f".//{{{MD_NS}}}XDTOPackage/{{{MD_NS}}}Properties")
if props is None:
die("В объекте метаданных не найден блок <Properties>")
if field in ("Name", "Namespace"):
el = props.find(f"{{{MD_NS}}}{field}")
if el is None:
die(f"В объекте метаданных нет <{field}>")
el.text = new_value
elif field == "Comment":
el = props.find(f"{{{MD_NS}}}Comment")
if el is None:
el = etree.SubElement(props, f"{{{MD_NS}}}Comment")
el.text = new_value
elif field == "Synonym":
syn = props.find(f"{{{MD_NS}}}Synonym")
if syn is None:
syn = etree.SubElement(props, f"{{{MD_NS}}}Synonym")
item = None
for it in syn.iterfind(f"{{{V8_NS}}}item"):
lg = it.find(f"{{{V8_NS}}}lang")
if lg is not None and (lg.text or "") == "ru":
item = it
break
if item is None:
item = etree.SubElement(syn, f"{{{V8_NS}}}item")
etree.SubElement(item, f"{{{V8_NS}}}lang").text = "ru"
etree.SubElement(item, f"{{{V8_NS}}}content")
item.find(f"{{{V8_NS}}}content").text = new_value
save_xml(doc, md_file)
def rename_package(new_name):
global pkg_name, pkg_dir
# \w с re.UNICODE уже покрывает кириллицу; явные диапазоны только плодят ошибки
if not re.match(r"^\w+$", new_name, re.UNICODE) or re.match(r"^\d", new_name):
die(f'"{new_name}" не является допустимым идентификатором 1С')
new_md = os.path.join(xdto_root, new_name + ".xml")
new_dir = os.path.join(xdto_root, new_name)
if os.path.exists(new_md) or os.path.exists(new_dir):
die(f'Имя "{new_name}" уже занято другим пакетом')
edit_metadata("Name", new_name)
shutil.move(md_file, new_md)
shutil.move(pkg_dir, new_dir)
if os.path.exists(config_xml):
cfg = _parse_xml(config_xml)
found = False
for e in cfg.iterfind(f".//{{{MD_NS}}}Configuration/{{{MD_NS}}}ChildObjects/{{{MD_NS}}}XDTOPackage"):
if (e.text or "") == pkg_name:
e.text = new_name
found = True
break
if found:
save_xml(cfg, config_xml)
print(f" Configuration.xml: <XDTOPackage> переименован в {new_name}")
else:
print(f"WARNING: В Configuration.xml не найдена запись <XDTOPackage>{pkg_name}</XDTOPackage> — "
"зарегистрируйте пакет вручную", file=sys.stderr)
print(f"✓ Пакет переименован: {pkg_name}{new_name}")
print(f" Перемещены: {new_name}.xml, {new_name}/")
pkg_name = new_name
pkg_dir = new_dir
# ── model edits through the XSD round-trip ───────────────────
def xs_children(el, name):
return [c for c in el if isinstance(c.tag, str)
and etree.QName(c).namespace == XS_NS and local(c) == name]
def xs_first(el, name):
r = xs_children(el, name)
return r[0] if r else None
def find_type_element(schema, type_name):
for kind in ("complexType", "simpleType"):
for t in xs_children(schema, kind):
if t.get("name") == type_name:
return t
die(f'В пакете нет типа "{type_name}"')
def get_type_body(ct):
content = xs_first(ct, "complexContent")
if content is not None:
ext = xs_first(content, "extension")
if ext is not None:
return ext
return ct
def find_declaration(body, prop_name):
for node in body.iter():
if not isinstance(node.tag, str) or etree.QName(node).namespace != XS_NS:
continue
if local(node) in ("element", "attribute") and node.get("name") == prop_name:
return node
return None
def resolve_path(schema, path):
# Точка безопасна: имена в модели XDTO — идентификаторы 1С
segments = path.split(".")
type_el = find_type_element(schema, segments[0])
if len(segments) == 1:
return (type_el, None)
body = get_type_body(type_el)
decl = None
for i in range(1, len(segments)):
decl = find_declaration(body, segments[i])
if decl is None:
die(f'По пути "{path}" не найдено свойство "{segments[i]}"')
if i < len(segments) - 1:
inner = xs_first(decl, "complexType")
if inner is None:
die(f'Свойство "{segments[i]}" не содержит вложенного типа — путь дальше не идёт')
body = get_type_body(inner)
return (type_el, decl)
def import_fragment(schema, xml):
ns = {"xs": XS_NS, "xdto": XDTO_NS}
tns = schema.get("targetNamespace")
if tns:
ns["tns"] = tns
for px, uri in schema.nsmap.items():
if px and px not in ns:
ns[px] = uri
decls = " ".join(f'xmlns:{k}="{v}"' for k, v in ns.items())
try:
wrapped = etree.fromstring(f"<wrap {decls}>{xml}</wrap>".encode("utf-8"))
except etree.XMLSyntaxError as e:
die("Не удалось разобрать -Value как фрагмент XML-схемы: " + str(e) + "\n"
+ "Получено: " + xml + "\n"
+ "Если фрагмент передан инлайном, кавычки могли схлопнуться на границе "
'процессов — положите его в файл и укажите -Value "@путь".')
res = [c for c in wrapped if isinstance(c.tag, str)]
if not res:
die(f"Во фрагменте нет ни одного элемента: {xml}")
return res
def apply_model_operation(schema):
op = args.Operation
if op == "add-property":
if not args.Target:
die("add-property требует -Target <Тип>")
type_el, decl = resolve_path(schema, args.Target)
host = xs_first(decl, "complexType") if decl is not None else type_el
body = get_type_body(host)
for frag in import_fragment(schema, args.Value):
kind = local(frag)
if kind == "attribute":
body.append(frag)
elif kind == "element":
# Явные is not None: пустой <xs:sequence/> в lxml ложен,
# и через "or" мы бы создали вторую частицу
particle = xs_first(body, "sequence")
if particle is None:
particle = xs_first(body, "choice")
if particle is None:
particle = xs_first(body, "all")
if particle is None:
particle = etree.Element(f"{{{XS_NS}}}sequence")
first_attr = xs_first(body, "attribute")
if first_attr is not None:
first_attr.addprevious(particle)
else:
body.append(particle)
particle.append(frag)
else:
die(f"add-property ожидает <xs:element> или <xs:attribute>, получен <xs:{kind}>")
print(f' + {frag.get("name")} в тип {args.Target}')
elif op == "replace-property":
if not args.Target:
die('replace-property требует -Target "Тип.Свойство"')
_, decl = resolve_path(schema, args.Target)
if decl is None:
die('replace-property требует путь вида "Тип.Свойство"')
frags = import_fragment(schema, args.Value)
if len(frags) != 1:
die("replace-property ожидает ровно одно объявление")
decl.getparent().replace(decl, frags[0])
print(f" ~ {args.Target} заменено")
elif op == "remove-property":
if not args.Target:
die('remove-property требует путь "Тип.Свойство"')
for one in [x.strip() for x in args.Target.split(";;") if x.strip()]:
_, decl = resolve_path(schema, one)
if decl is None:
die(f'remove-property требует путь вида "Тип.Свойство", получено "{one}"')
decl.getparent().remove(decl)
print(f" {one} удалено")
elif op == "add-type":
for frag in import_fragment(schema, args.Value):
if local(frag) not in ("complexType", "simpleType"):
die(f"add-type ожидает <xs:complexType> или <xs:simpleType>, получен <xs:{local(frag)}>")
schema.append(frag)
print(f' + тип {frag.get("name")}')
elif op == "remove-type":
if not args.Target:
die("remove-type требует -Target <Тип>")
for one in [x.strip() for x in args.Target.split(";;") if x.strip()]:
t = find_type_element(schema, one)
t.getparent().remove(t)
print(f" тип {one} удалён")
elif op == "add-enum":
if not args.Target:
die("add-enum требует -Target <ТипЗначения>")
t = find_type_element(schema, args.Target)
restriction = xs_first(t, "restriction")
if restriction is None:
die(f'Тип "{args.Target}" не является ограничением простого типа')
for lit in [x.strip() for x in args.Value.split(";;") if x.strip()]:
e = etree.SubElement(restriction, f"{{{XS_NS}}}enumeration")
e.set("value", lit)
print(f' + значение "{lit}" в тип {args.Target}')
elif op == "add-import":
for uri in [x.strip() for x in args.Value.split(";;") if x.strip()]:
if any(i.get("namespace") == uri for i in xs_children(schema, "import")):
print(f" = импорт {uri} уже объявлен")
continue
imp = etree.Element(f"{{{XS_NS}}}import")
imp.set("namespace", uri)
first_other = next((c for c in schema if isinstance(c.tag, str)
and local(c) not in ("annotation", "import")), None)
if first_other is not None:
first_other.addprevious(imp)
else:
schema.append(imp)
print(f" + импорт {uri}")
elif op == "set-namespace":
if not args.Value:
die("set-namespace требует -Value <URI>")
old = schema.get("targetNamespace")
if old == args.Value:
# Установка того же значения не отбрасывается: пакет пересобирается вхолостую
print(f" = namespace уже {args.Value}, пакет пересобран без изменений")
else:
print(f" ~ namespace: {old}{args.Value}")
# Меняем и targetNamespace, и объявление префикса, который на него указывал
new_nsmap = {px: (args.Value if uri == old else uri) for px, uri in schema.nsmap.items()}
rebuilt = etree.Element(schema.tag, nsmap=new_nsmap)
for k, v in schema.attrib.items():
rebuilt.set(k, v)
rebuilt.set("targetNamespace", args.Value)
rebuilt.text = schema.text
for c in list(schema):
rebuilt.append(c)
return rebuilt
return schema
# ── dispatch ─────────────────────────────────────────────────
assert_siblings_present(args.Operation)
print(f"Пакет: {pkg_name}")
old_namespace = None
if args.Operation == "rename":
if not args.Value:
die("rename требует -Value <НовоеИмя>")
rename_package(args.Value)
elif args.Operation == "set-synonym":
if not args.Value:
die("set-synonym требует -Value <текст>")
edit_metadata("Synonym", args.Value)
print(f"✓ Синоним: {args.Value}")
elif args.Operation == "set-comment":
edit_metadata("Comment", args.Value)
print("✓ Комментарий обновлён")
else:
tmp_dir = tempfile.mkdtemp(prefix="xdto-edit_")
try:
xsd_path = os.path.join(tmp_dir, "schema.xsd")
invoke_sibling(DECOMPILE, ["-PackagePath", bin_file, "-OutFile", xsd_path], "xdto-decompile")
doc = _parse_xml(xsd_path)
schema = doc.getroot()
old_namespace = schema.get("targetNamespace")
schema = apply_model_operation(schema)
with open(xsd_path, "wb") as f:
f.write(etree.tostring(schema, xml_declaration=True, encoding="UTF-8"))
invoke_sibling(COMPILE, ["-XsdPath", xsd_path, "-OutputDir", config_root,
"-Name", pkg_name, "-Force"], "xdto-compile")
if args.Operation == "set-namespace":
edit_metadata("Namespace", args.Value)
# Зависящие пакеты не трогаем: при версионировании они обязаны продолжать
# смотреть на прежний namespace. Но молчать о них нельзя.
dependents = []
for d in sorted(os.listdir(xdto_root)):
if d == pkg_name or not os.path.isdir(os.path.join(xdto_root, d)):
continue
ob = os.path.join(xdto_root, d, "Ext", "Package.bin")
if not os.path.exists(ob):
continue
try:
for imp in _parse_xml(ob).getroot():
if isinstance(imp.tag, str) and local(imp) == "import" \
and imp.get("namespace") == old_namespace:
dependents.append(d)
break
except Exception: # noqa: BLE001
pass
if dependents:
print("")
print(f"WARNING: Старый namespace импортируют пакеты ({len(dependents)}): "
+ ", ".join(dependents)
+ ". Они не изменены — при версионировании это верно; "
"если нет, поправьте их импорты.", file=sys.stderr)
print(f"✓ Пакет пересобран: XDTOPackages/{pkg_name}/Ext/Package.bin")
finally:
shutil.rmtree(tmp_dir, ignore_errors=True)
if not args.NoValidate:
if os.path.exists(VALIDATE):
print("")
print("--- xdto-validate ---")
subprocess.run([sys.executable, VALIDATE, "-PackagePath", os.path.join(xdto_root, pkg_name)])
else:
print(f"[SKIP] xdto-validate не найден: {VALIDATE}")
sys.exit(0)