Просмотр источника
h1. TaskConv: конвертор групповых тестов
h2. _Version 2\+_ Программа переписана на Python. Поддерживается компиляция в EXE (проверено на WinXP и Linux) и проверка текущей конфигурации запуском на примерах (автоматически на виртуальных файлах и вручную на сгенерированных). Все итерации программы (включая исходный код и скомпилированные релизы) можно найти [на GitHub|https://github.com/LeXofLeviafan/TaskConv/releases]. На странице проекта также есть [инструкция по оффлайн-настройке VM с Windows XP для компиляции приложений на Python (до v3.4.4 включительно)|https://github.com/LeXofLeviafan/TaskConv/wiki/Python-compilation-to-executable-on-Windows-XP-(offline)]. h2. _Version 1.2.1_ ([История версий|TaskConv - история версий]) Программа переписана на Java. Для её работы требуется Java 7. h2. Применение *{_}Применение._* Программа [TaskConv|http://dl.gsu.by/images/agulenko/TaskConv-1.2.1.zip] (Task Convertor) запускается из командной строки и принимает следующие параметры: * {{\-h}} ({{\--help}}) - программа выводит краткую справку по параметрам ввода и завершает работу (также выполняется при неправильно заданных параметрах); * {{\-a}} ({{\--auto}}) - программа выбирает тип задачи автоматически при наличии нескольких вариантов (если опция не указана, в этой ситуации запрашивается ввод пользователя); использование {{\-q}} включает эту опцию; * {{\-v}} ({{\--verbose}}) - программа выводит в консоль информацию о выполняемых действиях (используется для контроля работы программы в случае ошибки); * {{\-q}} ({{\--quiet}}) - по эффекту противоположно {{\-v}} (если используются обе опции, эффективна {-v}), отменяет вывод в консоль (по умолчанию выводятся название обрабатываемой папки и сообщение об ошибке/успешном завершении); также включает опцию {{\-a}}; * {{\-m}} ({{\--move}}) - файлы перемещаются без сохранения оригиналов (по умолчанию они копируются); * {{\-k}} ({{\--keep}}) - после перемещения файлов (без {{\-m}} опция не имеет эффекта) пустые папки не удаляются (по умолчанию выполняется рекурсивный поиск и удаление пустых папок); * {{\-i}} ({{\--infiles-only}}) - работать только со входными файлами (для задач без выходных файлов); * {{\-t}} ({{\--type}}) {{TaskType}} \- уточняет имя типа формата задачи (при определении типа программа игнорирует те, которые не начинаются с TaskType; подробнее о типах см. _Конфигурация_); * {{\-o}} ({{\--output}}) {{OutFile}} \- изменяет имя выходного файла программы (по умолчанию {{marks.txt}}); * {{\-n}} ({{\--name}}) {{TaskName}} \- фиксирует значение {{TaskName}} (см. _Конфигурация_); * {{\-d}} ({{\--directory}}) {{TaskDir}} \- задаёт путь к папку с конвертируемой задачей (обязательный параметр); * {{\-l}} ({{\--level}}) {{depth}} \- задаёт глубину размещения задач при обработке группы задач (задачи должны быть одного типа); * {{\-w}} ({{\--workdir}}) {{WorkDir}} \- задаёт директорию вывода (по умолчанию это папка задачи), существование директории необязательно. Параметры могут быть использованы как в короткой, так и в длинной форме, причём в короткой форме их можно писать слитно (если параметр с аргументом стоит не в конце такого слова, то остаток слова считается значением этого аргумента). При наличии свободных аргументов (без опций) они обрабатываются после всех опций по порядку следования, следующим образом: - если значение TaskDir не установлено, считается, что аргумент задаёт его - иначе, если значение WorkDir не установлено, считается, что аргумент задаёт его - иначе аргумент лишний и программа откажется работать. Таким образом, можно просто запустить программу как {code} TaskConv path/to/taskdir path/to/workdir {code} *{_}Поведение._* {{TaskConv}} работает следующим образом: * обрабатывается список параметров (если параметр задан больше одного раза, происходит аварийное завершение программы); * считывается конфигурация из файла {{.cfg}} и директории {{DB}}, которые должны находиться в рабочей папке ({{.cfg}} опционален); * программа пытается определить тип задачи (задач) по количеству подходящих к шаблону входных и выходных файлов (их число и значения переменных должны совпадать с ними же у выходных, если не задана опция {{\-i}}; при использовании {{\-l}} тип не определится, если хотя бы одна папка на указанном уровне не содержит правильной задачи данного типа -- кроме того, задачи без выходных файлов нужно обрабатывать отдельно); * если подошло больше одного типа программа предлагает выбор пользователю (для каждой задачи указано количество найденных тестов, варианты предлагаются в нисходящем порядке), если не задана опция {{\-a}} (в этом случае автоматически выбирается вариант *[1]* -- с наибольшим количеством); * в случае успешного определения типа формата задачи входные и выходные файлы копируются (перемещаются) в соответствующие директории вывода (они создаются если не существуют), попутно составляется список тестов по группам (для каждой задачи); * после перемещения (т.е. если указан {{\-m}}, но не указан {{\-k}}) папка задачи рекурсивно очищается от пустых директорий; * список тестов выводится (для каждой задачи) в выходной файл программы (см. {{\-o}}) в формате, подходящем для занесения в task.cfg (стоимость каждого теста считается за 1 балл). h2. Настройка *{_}Конфигурация._* Типы формата задачи описаны в файлах, помещённых в папку {{DB}}. В первой строке описан шаблон пути входного файла, во второй -- соответствующего выходного. Шаблон представляет собой путь к файлу из папки задачи, в котором части пути, различающиеся для разных тестов, обозначены метками\-_переменными_. Каждая переменная заключается в фигурные скобки, предваряемые знаком <{{$}}> ({{$\{переменная\}}}). Исключением могут быть переменные, обозначающие номер теста в группе (если в группе из одного теста этот номер не указывается, переменная заключается в квадратные скобки - {{$\[переменная\]}}). Распознаются следующие переменные: * {{TaskName}} \- имя задачи (одинаково для всех тестов в группе); * {{S}} \- номер группы тестов (обязательно должен присутствовать в пути или номере теста); * {{SS}} \- номер теста в группе; * {{SL}} \- буква теста в группе (нумерация латиницей). На случай неправильного определения {{TaskName}} предусмотрена возможность жёсткого фиксирования его значения (см. {{\-n}}); также, программа считает, что в {{TaskName}} могут входить только символы, указанные в первой строке файла {{.cfg}} (именно для этого он и предназначен) - по умолчанию это все буквы латиницы. Проверка шаблона выполняется регистронечувствительно. Разделитель файлов всегда '/'. h2. Дополнительно *{_}Примеры._* Пример файла шаблона для задачи с олимпиады IOI: {code:title=DB/IOI} ${TaskName}-test/subtask${S}/grader.in.${SS} ${TaskName}-test/subtask${S}/grader.expect.${SS} {code} То есть, если задача называется race, то её тесты размещены в подпапке {{race-test}}; если у задачи 4 группы тестов, то внутри {{race-test}} лежат папки {{subtask1}}, {{subtask2}}, {{subtask3}} и {{subtask4}}; если в первой группе 3 теста, то в папке {{race-test/subtask1}} лежат файлы {{grader.in.1}}, {{grader.in.2}}, {{grader.in.3}}, {{grader.expect.1}}, {{grader.expect.2}} и {{grader.expect.3}}; эти файлы будут скопированы (перемещены) в корень папки задачи с именами {{1.in}}, {{2.in}}, {{3.in}}, {{1.out}}, {{2.out}} и {{3.out}} соответственно, а в строки с 1 по 3 выходного файла программа выведет числа {{\-1}}, {{\-1}} и {{1}} соответственно. Пример файла шаблона для задачи с олимпиады CEOI: {code:title=DB/CEOI} ${TaskName}${S}$[SL].in ${TaskName}${S}$[SL].out {code} То есть, если задача называется {{bal}}, имеет 5 групп тестов с номерами 0-4, в группах с номерами 0-2 один тест, а в остальных по два, то файлы тестов будут находиться в корне папки задачи и иметь названия {{bal0.in}}, {{bal0.out}}, {{bal1.in}}, {{bal1.out}}, {{bal2.in}}, {{bal2.out}}, {{bal3a.in}}, {{bal3a.out}}, {{bal3b.in}}, {{bal3b.out}}, {{bal4a.in}}, {{bal4a.out}}, {{bal4b.in}} и {{bal4b.out}}; эти файлы будут переименованы в {{1.in}}, {{1.out}}, {{2.in}}, {{2.out}}, {{3.in}}, {{3.out}}, {{4.in}}, {{4.out}}, {{5.in}}, {{5.out}}, {{6.in}}, {{6.out}}, {{7.in}} и {{7.out}} соответственно, а в выходной файл программа выведет числа {{1}}, {{1}}, {{1}}, {{\-1}}, {{1}}, {{\-1}} и {{1}} соответственно. Примеры запуска программы: {code} TaskConv -mql2 ../load/Baltic12 ../tasks/Baltic2012 {code} Обрабатывает папку с олимпиадой, задачи которой размещены подобным образом: {{"../load/Baltic12/Day 1/sometask"}}; задачи обрабатываются и их тесты размещаются следующим образом: {{"../tasks/Baltic2012/Day 1/sometask"}}, после чего папка с задачами рекурсивно очищается от пустых папок. Вывод отсутствует, неопределённости разрешаются автоматически. {code} TaskConv -v ../../Temp/Olymp {code} Просто обрабатывает задачу в папке {{"../../Temp/Olimp"}} и копирует входные и выходные файлы в корень этой папки с соответствующими именами. Действия программы комментируются сообщениями в стандартный вывод (консоль). *{_}Исходный код{_}* программы содержится в архиве, в папке {{src}}. |