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}}.