#!/usr/bin/env python from argparse import ArgumentParser, BooleanOptionalAction import sys from .pipeline import ConvertRequest, convert, should_launch_gui from .profiles import ( DEFAULT_HEADING_NUMBERING, DEFAULT_TABLE_CONTINUATION, DEFAULT_LISTING_CONTINUATION, DEFAULT_TOC_MODE, DOC_TYPES, HEADING_NUMBERING_MODES, TABLE_CONTINUATION_MODES, LISTING_CONTINUATION_MODES, TOC_MODES, ) def build_parser() -> ArgumentParser: parser = ArgumentParser( prog="md2gost", description=( "Генерация DOCX-отчётов из Markdown по ТЗ МИРЭА / ГОСТ. " "Типы: coursework/practice/vkr, APID_coursework, PIS_custom. " "Без файла или с --gui открывается окно. " "FODT: python -m md2fodt …" ), ) parser.add_argument( "filename", nargs="?", help="Путь до .md (или .docx с --check-pages). Без файла открывается GUI", ) parser.add_argument( "--gui", action="store_true", help="Открыть графический интерфейс (можно сразу передать .md)", ) parser.add_argument("-o", "--output", help="Путь до сгенерированного .docx") parser.add_argument("-t", "--template", help="Путь до шаблона .docx") parser.add_argument( "--type", dest="doc_type", choices=DOC_TYPES, default="practice", help="Тип: practice | coursework | vkr | PIS_custom | APID_coursework (по умолчанию practice)", ) parser.add_argument( "--heading-numbering", choices=HEADING_NUMBERING_MODES, default=DEFAULT_HEADING_NUMBERING, help=( "Нумерация заголовков разделов: " "manual — цифры из markdown (# 1 … / ## 1.1 …), автонумерация Word отключена; " "auto — нумерует Word, цифры в начале заголовка md снимаются. " f"По умолчанию: {DEFAULT_HEADING_NUMBERING}." ), ) parser.add_argument( "--toc", choices=TOC_MODES, default=DEFAULT_TOC_MODE, help=( "Содержание: native — встроенное поле Word TOC (обновить при открытии); " "manual — собрать в md2gost с номерами страниц из layout. " f"По умолчанию: {DEFAULT_TOC_MODE}." ), ) parser.add_argument( "--table-continuation", choices=TABLE_CONTINUATION_MODES, default=DEFAULT_TABLE_CONTINUATION, help=( "Таблицы длиннее страницы: " "word — после сохранения Word COM режет по реальной пагинации + «Продолжение…» " "(по умолчанию; нужны Windows, Word, pywin32); " "off/soft — одна таблица, пагинация Word, без авто«Продолжение»; " "legacy/caption — режем по оценке высоты и вставляем «Продолжение…» " "(оценка ≠ Word, возможны артефакты). " f"По умолчанию: {DEFAULT_TABLE_CONTINUATION}." ), ) parser.add_argument( "--listing-continuation", choices=LISTING_CONTINUATION_MODES, default=DEFAULT_LISTING_CONTINUATION, help=( "Листинги длиннее страницы: " "word — после сохранения Word COM + «Продолжение Листинга…» " "(по умолчанию; нужны Windows, Word, pywin32); " "off/soft — один блок, пагинация Word, без авто«Продолжение»; " "legacy/caption — режем по оценке высоты и вставляем «Продолжение Листинга…» " "(оценка ≠ Word, возможны артефакты). " f"По умолчанию: {DEFAULT_LISTING_CONTINUATION}." ), ) parser.add_argument( "--table-repeat-header", action=BooleanOptionalAction, default=False, help=( "При --table-continuation word: повторять шапку таблицы на каждом фрагменте " "после разрыва. По умолчанию выкл." ), ) parser.add_argument( "--emdash-to-hyphen", action=BooleanOptionalAction, default=False, help=( "Автозамена типографского тире «—» на дефис «-» в тексте и подписях. " "По умолчанию выключено (тире «—» по методичке); включить: --emdash-to-hyphen." ), ) parser.add_argument( "--hr-pagebreak", action=BooleanOptionalAction, default=False, help=( "Строка «---» / «***» / «___» — разрыв страницы Word. " "По умолчанию такие строки игнорируются; включить: --hr-pagebreak." ), ) parser.add_argument("--title", help="DOCX титульного листа (вставляется перед телом)") parser.add_argument("--assignment", help="DOCX бланка задания") parser.add_argument("--check", help="Проверить markdown по ТЗ и вывести отчёт", action="store_true") parser.add_argument("--check-only", help="Только проверка, без генерации документа", action="store_true") parser.add_argument( "--check-pages", help=( "После конвертации (или для готового .docx) проверить полупустые страницы " "через Microsoft Word. Эвристика — возможны ложные срабатывания. " "Нужны Windows, Word и pywin32." ), action="store_true", ) parser.add_argument("--strict", help="Код выхода 1 при ошибках проверки", action="store_true") parser.add_argument("--syntax-highlighting", help="Подсветка синтаксиса в листингах", action=BooleanOptionalAction) parser.add_argument( "--plantuml-jar", help="Путь к plantuml.jar (иначе env PLANTUML_JAR)", ) parser.add_argument( "--kroki-url", help="URL локального Kroki (иначе env KROKI_URL, default http://localhost:8000)", ) parser.add_argument( "--diagram-fallback", choices=["local", "remote", "off"], default="remote", help="Если локальный рендер UML недоступен: remote (kroki.io), local (ошибка), off", ) parser.add_argument( "--diagram-format", choices=["png", "svg"], default="png", help="Формат схем в Word: png (по умолчанию) или svg (вектор + PNG-запасной, Word 2016+)", ) parser.add_argument( "--diagram-scale", type=float, default=2.0, help="Масштаб рендера PlantUML PNG (качество); размер на странице как при 1. По умолчанию 2", ) parser.add_argument( "--schemes", dest="schemes_path", help="Путь к md2gost.schemes.json (иначе рядом с приложением / с .md)", ) parser.add_argument("--debug", help="Добавляет отладочные данные в документ", action="store_true") return parser def request_from_args(args) -> ConvertRequest: return ConvertRequest( filename=args.filename or "", output=args.output, template=args.template, doc_type=args.doc_type, heading_numbering=args.heading_numbering, toc_mode=args.toc, table_continuation=args.table_continuation, listing_continuation=args.listing_continuation, table_repeat_header=bool(getattr(args, "table_repeat_header", False)), emdash_to_hyphen=args.emdash_to_hyphen, hr_pagebreak=args.hr_pagebreak, title=args.title, assignment=args.assignment, check=args.check, check_only=args.check_only, check_pages=bool(getattr(args, "check_pages", False)), strict=args.strict, syntax_highlighting=bool(args.syntax_highlighting), plantuml_jar=args.plantuml_jar, kroki_url=args.kroki_url, diagram_fallback=args.diagram_fallback, diagram_format=args.diagram_format, diagram_scale=float(args.diagram_scale), schemes_path=args.schemes_path, debug=args.debug, open_when_done=bool(args.debug), ) def _argv_needs_console(argv: list[str]) -> bool: """Frozen windowed exe: attach a console for CLI / --help, not for GUI.""" args = argv[1:] if not args: return False if "-h" in args or "--help" in args: return True if "--gui" in args: return False return any(not a.startswith("-") for a in args) def _enable_windows_console() -> None: if sys.platform != "win32" or not getattr(sys, "frozen", False): return try: import ctypes kernel32 = ctypes.windll.kernel32 if not kernel32.AttachConsole(0xFFFFFFFF): if not kernel32.GetConsoleWindow(): kernel32.AllocConsole() sys.stdout = open("CONOUT$", "w", encoding="utf-8", errors="replace") sys.stderr = open("CONOUT$", "w", encoding="utf-8", errors="replace") try: sys.stdin = open("CONIN$", "r", encoding="utf-8", errors="replace") except OSError: pass except Exception: pass def main(): if _argv_needs_console(sys.argv): _enable_windows_console() parser = build_parser() args = parser.parse_args() req = request_from_args(args) if should_launch_gui(args.filename, args.gui): from .gui import run_gui run_gui(req) return result = convert(req) sys.exit(result.exit_code) if __name__ == "__main__": main()