SubWCRev - это консольная программа Windows, которая может быть использована для чтения статуса рабочей копии Subversion и, при необходимости, для выполнения подстановки ключевых слов в шаблонных файлах. Это часто используется как часть процесса сборки, в качестве средства для внедрения информации из рабочей копии в собираемый объект. В основном это применяется для включения номера ревизии в диалог «О программе».
По умолчанию, SubWCRev считывает статус Subversion для всех файлов в рабочей копии, за исключением внешних включений. Она запоминает наибольший найденный номер зафиксированной ревизии, дату и время фиксации, а также регистрирует, были ли локальные изменения в рабочей копии, или смешанные обновления ревизий. Номер ревизии, диапазон обновлений ревизий и статус изменений отображается в стандартный вывод (stdout).
SubWCRev.exe вызывается из командной строки или скрипта, и управляется при помощи параметров командной строки.
SubWCRev ПутьКРабочейКопии [Файл_Исходной_Версии Файл_Целевой_Версии] [-nmdfe]
ПутьКРабочейКопии - это путь к проверяемой рабочей копии. Вы можете вызывать SubWCRev только для рабочих копий, но не можете непосредственно для хранилища . Путь может быть как абсолютным, так и относительным к текущей рабочей папке.
Если вы желаете, чтобы SubWCRev выполняла подстановку ключевых слов, чтобы поля вроде ревизии из хранилища и адреса URL сохранялись в текстовый файл, вы должны предоставить шаблонный Файл_Исходной_Версии и выходной Файл_Целевой_Версии, который будет содержать версию шаблона с произведёнными подстановками.
Есть несколько необязательных параметров, которые влияют на работу SubWCRev. При использовании более одного параметра, они должны указываться в виде единой группы, например -nm, а не -n -m.
Таблица 5.1. Список доступных параметров командной строки
| Параметр | Описание |
|---|---|
| -n | Если указан данный параметр, SubWCRev будет завершаться с ERRORLEVEL 7, если рабочая копия содержит локальные изменения. Это может быть использовано для предотвращения сборки в случае наличия незафиксированных изменений. |
| -m | Если указан этот параметр, SubWCRev будет завершаться с ERRORLEVEL 8, если рабочая копия содержит смешанные ревизии. Это может использоваться для предотвращения сборки в случае частично обновленной рабочей копии. |
| -d | Если указан этот параметр, SubWCRev будет завершаться с ERRORLEVEL 9, если целевой файл уже существует. |
| -f | Если указан этот параметр, SubWCRev будет включать ревизию последнего изменения папки. Поведение по умолчанию - использовать при получении номеров ревизий только файлы. |
| -e | Если указан этот параметр, SubWCRev будет проверять папки, включённые при помощи svn:externals, но только если они из того же хранилища. Поведение по умолчанию - игнорировать внешние включения. |
| -x | Если указан этот параметр, SubWCRev будет выводить номера ревизий в шестнадцатеричном виде. |
| -X | Если указан этот параметр, SubWCRev будет выводить номера ревизий в шестнадцатеричном виде, с префиксом '0X'. |